Маршрут

__construct(string $path, array $defaults = array(), array $requirements = array(), array $options = array(), string $host = '', string|array $schemes = array(), string|array $methods = array(), string $condition = '')

Конструктор.

Доступные опции:

• compiler_class: Имя класса, способного скомпилировать этот экземпляр маршрута (RouteCompiler по умолчанию)
• utf8: Требуется ли соответствие UTF-8

Параметры

string	$path	Шаблон пути для соответствия
array	$defaults	Массив значений параметров по умолчанию
array	$requirements	Массив требований к параметрам (регулярные выражения)
array	$options	Массив опций
string	$host	Шаблон хоста для соответствия
string|array	$schemes	Требуемый URI-схема или массив ограниченных схем
string|array	$methods	Требуемый HTTP-метод или массив ограниченных методов
string	$condition	Условие, которое должно быть истинным для соответствия маршруту

serialize()

{@inheritdoc}

unserialize($serialized)

{@inheritdoc}

Параметры

$serialized

string getPath()

Возвращает шаблон пути.

Значение возврата

string

Шаблон пути

$this setPath(string $pattern)

Устанавливает шаблон пути.

Этот метод реализует интерфейс флюента.

Параметры

string

$pattern

Шаблон пути

Значение возврата

$this

string getHost()

Возвращает шаблон хоста.

Значение возврата

string

Шаблон хоста

$this setHost(string $pattern)

Устанавливает шаблон хоста.

Этот метод реализует интерфейс флюента.

Параметры

string

$pattern

Шаблон хоста

Значение возврата

$this

array getSchemes()

Возвращает схемы (в нижнем регистре), к которым ограничен этот маршрут.

Пустой массив означает, что разрешены любые схемы.

Значение возврата

array

Схемы

$this setSchemes(string|array $schemes)

Устанавливает схемы (например, 'https'), к которым ограничен этот маршрут.

Пустой массив означает, что разрешены любые схемы.

Этот метод реализует интерфейс флюента.

Параметры

string|array

$schemes

Схема или массив схем

Значение возврата

$this

bool hasScheme(string $scheme)

Проверяет, установлено ли требование к схеме.

Параметры

string

$scheme

Значение возврата

bool	true, если требование к схеме существует, иначе false

array getMethods()

Возвращает HTTP-методы (в верхнем регистре), к которым ограничен этот маршрут.

Пустой массив означает, что разрешены любые методы.

Значение возврата

array

Методы

$this setMethods(string|array $methods)

Устанавливает HTTP-методы (например, 'POST'), к которым ограничен этот маршрут.

Пустой массив означает, что разрешены любые методы.

Этот метод реализует интерфейс флюента.

Параметры

string|array

$methods

Метод или массив методов

Значение возврата

$this

array getOptions()

Возвращает опции.

Значение возврата

array

Опции

$this setOptions(array $options)

Устанавливает опции.

Этот метод реализует интерфейс флюента.

Параметры

array

$options

Опции

Значение возврата

$this

$this addOptions(array $options)

Добавляет опции.

Этот метод реализует интерфейс флюента.

Параметры

array

$options

Опции

Значение возврата

$this

$this setOption(string $name, mixed $value)

Устанавливает значение опции.

Этот метод реализует интерфейс флюента.

Параметры

string	$name	Имя опции
mixed	$value	Значение опции

Значение возврата

$this

mixed getOption(string $name)

Получить значение опции.

Параметры

string

$name

Имя опции

Значение возврата

mixed

Значение опции или null, если не задано

bool hasOption(string $name)

Проверяет, установлена ли опция.

Параметры

string

$name

Имя опции

Значение возврата

bool	true, если опция установлена, иначе false

array getDefaults()

Возвращает значения по умолчанию.

Значение возврата

array

Значения по умолчанию

$this setDefaults(array $defaults)

Устанавливает значения по умолчанию.

Этот метод реализует интерфейс флюента.

Параметры

array

$defaults

Значения по умолчанию

Значение возврата

$this

$this addDefaults(array $defaults)

Добавляет значения по умолчанию.

Этот метод реализует интерфейс флюента.

Параметры

array

$defaults

Значения по умолчанию

Значение возврата

$this

mixed getDefault(string $name)

Получает значение по умолчанию.

Параметры

string

$name

Имя переменной

Значение возврата

mixed

Значение по умолчанию или null, если не задано

bool hasDefault(string $name)

Проверяет, установлено ли значение по умолчанию для данной переменной.

Параметры

string

$name

Имя переменной

Значение возврата

bool	true, если значение по умолчанию установлено, иначе false

$this setDefault(string $name, mixed $default)

Устанавливает значение по умолчанию.

Параметры

string	$name	Имя переменной
mixed	$default	Значение по умолчанию

Значение возврата

$this

array getRequirements()

Возвращает требования.

Значение возврата

array

Требования

$this setRequirements(array $requirements)

Устанавливает требования.

Этот метод реализует интерфейс флюента.

Параметры

array

$requirements

Требования

Значение возврата

$this

$this addRequirements(array $requirements)

Добавляет требования.

Этот метод реализует интерфейс флюента.

Параметры

array

$requirements

Требования

Значение возврата

$this

string|null getRequirement(string $key)

Возвращает требование для заданного ключа.

Параметры

string

$key

Ключ

Значение возврата

string|null

Регулярное выражение или null, если не задано

bool hasRequirement(string $key)

Проверяет, установлено ли требование для данного ключа.

Параметры

string

$key

Имя переменной

Значение возврата

bool	true, если условие задано, в противном случае false

$this setRequirement(string $key, string $regex)

Устанавливает требование для данного ключа.

Параметры

string	$key	Ключ
string	$regex	Регулярное выражение

Значение возврата

$this

string getCondition()

Возвращает условие.

Значение возврата

string

Условие

$this setCondition(string $condition)

Устанавливает условие.

Этот метод реализует интерфейс fluent.

Параметры

string

$condition

Условие

Значение возврата

$this

CompiledRoute compile()

Компилирует маршрут.

Значение возврата

CompiledRoute

Экземпляр CompiledRoute

Исключения

LogicException

Если маршрут нельзя скомпилировать из-за некорректного шаблона пути или хоста

См. также

RouteCompiler

который отвечает за процесс компиляции