(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
trigger_error — Вызывает пользовательскую ошибку/предупреждение/уведомление
$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().