Расширение маршрутизации
класс RoutingExtension расширяет Twig_Extension
Обеспечивает интеграцию компонента маршрутизации с Twig.
Методы
| __construct(UrlGeneratorInterface $generator) | ||
| массив | getFunctions() Возвращает список функций для добавления в существующий список. | |
| getPath($name, $parameters = array(), $relative = false) | ||
| getUrl($name, $parameters = array(), $schemeRelative = false) | ||
| массив | isUrlGenerationSafe(Twig_Node $argsNode) Определяет во время компиляции, будет ли сгенерированный URL безопасным, что позволит избежать ненужного автоматического экранирования для повышения производительности. | |
| getName() {@inheritdoc} |
Подробности
__construct(UrlGeneratorInterface $generator)
Параметры
| UrlGeneratorInterface | $generator |
массив getFunctions()
Возвращает список функций для добавления в существующий список.
Значение, возвращаемое функцией
| массив | Массив функций |
getPath($name, $parameters = array(), $relative = false)
Параметры
| $name | ||
| $parameters | ||
| $relative |
getUrl($name, $parameters = array(), $schemeRelative = false)
Параметры
| $name | ||
| $parameters | ||
| $schemeRelative |
массив isUrlGenerationSafe(Twig_Node $argsNode)
Определяет во время компиляции, будет ли сгенерированный URL безопасным, что позволит избежать ненужного автоматического экранирования для повышения производительности.
Процесс генерации URL кодирует процентами символы, не являющиеся буквенно-цифровыми. Таким образом, нет риска, что вредоносные/недопустимые символы будут частью URL. Единственный символ в URL, который необходимо экранировать в HTML, это амперсанд («&»), разделяющий параметры запроса. Поэтому мы не можем обозначить генерацию URL как всегда безопасную, а только когда уверены, что не будет нескольких параметров запроса. Это имеет место, когда их нет или только один постоянный параметр. Например, мы знаем, что это безопасно: - path('route') - path('route', {'param': 'value'}) Но следующее может быть небезопасно: - path('route', var) - path('route', {'param': ['val1', 'val2'] }) // подмассив - path('route', {'param1': 'value1', 'param2': 'value2'}) Если param1 и param2 ссылаются на заполнители в маршруте, он все равно будет безопасным. Но мы этого не знаем.
Параметры
| Twig_Node | $argsNode | Аргументы функции path/url |
Значение, возвращаемое функцией
| массив | Массив контекстов, в которых URL безопасен |
getName()
{@inheritdoc}
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.0/Symfony/Bridge/Twig/Extension/RoutingExtension.html