(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
trigger_error — Генерирует предупреждение, уведомление или сообщение об ошибке на уровне пользователя
Функция инициирует состояние пользовательской ошибки. Функцию разрешается использовать в сочетании со встроенным обработчиком ошибок или функцией, которую разработчик определил и установил через функцию set_error_handler() как новый обработчик ошибок.
Польза функции проявляется при выполнении кода, когда требуется сгенерировать конкретный ответ на исключение.
messageСообщение, которое функция назначит ошибке. Длина сообщения ограничивается 1024 байтами. Функция обрежет символы, которые идут после 1024-го.
error_level
Тип, который функция назначит ошибке. Параметр работает только
с константами семейства E_USER_*,
а значение по умолчанию равно E_USER_NOTICE.
Передача константы E_USER_ERROR как значения уровня ошибки
в параметр error_level устарела.
Вместо этого рекомендуют выбрасывать исключение Exception
или вызывать функцию exit().
Функция возвращает логическое значение true.
Функция выбрасывает исключение ValueError,
если значение параметра error_level не соответствует значениям
E_USER_ERROR, E_USER_WARNING,
E_USER_NOTICE или E_USER_DEPRECATED.
| Версия | Описание |
|---|---|
| 8.4.0 |
Передача константы E_USER_ERROR как значения уровня ошибки
в параметр error_level устарела.
Вместо этого рекомендуют выбрасывать исключение Exception
или вызывать функцию exit().
|
| 8.4.0 | Вместо типа bool функции теперь возвращает тип true. |
| 8.0.0 |
Функция выбрасывает ошибку ValueError,
если в аргументе error_level передали недопустимое значение.
Раньше функция возвращала значение false.
|
Пример #1 Пример запуска состояния пользовательской ошибки функцией trigger_error()
Развёрнутый пример приводит описание функции set_error_handler().
<?php
if ($divisor == 0) {
trigger_error("Не могу поделить на ноль", E_USER_ERROR);
}
?>
HTML-сущности в параметре message не экранируются.
Сообщение преобразовывают функцией htmlentities(),
если ошибку требуется отобразить в браузере.