README

OpenEuropa 翻译提供了OpenEuropa内容以及可翻译项的翻译功能。

您可以在此处阅读用户指南。

开发环境搭建

您可以通过以下步骤构建开发站点：

• 安装Composer依赖

composer install

在执行composer install命令后，会自动触发一个后置命令钩子（drupal:site-setup）。这将自动在测试站点中创建模块的符号链接，并在测试配置文件（如behat.yml.dist）中执行令牌替换。

请注意：项目文件和目录是通过使用OpenEuropa Task Runner的Drupal项目符号链接命令在测试站点中创建符号链接的。

如果您在项目的根目录中添加了新的文件或目录，您需要重新运行drupal:site-setup以确保它们被正确地符号链接。

如果您不希望重新运行完整的站点设置，您可以简单地运行

$ ./vendor/bin/run drupal:symlink-project

• 通过以下命令安装测试站点：

$ ./vendor/bin/run drupal:site-install

开发站点的Web根目录应该在build目录中可用。

使用Docker Compose

或者，您可以使用提供的配置，通过Docker和Docker Compose构建开发站点。

Docker提供了必要的服务和技术，如Web服务器和数据库服务器，以便根据您的本地主机配置运行站点。

要求

• Docker
• Docker Compose

配置

默认情况下，Docker Compose读取两个文件，一个是docker-compose.yml，另一个是可选的docker-compose.override.yml文件。按照惯例，docker-compose.yml包含您的基配置，并且默认提供。重写文件，如其名称所示，可以包含对现有服务或完全新服务的配置重写。如果服务在两个文件中都有定义，Docker Compose会合并配置。

有关Docker Compose扩展机制的更多信息，请参阅官方Docker Compose文档。

使用方法

要开始，请运行

docker-compose up

建议不要以守护进程模式运行docker-compose，这样您可以在完成工作后快速将其关闭（按CTRL+C）。但是，如果您想以守护进程模式运行它，您必须添加-d标志

docker-compose up -d

然后

docker-compose exec web composer install
docker-compose exec web ./vendor/bin/run drupal:site-install

使用默认配置，开发站点的文件应位于build目录中，并且开发站点应可通过以下链接访问： http://127.0.0.1:8080/build。

运行测试

要运行grumphp检查

docker-compose exec web ./vendor/bin/grumphp run

要运行phpunit测试

docker-compose exec web ./vendor/bin/phpunit

要运行behat测试

docker-compose exec web ./vendor/bin/behat

步骤调试

要启用从命令行进行步骤调试，请将任何值传递给容器的XDEBUG_SESSION环境变量

docker-compose exec -e XDEBUG_SESSION=1 web <your command>

请注意，从XDebug 3开始，如果已设置变量但您的客户端没有监听调试连接，控制台将输出连接错误信息。该错误信息将导致PHPUnit测试出现假阴性结果。

要从浏览器中开始逐步调试，请使用浏览器扩展或书签工具设置正确的Cookie，例如在https://www.jetbrains.com/phpstorm/marklets/生成的工具。

贡献

请阅读完整文档以了解我们的行为准则以及向我们提交拉取请求的过程。

版本控制

我们使用SemVer进行版本控制。有关可用版本，请参阅本存储库的标签。