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