README

OpenEuropa 链接列表处理手动和动态链接列表。

子模块

• OpenEuropa RSS 链接列表：提供从 RSS 源提取的动态链接列表的支持。更多信息

开发环境搭建

您可以按照以下步骤构建开发站点

• 安装 Composer 依赖

composer install

在执行 composer install 后，会自动触发一个后置命令钩子（drupal:site-setup）。它会确保在开发站点中正确设置必要的符号链接。它还会在开发配置文件（如 behat.yml.dist）中执行令牌替换。

请注意：项目文件和目录通过使用OpenEuropa 任务运行器的 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测试出现假阴性结果。

要从浏览器开始单步调试，请使用浏览器扩展或书签，例如在https://www.jetbrains.com/phpstorm/marklets/生成的那些。

贡献

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

版本管理

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