README

增强 OpenEuropa 内容模块的基本功能，添加额外字段和实体类型。

主要设计用于与 OpenEuropa Whitelabel 主题配合使用。

开发环境设置

使用 LAMP 栈或类似环境

这不受官方支持。请自行解决。

使用 Docker Compose

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

Docker 提供必要的服务和技术，如 web 服务器和数据库服务器，以确保网站运行，无论您的本地主机配置如何。

要求

配置

默认情况下，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

步骤调试

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

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

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

要从浏览器中启动步骤调试，请使用浏览器扩展或书签，例如在 https://www.jetbrains.com/phpstorm/marklets/ 生成的书签。

贡献

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

版本控制

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

openeuropa / oe_content_extra

维护者

详细信息