openeuropa/task-runner-drupal-project-symlink

OpenEuropa TaskRunner 命令,用于在本地通过 Composer 构建的开发站内创建 Drupal 项目的代码库的符号链接。

1.0.0-beta6 2023-01-03 14:48 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。