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