openeuropa / task-runner-drupal-project-symlink
OpenEuropa TaskRunner 命令,用于在本地通过 Composer 构建的开发站内创建 Drupal 项目的代码库的符号链接。
1.0.0-beta6
2023-01-03 14:48 UTC
Requires
- php: >=8.0
- openeuropa/task-runner: 2.x-dev
Requires (Dev)
- openeuropa/code-review: ^2.0.0-alpha6
- phpunit/phpunit: ^9.4
This package is auto-updated.
Last update: 2024-09-06 20:51:22 UTC
README
Drupal 项目的符号链接 Task Runner 命令旨在简化使用基于 Composer 的工作流程的 Drupal 开发。
假设运行 composer install
后,Drupal 站点在当前 Drupal 项目目录中构建,此命令将在此 Drupal 站点内部创建项目文件的符号链接,同时遵守 Drupal 编码规范。它还将避免将当前 Drupal 站点根目录和 vendor
目录等链接为符号链接,以避免代码递归。
安装
将命令作为开发依赖项要求
composer require --dev openeuropa/task-runner-drupal-project-symlink
确保命令在 composer install
之后运行
"scripts": {
"post-install-cmd": "./vendor/bin/run drupal:symlink-project",
},
用法
确保在添加/删除项目根目录中的文件或目录后始终运行以下命令
./vendor/bin/run drupal:symlink-project
您还可以使用以下配置来防止文件和/或目录被符号链接,该配置在下面的示例中显示
drupal_project_symlink:
ignore:
- directory-to-ignore
- file-to-ignore.txt
步骤调试
要启用从命令行的步骤调试,请将 XDEBUG_SESSION
环境变量与任何值传递给 Docker 容器
docker-compose exec -e XDEBUG_SESSION=1 web <your command>
请注意,从 XDebug 3 开始,如果变量已设置但您的客户端未监听调试连接,则将在控制台输出连接错误消息。错误消息会导致 PHPUnit 测试出现假阴性。
要从浏览器启动步骤调试,请使用浏览器扩展或像在 https://www.jetbrains.com/phpstorm/marklets/ 生成的书签工具设置正确的 Cookie。