trigger_error
(PHP 4 >= 4.0.1, PHP 5, PHP 7)
trigger_error — Вызывает пользовательскую ошибку/предупреждение/уведомление
Описание
$error_msg
, int $error_type = E_USER_NOTICE
) : boolИспользуется для вызова пользовательских ошибок. Можно использовать в связке со встроенным обработчиком ошибок, а также с пользовательским обработчиком, заданным функцией set_error_handler().
Эта функция может быть полезной, если требуется сгенерировать определенную реакцию на исключение во время выполнения.
Список параметров
-
error_msg -
Сообщение, соответствующее этой ошибке. Ограничено 1024 байтами в длину. Символы дальше 1024-го будут обрезаны.
-
error_type -
Назначенный тип ошибки. Работает только с семейством констант E_USER. По умолчанию
E_USER_NOTICE.
Возвращаемые значения
Функция возвращает false, если задан неправильный
error_type, и true в остальных случаях.
Примеры
Пример #1 Пример использования trigger_error()
Более подробный пример приведен в описании функции set_error_handler().
<?php
if ($divisor == 0) {
trigger_error("Не могу поделить на ноль", E_USER_ERROR);
}
?>
Примечания
HTML-сущности в error_msg не экранированы.
Чтобы сообщение можно было отобразить в браузере, преобразуйте его
функцией htmlentities().
Смотрите также
- error_reporting() - Задает, какие ошибки PHP попадут в отчет
- set_error_handler() - Задает пользовательский обработчик ошибок
- restore_error_handler() - Восстанавливает предыдущий обработчик ошибок
- Константы уровней ошибок