Расширение маршрутизации
класс RoutingExtension расширяет AbstractExtension
Обеспечивает интеграцию компонента маршрутизации с Twig.
Методы
| __construct(UrlGeneratorInterface $generator) | ||
| массив | getFunctions() Возвращает список функций для добавления в существующий список. | |
| строка | getPath(строка $name, массив $parameters = массив(), булево $relative = ложь) | |
| строка | getUrl(строка $name, массив $parameters = массив(), булево $schemeRelative = ложь) | |
| массив | isUrlGenerationSafe(Twig_Node $argsNode) Определяет во время компиляции, будет ли сгенерированный URL безопасным, и тем самым сохраняет ненужное автоматическое экранирование для повышения производительности. | |
| getName() {@inheritdoc} |
Подробности
__construct(UrlGeneratorInterface $generator)
Параметры
| UrlGeneratorInterface | $generator |
массив getFunctions()
Возвращает список функций для добавления в существующий список.
Значение возврата
| массив | Массив функций |
строка getPath(строка $name, массив $parameters = массив(), булево $relative = ложь)
Параметры
| строка | $name | |
| массив | $parameters | |
| булево | $relative |
Значение возврата
| строка |
строка getUrl(строка $name, массив $parameters = массив(), булево $schemeRelative = ложь)
Параметры
| строка | $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 безопасен Будет отмечен как @final в версии 3.4, а тип-подсказка будет изменена на "\Twig\Node\Node" в версии 4.0. |
getName()
{@inheritdoc}
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Bridge/Twig/Extension/RoutingExtension.html