(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
.
Функция возвращает логическое значение true
.
Функция выбрасывает исключение ValueError,
если значение параметра error_level
не соответствует значениям
E_USER_ERROR
, E_USER_WARNING
,
E_USER_NOTICE
или E_USER_DEPRECATED
.
Версия | Описание |
---|---|
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(),
если ошибку требуется отобразить в браузере.