Справочник по PHP : Управляющие функции : Отслеживание и обработка ошибок : Установка пользовательского обработчика ошибок

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

Материал из Справочник Web-языков

Перейти к: навигация, поиск


set_error_handler

Установка пользовательского обработчика ошибок.

Синтаксис:

string set_error_handler(string error_handler)

Функция возвращает имя функции, ранее определенной в качестве обработчика ошибок (или FALSE при ошибке), и устанавливает, в качестве нового обработчика, функцию с указанным в аргументе error_handler именем.

Обычно пользовательский обработчик ошибок работает в паре с функцией trigger_error(), генерирующей ошибку. Это может быть использовано (подобно аналогичной конструкции работы с исключениями в C) для освобождения выделенных ресурсов (например, удаления созданных файлов), если сценарий не может нормально завершиться.

Функция, устанавливаемая в качестве обработчика ошибок, должна принимать пять параметров (три последних являются дополнительными и могут не обрабатываться):

  • код ошибки
  • строку, описывающую ошибку
  • имя сценария, в котором произошла ошибка
  • номер строки сценария, содержащей ошибку
  • контекст (массив, содержащий значения переменных, в момент возникновения ошибки)
<?php
// определить константы пользовательских ошибок
define(FATAL, E_USER_ERROR);
define(ERROR, E_USER_WARNING);
define(WARNING, E_USER_NOTICE);

// установить, какие ошибки должны обрабатываться в сценарии
error_reporting (FATAL | ERROR | WARNING);

// пользовательский обработчик ошибок
function myErrorHandler($errno,$errstr,$errfile,$errline) {
  switch ($errno) {
  case FATAL:
    echo "Критическая ошибка [$errno] $errstr
n"; echo "в строке: $errline файла:".$errfile; echo ", PHP ".PHP_VERSION." (".PHP_OS.")
n"; echo "Aborting...
n"; exit -1; break; case ERROR: echo "Ошибка [$errno] $errstr
n"; break; case WARNING: echo "Предупреждение [$errno] $errstr
n"; break; default: echo "Неизвестный тип ошибки: [$errno] $errstr
n"; } } // функция для проверки обработки ошибок // (масштабирование массива function scale_by_log($vect, $scale) { if(!is_numeric($scale) || $scale <= 0) trigger_error("вычислить log(x) для x <= 0 нельзя. ", "(x = $scale)", FATAL); if(!is_array($vect)) { trigger_error("Требуется массив ", ERROR); return null; } for($i=0; $i

При выполнении сценария вывод будет следующим:

Array
(
  [0] => 2
  [1] => 3
  [2] => foo
  [3] => 5.5
  [4] => 43.3
  [5] => 21.11
)

Предупреждение [1024] Элемент (2) не число,
  и его значением считается 0<br>
Массив, масштабированный на логарифм(Пи): Array
(
  [0] => 2.2894597716988
  [1] => 3.4341896575482
  [2] => 0
  [3] => 6.2960143721717
  [4] => 49.566804057279
  [5] => 24.165247890281
)
<b>Ошибка</b> [512] Требуется массив <br>
NULL
<b>Критическая ошибка</b> [256] вычислить log(x) для x <=0 нельзя,
  (x = -2.5)<br>
  в строке: 37, файла E:wwwexampl.php, PHP 4.0.5 (WINNT)<br>
Aborting...<br>

Не забывайте, что при установке пользовательского обработчика ошибок стандартный обработчик PHP не используется. Установки error_reporting() также не будут иметь эффекта, и пользовательский обработчик должен уметь обрабатывать все виды ошибок (значение error_reporting() можно выяснить и действовать соотвественно). Заметьте, что код ошибки будет равен 0, если ошибка возникла в функции, вывод ошибок для которой был блокирован оператором "@".

Также помните, что завершать сценарий в обработчике необходимо явно (например, с помощью функции die(), если, конечно, в этом есть необходимость. Если обработчик ошибок завершается с помощью return, то выполнение сценария продолжается с того места, в котором возникла ошибка (то есть исполняются инструкции, которые следуют за той инструкцией, в которой возникла ошибка).

Ссылки

Добавить страницу в закладки:
РАЗРЕШАЕТСЯ перепечатывать и копировать информацию ТОЛЬКО ПРИ РАЗМЕЩЕНИИ ссылки на оригинал!
(<A href="http://www.spravkaweb.ru/">Справочник Web-языков</A>)
другие проекты
Rambler\'s Top100 Индекс цитирования