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

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

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

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

    message

    Сообщение, которое соответствует этой ошибке. Длина сообщения ограничена 1024 байтами. Функция обрежет символы дальше 1024-го.

    error_level

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

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

    Функция всегда возвращает true.

    Ошибки

    Функция выбрасывает исключение ValueError, если значение параметра error_level не соответствует значениям E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE, E_USER_DEPRECATED.

    Список изменений

    ВерсияОписание
    8.0.0 Функция выбрасывает исключение ValueError, если указали недопустимое значение для параметра error_level. Раньше функция возвращала false.

    Примеры

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

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

    <?php

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

    ?>

    Примечания

    Внимание

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

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

    To Top