Spec-Zone.ru › Symfony 3.1

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.1/Symfony/Component/Routing/Generator/ConfigurableRequirementsInterface.html

Spec-Zone.ru

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