trigger_error

(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

trigger_error Генерирует предупреждение, уведомление или сообщение об ошибке

Описание

trigger_error(string $message, int $error_level = E_USER_NOTICE): true

Функция инициирует состояние пользовательской ошибки. Функцию разрешается использовать в сочетании со встроенным обработчиком ошибок или функцией, которую разработчик определил и установил через функцию 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(), если ошибку требуется отобразить в браузере.

Смотрите также