set_error_handler

(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

set_error_handler — Задає користувальницький обробник помилок

Опис

set_error_handler(?callable $callback, int $error_levels = E_ALL): ?callable

Задає функцію користувача (callback), як обробник помилок у скрипті.

Функція може бути використана для визначення користувальницьких обробників помилок під час виконання, наприклад, у додатках, які повинні виконувати очищення файлів/даних у разі виникнення критичної помилки або при ініціювання помилки у відповідь на певні умови (використовуючи функцію trigger_error()

Важливо пам'ятати, що стандартний обробник помилок PHP не оброблятиме жодні типи помилок, визначені в error_levels, поки callback-функція не поверне false. Користувальницький обробник буде викликатись у разі виникнення будь-якої помилки, незалежно від налаштувань, заданих функцією error_reporting

Також зверніть увагу, що обробник зобов'язаний при необхідності зупинити виконання скрипту, викликавши функцію exit(). Якщо відбувається повернення з оброблювача помилок, керування передається наступному виразу, що стоїть за тим, що викликало помилку.

Помилки таких типів не можуть бути оброблені користувачем: E_ERROR E_PARSE E_CORE_ERROR E_CORE_WARNING E_COMPILE_ERROR E_COMPILE_WARNING незалежно від того, де вони були згенеровані і більшість помилок E_STRICT, що відбулися у файлі, де викликана функція set_error_handler()

Якщо помилки виникають до запуску скрипта (наприклад, поки файл завантажується), обробний користувач не буде викликатися, якщо на цей момент він ще не зареєстрований.

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

callback

Якщо передано значення null, обробник скидається у стан за промовчанням. В іншому випадку обробник являє собою callback-функцію з наступною сигнатурою:

handler(    int $errno,    string $errstr,    string $errfile = ?,    int $errline = ?,    array $errcontext = ?): bool

errno

У перший аргумент errno буде передано рівень помилки як цілого числа.

errstr

У другому аргументі errstr буде передано повідомлення про помилку у вигляді рядка.

errfile

Якщо функція зворотного дзвінка приймає третій параметр errfile, то в нього буде передано ім'я файлу, в якому сталася помилка у вигляді рядка.

errline

Якщо функція зворотного дзвінка приймає четвертий параметр errline, то в нього буде передано номер рядка, в якому відбулася помилка, у вигляді цілого числа.

errcontext

Якщо функція зворотного дзвінка приймає п'ятий параметр errcontext, то нього буде передано масив покажчиків на активну таблицю символів у точці, де сталася помилка. Іншими словами, errcontext міститиме масив усіх змінних, що існують в області видимості, де сталася помилка. Користувальницькі обробники помилок не повинні змінювати цей контекст.

Увага

Цей параметр оголошено Застарілим починаючи з PHP 7.2.0 і був ВИДАЛЕНО у PHP 8.0.0. Якщо у вашій функції цей параметр використовується і для нього не встановлено значення за промовчанням, то при виклику функції обробника буде видана помилка "too few arguments".

Якщо функція повертає false, керування передається вбудованому обробнику помилок.

error_levels

Може використовуватися для завдання маски, відповідно до якої буде викликатись callback, за аналогією з ini-настройкою error_reporting, яка відповідає за те, які помилки будуть показані у звіті. Без цієї маски callback буде викликатися для обробки всіх помилок, що відбуваються, незалежно від налаштувань в error_reporting

Значення, що повертаються

Повертає раніше певний обробник помилок (якщо є) Якщо на даний момент використовується вбудований обробник, функція поверне null. Якщо попередній певний обробник є методом класу, функція поверне масив, який містить ім'я класу та ім'я методу.

список змін

Версия	Опис
8.0.0	Параметрerrcontext був видалений і більше не передається в функцію обробки помилок.
7.2.0	Параметрerrcontext оголошено застарілим. Тепер при його використанні викликатиметься помилка рівня E_DEPRECATED

Приклади

Приклад #1 Обработка ошибок с помощью функцийset_error_handler()иtrigger_error()

Приклад нижче демонструє обробку внутрішніх виключень шляхом виклику помилок різних типів та їх обробки користувальницькою функцією:

Loading...
▶

Висновок наведеного прикладу буде схожим на:

vector a
Array
(
    [0] => 2
    [1] => 3
    [2] => foo
    [3] => 5.5
    [4] => 43.3
    [5] => 21.11
)
----
vector b - a notice (b = log(PI) * a)
<b>Пользовательское УВЕДОМЛЕНИЕ</b> [1024]  Значение на позиции 2 не является числом, будет использован 0 (ноль)<br />
Array
(
    [0] => 2.2894597716988
    [1] => 3.4341896575482
    [2] => 0
    [3] => 6.2960143721717
    [4] => 49.566804057279
    [5] => 24.165247890281
)
----
vector c - a warning
<b>Пользовательское ПРЕДУПРЕЖДЕНИЕ</b> [512] Некорректный входной вектор, пропущен массив значений<br />
NULL
----
vector d - fatal error
<b>Пользовательская ОШИБКА</b> [256] log(x) for x <= 0 is undefined, you used: scale = -2.5<br />
  Фатальная ошибка в строке 35 файла trigger_error.php, PHP 5.2.1 (FreeBSD)<br />
Завершение работы...<br />

Дивіться також

• ErrorException
• error_reporting() - Встановлює, які помилки PHP потраплять у звіт
• restore_error_handler() - Відновлює попередній обробник помилок
• trigger_error() - Викликає помилку користувача/попередження/повідомлення
• Константи рівнів помилок