Маршрут

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

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

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

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

Параметры

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

serialize()

{@inheritdoc}

unserialize($serialized)

{@inheritdoc}

Параметры

$serialized

string getPath()

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

Значение результата

string

Шаблон пути

$this setPath(string $pattern)

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

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

Параметры

string

$pattern

Шаблон пути

Значение результата

$this

string getHost()

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

Значение результата

string

Шаблон хоста

$this setHost(string $pattern)

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

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

Параметры

string

$pattern

Шаблон хоста

Значение результата

$this

string[] getSchemes()

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

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

Значение результата

string[]

Схемы

$this setSchemes(string|string[] $schemes)

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

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

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

Параметры

string|string[]

$schemes

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

Значение результата

$this

bool hasScheme(string $scheme)

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

Параметры

string

$scheme

Значение результата

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

string[] getMethods()

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

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

Значение результата

string[]

Методы

$this setMethods(string|string[] $methods)

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

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

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

Параметры

string|string[]

$methods

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

Значение результата

$this

array getOptions()

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

Значение результата

array

Опции

$this setOptions(array $options)

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

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

Параметры

array

$options

Опции

Значение результата

$this

$this addOptions(array $options)

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

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

Параметры

array

$options

Опции

Значение результата

$this

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

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

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

Параметры

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)

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

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

Параметры

array

$defaults

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

Значение результата

$this

$this addDefaults(array $defaults)

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

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

Параметры

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)

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

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

Параметры

array

$requirements

Требования

Значение результата

$this

$this addRequirements(array $requirements)

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

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

Параметры

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

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