Сборник маршрутов
класс RouteCollection реализует IteratorAggregate, Countable
Сборник маршрутов представляет собой набор экземпляров маршрута Route.
При добавлении маршрута в конец коллекции, существующий маршрут с таким же именем сначала удаляется. Поэтому может существовать только один маршрут с данным именем.
Методы
| __clone() | ||
| ArrayIterator|Маршрут[] | getIterator() Возвращает текущий Сборник маршрутов как итератор, включающий все маршруты. | |
| int | count() Возвращает количество маршрутов Route в этой коллекции. | |
| add(string $name, Маршрут $route) Добавляет маршрут. | ||
| Маршрут[] | all() Возвращает все маршруты в этой коллекции. | |
| Маршрут|null | get(string $name) Возвращает маршрут по имени. | |
| remove(string|string[] $name) Удаляет маршрут или массив маршрутов по имени из коллекции. | ||
| addCollection(СборникМаршрутов $collection) Добавляет набор маршрутов в конец текущего набора, добавляя все маршруты добавленной коллекции. | ||
| addPrefix(string $prefix, array $defaults = array(), array $requirements = array()) Добавляет префикс к пути всех дочерних маршрутов. | ||
| addNamePrefix(string $prefix) Добавляет префикс к имени всех маршрутов в коллекции. | ||
| setHost(string $pattern, array $defaults = array(), array $requirements = array()) Устанавливает шаблон хоста для всех маршрутов. | ||
| setCondition(string $condition) Устанавливает условие для всех маршрутов. | ||
| addDefaults(array $defaults) Добавляет значения по умолчанию для всех маршрутов. | ||
| addRequirements(array $requirements) Добавляет требования для всех маршрутов. | ||
| addOptions(array $options) Добавляет опции для всех маршрутов. | ||
| setSchemes(string|string[] $schemes) Устанавливает схемы (например, 'https'), к которым ограничены все дочерние маршруты. | ||
| setMethods(string|string[] $methods) Устанавливает HTTP-методы (например, 'POST'), к которым ограничены все дочерние маршруты. | ||
| ИнтерфейсРесурса[] | getResources() Возвращает массив загруженных ресурсов для построения этой коллекции. | |
| addResource(ИнтерфейсРесурса $resource) Добавляет ресурс для этой коллекции. Если ресурс уже существует, он не добавляется. |
Подробности
__clone()
ArrayIterator|Маршрут[] getIterator()
Получает текущую коллекцию маршрутов в виде итератора, включающего все маршруты.
Реализует \IteratorAggregate.
Значение возврата
| ArrayIterator|Маршрут[] | Объект \ArrayIterator для итерации по маршрутам |
См. также
| all() |
int count()
Получает количество маршрутов в этой коллекции.
Значение возврата
| int | Количество маршрутов |
add(string $name, Маршрут $route)
Добавляет маршрут.
Параметры
| string | $name | Имя маршрута |
| Маршрут | $route | Экземпляр Route |
Маршрут[] all()
Возвращает все маршруты в этой коллекции.
Значение возврата
| Маршрут[] | Массив маршрутов |
Маршрут|null get(string $name)
Получает маршрут по имени.
Параметры
| string | $name | Имя маршрута |
Значение возврата
| Маршрут|null | Экземпляр Route или null, если не найден |
remove(string|string[] $name)
Удаляет маршрут или массив маршрутов по имени из коллекции.
Параметры
| string|string[] | $name | Имя маршрута или массив имён маршрутов |
addCollection(RouteCollection $collection)
Добавляет коллекцию маршрутов в конец текущего набора, добавляя все маршруты добавленной коллекции.
Параметры
| RouteCollection | $collection |
addPrefix(string $prefix, array $defaults = array(), array $requirements = array())
Добавляет префикс к пути всех дочерних маршрутов.
Параметры
| string | $prefix | Необязательный префикс, добавляемый перед каждым шаблоном коллекции маршрутов |
| array | $defaults | Массив значений по умолчанию |
| array | $requirements | Массив требований |
addNamePrefix(string $prefix)
Добавляет префикс к имени всех маршрутов в коллекции.
Параметры
| string | $prefix |
setHost(string $pattern, array $defaults = array(), array $requirements = array())
Устанавливает шаблон хоста для всех маршрутов.
Параметры
| string | $pattern | Шаблон |
| array | $defaults | Массив значений по умолчанию |
| array | $requirements | Массив требований |
setCondition(string $condition)
Устанавливает условие для всех маршрутов.
Существующие условия будут перезаписаны.
Параметры
| string | $condition | Условие |
addDefaults(array $defaults)
Добавляет значения по умолчанию для всех маршрутов.
Существующее значение по умолчанию с тем же именем в маршруте будет перезаписано.
Параметры
| array | $defaults | Массив значений по умолчанию |
addRequirements(array $requirements)
Добавляет требования для всех маршрутов.
Существующее требование с тем же именем в маршруте будет перезаписано.
Параметры
| array | $requirements | Массив требований |
addOptions(array $options)
Добавляет параметры для всех маршрутов.
Существующее значение параметра с тем же именем в маршруте будет перезаписано.
Параметры
| array | $options | Массив параметров |
setSchemes(string|string[] $schemes)
Устанавливает схемы (например, 'https'), к которым ограничены все дочерние маршруты.
Параметры
| string|string[] | $schemes | Схема или массив схем |
setMethods(string|string[] $methods)
Устанавливает HTTP-методы (например, 'POST'), к которым ограничены все дочерние маршруты.
Параметры
| string|string[] | $methods | Метод или массив методов |
ResourceInterface[] getResources()
Возвращает массив ресурсов, загруженных для построения этой коллекции.
Значение возврата
| ResourceInterface[] | Массив ресурсов |
addResource(ResourceInterface $resource)
Добавляет ресурс для этой коллекции. Если ресурс уже существует, он не добавляется.
Параметры
| ResourceInterface | $resource |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Component/Routing/RouteCollection.html
