trigger_error
Создаёт пользовательское предупреждение или сообщение.
Синтаксис
trigger_error(string $message, int $error_level = E_USER_NOTICE): trueПараметры
| Параметр | Тип | Описание |
|---|---|---|
| $message | string | Текст сообщения. |
| $error_level | int | Необязательный. `E_USER_NOTICE`, `E_USER_WARNING`, `E_USER_DEPRECATED`. |
Возвращаемое значение
trueВсегда `true`.
Примеры
Сообщение об устаревшей функции:
<?php
set_error_handler(function (int $level, string $message) {
echo 'Caught: ', $message;
return true;
});
function oldPrice(): int
{
trigger_error('oldPrice() is outdated, use price()', E_USER_DEPRECATED);
return 100;
}
oldPrice();Результат:
Caught: oldPrice() is outdated, use price()Примечания
В отличие от исключения, сообщение не останавливает программу. Для настоящих ошибок бросайте исключения.
См. также
- set_error_handler — Задаёт свою функцию для обработки предупреждений и замечаний PHP.
- error_log — Записывает сообщение в журнал ошибок.
- Exception — Базовый класс исключений.
В учебнике
- Ошибки и отладка — Виды ошибок PHP, настройки показа ошибок, журнал, превращение предупреждений в исключения и приёмы отладки.