Symfony League CommonMarkdown 自定义ExternalLinksExtension

Question

在 Symfony 4/5/6.1 上的 services.yml 中自定义ExternalLinksExtension的正确方法是怎样的？

根据官方文档 ExternalLinksExtension 假设配置参数必须被传递到环境。但是，环境不是服务，也不会实例化为服务，即使它是这样声明的。它直接从初始化 CommonMarkdown 包的函数实例化，其中将空参数传递给它。

通过制作自定义扩展，也无法修改当前环境的配置。从 ExtensionInterface 继承不会为您提供此类访问权限。

我当前的方法是复制本机扩展 ExternalLinksExtension 的所有内容，并在 configureSchema 方法中将当前环境的配置与自定义参数合并。

class ExternalLinksExtension implements ConfigurableExtensionInterface
{

    public function configureSchema(ConfigurationBuilderInterface $builder): void
    {
        $applyOptions = [
            ExternalLinkProcessor::APPLY_NONE,
            ExternalLinkProcessor::APPLY_ALL,
            ExternalLinkProcessor::APPLY_INTERNAL,
            ExternalLinkProcessor::APPLY_EXTERNAL,
        ];

        $builder->addSchema('external_link', Expect::structure([
            'internal_hosts' => Expect::type('string|string[]'),
            'open_in_new_window' => Expect::bool(false),
            'html_class' => Expect::string()->default(''),
            'nofollow' => Expect::anyOf(...$applyOptions)->default(ExternalLinkProcessor::APPLY_NONE),
            'noopener' => Expect::anyOf(...$applyOptions)->default(ExternalLinkProcessor::APPLY_EXTERNAL),
            'noreferrer' => Expect::anyOf(...$applyOptions)->default(ExternalLinkProcessor::APPLY_EXTERNAL),
        ]));

        //this is where I pass custom arfuments
        $builder->merge([
            'external_link' => [
                'internal_hosts' => ["localhost"],
                'open_in_new_window' => true,
                'html_class' => 'external-link',
                'nofollow' => '',
                'noopener' => 'external',
                'noreferrer' => 'external',
            ]
        ]);
    }

    public function register(EnvironmentBuilderInterface $environment): void
    {
        $environment->addEventListener(DocumentParsedEvent::class, new ExternalLinkProcessor($environment->getConfiguration()), -50);
    }
}

这种方式对我有用，但我认为必须复制您想要自定义的所有扩展或者必须进行此类黑客攻击并不方便，应该有另一种更直接的配置方法。

在我的 service.yml 文件中

services:
    # default configuration for services in *this* file
    _defaults:
        autowire: true      # Automatically injects dependencies in your services.
        autoconfigure: true # Automatically registers your services as commands, event subscribers, etc.


    # makes classes in src/ available to be used as services
    # this creates a service per class whose id is the fully-qualified class name
    App\:
        resource: '../src/'
        exclude:
            - '../src/DependencyInjection/'
            - '../src/Entity/'
            - '../src/Kernel.php'
            - '../src/Tests/'

    # controllers are imported separately to make sure services can be injected
    # as action arguments even if you don't extend any base controller class
    App\Controller\:
        resource: '../src/Controller/'
        tags: ['controller.service_arguments']

     
    League\CommonMark\Environment\Environment:
        public: true
        arguments:
            -
                external_link:
                    -
                        internal_hosts: [ "localhost" ]
                        open_in_new_window: true
                        html_class: "external-link"
                        nofollow: ""
                        noopener: "external"
                        noreferrer: "external"


    League\CommonMark\Extension\Table\TableExtension:
        tags:
            - { name: twig.markdown.league_extension }

    League\CommonMark\Extension\Autolink\AutolinkExtension:
        tags:
            - { name: twig.markdown.league_extension }

    League\CommonMark\Extension\Strikethrough\StrikethroughExtension:
        tags:
            - { name: twig.markdown.league_extension }

    App\Service\League\CommonMark\ExternalLinksExtension:
        arguments: ... ##arguments here also doesnt work with the native extension
        tags:
            - { name: twig.markdown.league_extension }

twig docs 提到扩展必须使用标签 twig.markdown.league_extension

Answer 1

根据 此讨论 和 PR其次，从 Twig 3.3.5 开始，Twig/Extra-Bundle 包含一个工厂，该工厂仅依赖于在 services.yaml 中声明所需的扩展，并使用特定标签 twig.markdown.league_extension ：

# services.yaml
services:
    League\CommonMark\Extension\Table\ExternalLinksExtension:
        tags: [ 'twig.markdown.league_extension' ]

这对我有用，使用 TableExtension 和我的 twig/extra-bundle v3.3.8。

Answer 2

我也找不到在 symfony 中使用配置的方法。 lmeyer 提到了一种解决方法，其中创建了一个自定义工厂类 twig.markdown.league_common_mark_converter_factory，您可以在其中自定义配置（还包括扩展的设置）：https://github.com/twigphp/Twig/issues/3725#issuecomment-1367948462