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

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

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 "<b>Критическая ошибка</b> [$errno] $errstr<br>n";

echo "в строке: $errline файла:".$errfile;

echo ", PHP ".PHP_VERSION." (".PHP_OS.")<br>n";

echo "Aborting...<br>n";

exit -1;

break;

case ERROR:

echo "<b>Ошибка</b> [$errno] $errstr<br>n";

break;

case WARNING:

echo "<b>Предупреждение</b> [$errno] $errstr<br>n";

break;

default:

echo "Неизвестный тип ошибки: [$errno] $errstr<br>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<count($vect); $i++) {

if(!is_numeric($vect[$i]))

trigger_error("Элемент ($i) не число и

его значением считается 0", WARNING);

$temp[$i]=log($scale)*$vect[$i];

}

return $temp;

}

// установить пользовательский обработчик ошибок

$old_error_handler=set_error_handler("myErrorHandler");

$a=array(2,3,"foo",5.5,43.3,21.11);

print_r($a);

$b=scale_by_log($a,M_PI); // здесь выдается предупреждение

echo "Массив, масштабированный на логарифм(Пи): ";

print_r($b);

$c=scale_by_log("not array",2,3); // здесь ошибка

var_dump($c);

$d=scale_by_log($a, -2.5); // здесь критическая ошибка

echo "Продолжение сценария...";

?>

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

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, то выполнение сценария продолжается с того места, в котором возникла ошибка (то есть исполняются инструкции, которые следуют за той инструкцией, в которой возникла ошибка).