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-кода. В PHP предусмотрели много уровней ошибок и функция устанавливает этот уровень на время, пока выполняется скрипт. Функция error_reporting() просто вернёт текущий уровень сообщений об ошибках, если необязательный параметр error_level не установили.

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

error_level

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

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

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

Функция возвращает уровень сообщений об ошибках на основе значения директивы 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.

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