error_reporting

(PHP 4, PHP 5, PHP 7, PHP 8)

error_reporting — Устанавливает, какие ошибки PHP попадут в отчёт

Описание

error_reporting(?int $error_level = null): int

Функция error_reporting() задаёт значение директивы error_reporting во время работы (выполнения) программы. PHP содержит много уровней ошибок. Через эту функцию задают уровень ошибок на время работы (выполнения) скрипта, которые попадут в отчёт. Если необязательный аргумент error_level не задан, функция error_reporting() вернёт текущее значение уровня протоколирования ошибок.

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

error_level

Новое значение уровня error_reporting. Параметр принимает либо битовую маску, либо именованные константы. При указании именованных констант нужно будет следить за совместимостью с новыми версиями PHP. По мере добавления уровней ошибок диапазон целых чисел увеличивается, поэтому старые уровни ошибок на основе целых чисел не всегда будут вести себя предсказуемо.

Доступные константы уровней ошибок и их описания приведены в разделе «Предопределённые константы».

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

Возвращает значение директивы error_reporting, которое в ней хранилось до того, как оно было изменено на значение параметра error_level.

Замечание: Оператор управления ошибками (@) изменяет значение параметра error_level во время обработки ошибки.

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

Версия Описание
8.0.0 Параметр error_level теперь может принимать значение null.

Примеры

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

<?php

// Выключение протоколирования ошибок
error_reporting(0);

// Включать в отчёт простые описания ошибок
error_reporting(E_ERROR | E_WARNING | E_PARSE);

// Включать в отчёт E_NOTICE сообщения (добавятся сообщения о
// непроинициализированных переменных или ошибках в именах переменных)
error_reporting(E_ERROR | E_WARNING | E_PARSE | E_NOTICE);

// Добавлять сообщения обо всех ошибках, кроме E_NOTICE
error_reporting(E_ALL & ~E_NOTICE);

// Добавлять в отчёт все ошибки PHP
error_reporting(E_ALL);

// Добавлять в отчёт все ошибки PHP
error_reporting(-1);

// То же, что и error_reporting(E_ALL);
ini_set('error_reporting', E_ALL);

?>

Примечания

Подсказка

Если передать значение -1, будут отображаться все возможные ошибки, даже если в новых версиях PHP добавятся уровни или константы. Поведение эквивалентно передаче константы E_ALL.

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