Маршрут

__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 по умолчанию)

Параметры

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)

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

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

Параметры

string

$pattern

Шаблон пути

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

$this

string getHost()

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

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

string

Шаблон хоста

$this setHost(string $pattern)

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

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

Параметры

string

$pattern

Шаблон хоста

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

$this

array getSchemes()

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

Таким образом, пустой массив означает, что любая схема разрешена.

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

array

Схемы

$this setSchemes(string|array $schemes)

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

Таким образом, пустой массив означает, что любая схема разрешена.

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

Параметры

string|array

$schemes

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

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

$this

bool hasScheme(string $scheme)

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

Параметры

string

$scheme

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

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

array getMethods()

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

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

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

array

Методы

$this setMethods(string|array $methods)

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

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

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

Параметры

string|array

$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

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