README

OpenEuropa 企业网站信息模块提供了关于站点的企业信息，例如网站所有者、内容所有者等。

该模块使用 RDF SKOS 模块为 Publications Office 分类法词汇提供 SKOS 模型。这些直接在依赖的 RDF 三元组存储中提供。

要求

这依赖于以下软件

PHP >=8.1
Virtuoso（或等效）三元组存储，其中包含以下 Publications Office（OP）词汇的 RDF 表示：法人实体、目标受众、组织类型、资源类型、Eurovoc

安装

安装包及其依赖项

composer require openeuropa/oe_corporate_site_info

强烈建议使用包含已安装 OP 词汇的 Virtuoso 的 Docker 镜像。为此，将镜像添加到您的 docker-compose.yml 文件中

  sparql:
    image: openeuropa/triple-store-dev
    environment:
    - SPARQL_UPDATE=true
    - DBA_PASSWORD=dba
    ports:
      - "8890:8890"

否则，请确保您已启动三元组存储实例，并已导入“法人实体”词汇。

接下来，如果您正在使用任务运行器来设置您的网站，请添加用于连接到三元组的 runner.yml 配置。在 drupal 键下

  sparql:
    host: "sparql"
    port: "8890"

在 runner.yml 中，添加创建连接到三元组的 Drupal 设置的指令。在 drupal.settings.databases 键下

  sparql_default:
    default:
      prefix: ""
      host: ${drupal.sparql.host}
      port: ${drupal.sparql.port}
      namespace: 'Drupal\Driver\Database\sparql'
      driver: 'sparql'

然后您可以继续使用常规的任务运行器命令来设置网站。

否则，请确保在您的网站 setting.php 文件中您有连接到您自己的三元组存储实例的信息

$databases["sparql_default"] = array(
  'default' => array(
    'prefix' => '',
    'host' => 'your-triple-store-host',
    'port' => '8890',
    'namespace' => 'Drupal\\Driver\\Database\\sparql',
    'driver' => 'sparql'
  )
);

开发设置

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

安装 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 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/生成的书签来设置正确的cookie。

贡献

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

版本控制

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

openeuropa / oe_corporate_site_info

维护者

详细信息