trigger_error - Вызывает пользовательскую ошибку/предупреждение/уведомление
Вернуться к: Функции обработки ошибок
trigger_error
(PHP 4 >= 4.0.1, PHP 5, PHP 7)
trigger_error — Вызывает пользовательскую ошибку/предупреждение/уведомление
Описание
$error_msg
[, int $error_type
= E_USER_NOTICE
] )Используется для вызова пользовательских ошибок, можно использовать в связке с встроенным обработчиком ошибок, а также с пользовательским обработчиком, заданным функцией 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() - Восстанавливает предыдущий обработчик ошибок
- Константы уровней ошибок
Вернуться к: Функции обработки ошибок