README

Symfony扩展库用于 Url highlight。
支持的Symfony版本： ^2.7, ^3, ^4, ^5。

安装

使用以下命令安装最新版本

$ composer require vstelmakh/url-highlight-symfony-bundle

设置

如果您的应用程序正在使用 Symfony Flex - 您已准备就绪，可以跳过下一步。

通过将其添加到项目中 config/bundles.php 文件中注册的扩展列表来启用扩展

// config/bundles.php

return [
    // ...
    VStelmakh\UrlHighlightSymfonyBundle\UrlHighlightBundle::class => ['all' => true],
];

使用

该扩展提供url高亮服务，可通过自动注入或直接从容器中获取

<?php

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use VStelmakh\UrlHighlight\UrlHighlight;

class ExampleController extends AbstractController
{
    public function autowire(UrlHighlight $urlHighlight)
    {
        // do your stuff
    }

    public function fromContainer()
    {
        /** @var UrlHighlight $urlHighlight */
        $urlHighlight = $this->container->get('vstelmakh.url_highlight');
    }
}

此外，在模板中还有 urls_to_html 过滤器可用

{{ 'Basic example http://example.com'|urls_to_html }}

{# output: Basic example <a href="http://example.com">http://example.com</a> #}

更多详细信息请参见 Twig url高亮 存储库中的使用说明。

配置

默认配置即可正常工作

url_highlight:
    validator: ~
    highlighter: ~
    encoder: ~

如果您需要更改配置，请将所需选项添加到您的 parameters.yaml 或创建单独的配置：config/packages/url_highlight.yaml。
有关配置选项的更多信息，请参阅 Url highlight 库。

定义验证器以不匹配无方案的URL的示例

• 定义验证器服务。使用与Url highlight库捆绑的验证器或创建自己的 VStelmakh\UrlHighlight\Validator\ValidatorInterface 实现。

# config/services.yaml
services:
    ...
    VStelmakh\UrlHighlight\Validator\Validator:
        arguments: [false]

• 在 url_highlight.yaml 配置中提供服务ID

# config/packages/url_highlight.yaml
url_highlight:
    validator: VStelmakh\UrlHighlight\Validator\Validator

鸣谢

Volodymyr Stelmakh
许可协议为MIT。有关更多信息，请参阅 LICENSE。