Spec-Zone.ru › Symfony 3.2

ConfigurableRequirementsInterface

интерфейс ConfigurableRequirementsInterface

ConfigurableRequirementsInterface должен быть реализован генераторами URL, которые могут быть настроены на генерацию исключения, если параметры не соответствуют требованиям. Также можно полностью отключить проверку требований для генерации URL.

Возможные настройки и варианты использования: - setStrictRequirements(true): Выбросить исключение для несоответствующих требований. Это в основном полезно в среде разработки. - setStrictRequirements(false): Не выбросить исключение, но вернуть null в качестве URL для несоответствующих требований и записать проблему в журнал. Полезно, когда вы не можете контролировать все параметры, потому что они поступают из библиотек сторонних разработчиков, но не хотите получать 404 в рабочей среде. В журнале должна быть запись о несоответствии для его анализа. - setStrictRequirements(null): Вернуть URL с заданными параметрами, вообще не проверяя требований. При генерации URL вы должны либо доверять своим параметрам, либо предварительно их валидировать, иначе это нарушит вашу ссылку. Таким образом, в рабочей среде вы должны знать, что параметры всегда соответствуют требованиям. Таким образом, этот параметр позволяет отключить проверку при генерации URL по соображениям производительности (экономия preg_match для каждого требования каждый раз при генерации URL).

Методы

setStrictRequirements(bool|null $enabled)

Включает или отключает исключение при некорректных параметрах.

bool|null isStrictRequirements()

Возвращает значение, указывающее, следует ли генерировать исключение при некорректных параметрах.

Подробное описание

setStrictRequirements(bool|null $enabled)

Включает или отключает исключение при некорректных параметрах.

Передача null полностью деактивирует проверку требований.

Параметры

bool|null $enabled

bool|null isStrictRequirements()

Возвращает значение, указывающее, следует ли генерировать исключение при некорректных параметрах.

Null означает, что проверка требований полностью деактивирована.

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

bool|null

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.2/Symfony/Component/Routing/Generator/ConfigurableRequirementsInterface.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API