openeuropa/ecl-twig-loader

欧洲组件库 Twig 加载器。

4.0.0 2023-02-20 09:45 UTC

README

Build Status Packagist

Twig 加载器,用于 欧洲组件库版本 3,允许通过配置的命名空间访问组件来加载组件。

例如,假设你有以下 ECL 组件

/path/to/components/
├── twig-component-link
│   └── ecl-link.html.twig
└── twig-component-language-list
    ├── ecl-language-list.html.twig
    ├── ecl-language-list-grid.html.twig
    └── ecl-language-list-item.html.twig

如果你这样设置加载器

<?php

use \OpenEuropa\Twig\Loader\EuropaComponentLibraryLoader;

$loader = new EuropaComponentLibraryLoader(['ecl'], '/components', '/path/to');
$twig = new Twig_Environment($loader);

那么你可以以下方式加载链接组件

{% include '@ecl/link/link.html.twig' with {
  link: {
    type: 'standalone',
    label: 'Standalone link'
  }
} %}

你还可以使用更短的形式,基于隐式命名约定

{% include '@ecl/link' with {
  link: {
    type: 'standalone',
    label: 'Standalone link'
  }
} %}

要加载子组件,请将其追加到组件名称之后

{% include '@ecl/language-list/language-list-item' %}

使用 Docker Compose 安装

可以使用 Docker Compose 简化设置过程。

要求

将 docker-compose.yml.dist 复制到 docker-compose.yml。

您可以根据需要对本地 Docker 设置进行任何更改。但是,默认设置应该足以设置项目。

运行

$ docker-compose up -d

然后

$ docker-compose exec web composer install

步骤调试

要从命令行启用步骤调试,请向容器传递具有任何值的 XDEBUG_SESSION 环境变量

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

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

要从浏览器启动步骤调试,请使用浏览器扩展或类似 https://www.jetbrains.com/phpstorm/marklets/ 生成的小工具设置正确的 cookie。