Как использовать параметры сервис-контейнера в ваших маршрутах

Иногда вам может показаться полезной возможность сделать некоторые части ваших маршрутов глобально настраиваемыми. Например, если вы посмтроите интернационализированный сайт, вы скорее всего начнёте с одной или двух локалей. Естественно, вы добавите требование к вашим маршрутам, чтобы избежать соответствия пользователя с любой локалью кроме тех, что вы поддерживаете.

Вы могли бы жестко закодировать ваше требование _locale во всех ваших маршрутах, но лучшим решением будет использовать настраиваемый параметр сервис-контейнера прямо внутри вашей конфигурации маршрутизации:

YAML
XML
PHP

        1
2
3
4
5
6
        # config/routes.yaml
contact:
    path:       /{_locale}/contact
    controller: App\Controller\MainController::contact
    requirements:
        _locale: '%app.locales%'
    

        1
2
3
4
5
6
7
8
9
10
11
12
        <!-- config/routes.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<routes xmlns="http://symfony.com/schema/routing"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/routing
        http://symfony.com/schema/routing/routing-1.0.xsd">

    <route id="contact" path="/{_locale}/contact">
        <default key="_controller">App\Controller\MainController::contact</default>
        <requirement key="_locale">%app.locales%</requirement>
    </route>
</routes>
    

        1
2
3
4
5
6
7
8
9
10
11
12
        // config/routes.php
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;

$collection = new RouteCollection();
$collection->add('contact', new Route('/{_locale}/contact', array(
    '_controller' => 'App\Controller\MainController::contact',
), array(
    '_locale' => '%app.locales%',
)));

return $collection;
    

Теперь вы можете контролировать и устанавливать параметр app.localesгде-то в вашем контейнере:

YAML
XML
PHP

        1
2
3
        # config/services.yaml
parameters:
    app.locales: en|es
    

        1
2
3
4
5
6
7
8
9
10
11
        <!-- config/services.xml -->
<?xml version="1.0" charset="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        http://symfony.com/schema/dic/services/services-1.0.xsd">

    <parameters>
        <parameter key="app.locales">en|es</parameter>
    </parameters>
</container>
    

        1
2
        // config/services.php
$container->setParameter('app.locales', 'en|es');
    

Вы также можете использовать параметр, чтобы определять путь вашего маршрута (или часть вашего пути):

YAML
XML
PHP

        1
2
3
4
        # config/routes.yaml
some_route:
    path:       /%app.route_prefix%/contact
    controller: App\Controller\MainController::contact
    

        1
2
3
4
5
6
7
8
9
10
11
        <!-- config/routes.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<routes xmlns="http://symfony.com/schema/routing"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/routing
        http://symfony.com/schema/routing/routing-1.0.xsd">

    <route id="some_route" path="/%app.route_prefix%/contact">
        <default key="_controller">App\Controller\MainController::contact</default>
    </route>
</routes>
    

        1
2
3
4
5
6
7
8
9
10
        // config/routes.php
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;

$collection = new RouteCollection();
$collection->add('some_route', new Route('/%app.route_prefix%/contact', array(
    '_controller' => 'App\Controller\MainController::contact',
)));

return $collection;
    

Note

Так же, как в обычных файлах конфигурации сервис-контейнера, если вам действительно нужен знак % в вашем маршруте, вы можете избежать знак процентов путём его удвоения, например, /score-50%%, что будет сводиться к /score-50%.

Однако, так как знаки %, включённые в любой URL автоматически шифруются, итоговым URL этого примера будет /score-50%25 (%25 - это результат шифрования знака %).