trigger_error

(PHP 4 >= 4.0.1, PHP 5)

trigger_error — Вызывает пользовательскую ошибку/предупреждение/уведомление

Описание

bool trigger_error ( string $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() - Восстанавливает предыдущий обработчик ошибок
Константы уровней ошибок