error_log

Посылка сообщения об ошибке.
Синтаксис:

int error_log(string message, int message_type [, string destination [, string extra_headers]])

Сообщение, посылаемое этой функцией, может быть направлено в журнал системных сообщений web-сервера, прот TCP или в файл.
В первом аргументе message указывается само содержание сообщения. Во втором аргументе message_type -
куда оно должно быть направлено.
Назначение обозначается следующими значениями:

0 - Сообщение заносится в системный журнал событий (файл) согласно установке параметра конфигурации
error_log.
1 - Сообщение отправляется по электронной почте, по адресу, указанному в аргументе destination.
Это единственный тип сообщения, использующий четвертый параметр extra_headers, в котором можно
указать дополнительные заголовки (как в функции mail()).
2 - Сообщение посылается через подключение отладки. Это возможно только в случае, если параметр
удаленной отладки был разрешен в файле конфигурации. Для этого также должен быть определен адрес
хоста (имя или его IP адрес) и порт сокета, который будет принимать сообщения отладки.
Это можно указать в аргументе destination или параметрах конфигурации.
3 - message добавляется в конец файла destination.

if(!Ora_London($username, $password)) {
error_log("Сервер Oracle недоступен!", 0);
};

if(!($foo = allocate_new_foo()) {
error_log("Нельзя выделить FOO!", 1, "operator@mydomain.ru");
}

// other ways of calling error_log():
error_log("У нас ошибка!", 2, "127.0.0.1:7000");
error_log("У нас ошибка!", 2, "localhost");
error_log("У нас ошибка!", 3, "/var/tmp/my-errors.log");

error_reporting

Установка видов сообщаемых ошибок.

Синтаксис:

int error_reporting([int level])

Функция error_reporting() возвращает предыдущую установку типа сообщаемых ошибок. Если указан аргумент, то заново переопределяет ее. В аргументе можно указывать константу, число или битовую маску. Старайтесь использовать константы вместо численных значений, чтобы сохранить совместимость с будущими версиями PHP.

error_reporting(2039); // в PHP эквивалент E_ALL ^ E_NOTICE
error_reporting(E_ALL ^ E_NOTICE); // установка по умолчанию
error_reporting(0); // отключить сообщения об ошибках

// общие ошибки выполненияerror_reporting(E_ERROR | E_WARNING | E_PARSE);

// также сообщать о неизвестных переменныхerror_reporting(E_ERROR | E_WARNING | E_PARSE | E_NOTICE);

error_reporting(E_ALL); // сообщать все ошибки

restore_error_handler

Восстановление предыдущего обработчика ошибок.
Синтаксис:

void restore_error_handler()

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

trigger_error

Генерация ошибки.
Синтаксис:

void trigger_error(string error_msg [, int error_type])

Явно вызывает функцию, установленную для обработки ошибок, и обычно используется в паре с обработчиком ошибок. Функция способна генерировать только пользовательские типы ошибок (семейство констант E_USER), и по умолчанию, если не указан тип ошибки error_type, он считается E_USER_NOTICE.

Возможно конструировать сложные конструкции генерации и обработки ошибок и исключительных ситуаций.

if(assert($divisor == 0))

trigger_error ("Нельзя делить на 0 ", E_USER_ERROR);

user_error

Синоним функции trigger_error().

Синтаксис:

void user_error(string error_msg [, int error_type])

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