Приглашаем посетить
Романтизм (19v-euro-lit.niv.ru)

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

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

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

Синтаксис :
string set_error_handler(string error_handler)

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

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

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

  • код ошибки
  • строку, описывающую ошибку
  • имя сценария, в котором произошла ошибка
  • номер строки сценария, содержащей ошибку
  • контекст (массив, содержащий значения переменных, в момент возникновения ошибки)
    <?
    // определить константы пользовательских ошибок
    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
    )
    <b>Предупреждение</b> [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:\www\exampl.php, PHP 4.0.5 (WINNT)<br>
    Aborting...<br>
    
    Не забывайте, что при установке пользовательского обработчика ошибок стандартный обработчик PHP не используется. Установки error_reporting() также не будут иметь эффекта, и пользовательский обработчик должен уметь обрабатывать все виды ошибок (значение error_reporting() можно выяснить и действовать соответсвенно). Заметьте, что код ошибки будет равен 0, если ошибка возникла в функции, вывод ошибок для которой был блокирован оператором "@".

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

  • Назад Содержание Вперед