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): bool

Используется для вызова пользовательских ошибок. Можно использовать в связке со встроенным обработчиком ошибок, а также с пользовательским обработчиком, заданным функцией set_error_handler().

Эта функция может быть полезной, если требуется сгенерировать определённую реакцию на исключение во время выполнения.

Список параметров

message

Сообщение, соответствующее этой ошибке. Ограничено 1024 байтами в длину. Символы дальше 1024-го будут обрезаны.

error_level

Назначенный тип ошибки. Работает только с семейством констант E_USER. По умолчанию E_USER_NOTICE.

Возвращаемые значения

Функция возвращает false, если задан неправильный error_level, и true в остальных случаях.

Примеры

Пример #1 Пример использования trigger_error()

Более подробный пример приведён в описании функции set_error_handler().

<?php
if ($divisor == 0) {
trigger_error("Не могу поделить на ноль", E_USER_ERROR);
}
?>

Примечания

Внимание

HTML-сущности в message не экранированы. Чтобы сообщение можно было отобразить в браузере, преобразуйте его функцией htmlentities().

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