Справочник по PHP : Управляющие функции : Отслеживание и обработка ошибок : Функции обработки ошибок
смотрим также
Материал из Справочник Web-языков
Содержание |
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, "[email protected]"); } // 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])