Ошибки PHP и журнал error_reporting

Библиотека PHP может генерировать ряд ошибок, не относящихся к уровню исключений – ошибок OOP.

В PHP обрабатываются три уровня ошибок: информационные ошибки, ошибки с возможностью действия (предупреждения) и неустранимые (фатальные) ошибки. Информационные ошибки: E_STRICT (устаревшая конструкция), E_NOTICE – компилятор столкнулся с логической проблемой, которая может привести к ошибке выполнения. Аналогично E_USER_NOTICE генерируемое пользователем уведомление

Ошибки с возможностью действия (предупреждения) означают, что возможно придется завершить работу с выдачей сообщения из-за того, что нельзя открыть файл и т.д. Ошибка - E_WARNING предупреждение времени выполнения связанное с возможностью выполнения функции или блока. Аналогично E_USER_WARNING генерируемое пользователем предупреждение. E_COMPILE_WARNING предупреждения времени компиляции.

Неустранимые (фатальные) ошибки возникают тогда, когда выполнение или загрузка программы невозможны. E_ERROR фатальные ошибки времени выполнения. E_PARSE ошибки разбора времени компиляции. E_COMPILE_ERROR фатальные ошибки времени компиляции. E_CORE_ERROR фатальные ошибки при начальном старте PHP.

Приведем значения нескольких констант, определяющих вывод типов ошибок и предупреждений: 1 - E_ERROR, 2 - E_WARNING, 4 - E_PARSE, 8 - E_NOTICE, 16 - E_CORE_ERROR, 32 - E_CORE_WARNING, 64 - E_COMPILE_ERROR, 128 - E_COMPILE_WARNING, 256 - E_USER_ERROR, 512 - E_USER_WARNING, 1024 - E_USER_NOTICE, E_ALL всё вышеуказанное.

Уровень сообщений об ошибках устанавливается как значение директивы error_reporting. В PHP установлено значение по умолчанию error_reporting = E_ALL & ~E_NOTICE, что означает отображение всех ошибок и предупреждений, за исключением логических ошибок, которые имеют уровень E_NOTICE.

Начальное значение error_reporting может быть изменено в php.ini-файле директивой error_reporting, в Apache httpd.conf-файле директивой php_error_reporting и, наконец, оно может быть установлено на этапе прогона скрипта функцией error_reporting().

Параметр error_reporting в php.ini файле устанавливает уровень строгости ошибок E_ERRORLEVEL, которые будут обрабатыватся внутренним обработчиком ошибок. Параметр display_error устанавливает вывод сообщений об ошибках на экран. Параметр log_errors регистрацию ошибок в журнальном файле, указанном в параметре error_log.

Слабая устойчивость к ошибкам.

В природе существует огромное количество скриптов абсолютно не справляющихся с пользовательскими ошибками. Своим появлением такие скрипты обязаны программистам, которые не удосуживаются правильно распланировать будущий проект и определить все места возможных ошибок. Причём этим следует заняться до того, как скрипт был написан. Недоработки подобного рода приводят к сбоям программы, что чревато не только получением некорректных результатов, но и падением системы!

Предусмотреть худшее.

Любой скрипт может "свалиться" при наступлении каких-либо "критичных" условий. Чтобы свести такой риск к минимуму всегда нужно:

проверять результаты вызова функций:

проверять результаты системных вызовов:

в файле php.ini устанавливать уровень error_reporting на E_ALL

Проверка результатов вызова функций

При вызове функции, результаты которой подвергаются дальнейшей обработке, обязательно убедитесь, что возвращаемые данные находятся в интервале допустимых значений.

В приведённом ниже примере на шестом витке цикла возникает ошибка "деление на ноль", поскольку $i наращивается на 1, а $j уменьшается на 1. На шестом проходе $i=$j=1.

<?php

mt_srand((double)microtime() * 10000000);

function do_math ($a, $b) {

return (($a - $b) * 2) / mt_rand();

}

for ($i = 5, $j = -5; $i > -5; $i--, $j++){

print $j / do_math ($i, $j). "\n";

}

?>

Проверка результатов системных вызовов

При обращении к внешним файлам или процессам всегда проверяйте, всё ли работает корректно.

Хороший пример - проверка ответа системы при вызове функции sql_connect(). Стоит проверить этот ответ и убедиться, что подключение к БД действительно имело место. Если этого не сделать, то все запросы к БД могут не состояться, а некоторые данные могут быть утеряны.

<?php

$conn = @sql_connect ($host, $user, $pass);

if (!$conn) {

die (sprintf ("Ошибка [%d]: %s", sql_errno (), sql_error ()));

}

?>

Установка уровня error_reporting в файле php.ini на E_ALL

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

Обратимся ещё раз к примеру, приведённому в части "Проверка результатов вызова функций". Предположим, что error_reporting выставлен не на максимум, а, скажем, на E_ERROR.

Обратите внимание на то, как скрипт выполняет функцию do_math, но не сообщает об ошибке "деление на ноль", которая, однако, имела место (при $i=$j=0 вывода результата просто не было).

<?php

error_reporting(E_ERROR);

mt_srand ((double)microtime() * 1000000);

function do_math ($a, $b) {

return (($a - $b) * 2) / mt_rand();

}

for ($i = 5, $j = -5; $i > -5; $i--, $j++){

print $j / do_math ($i, $j). "\n";

}

?>

Результат работы скрипта:

-5148.25

-5271

-323.75

-4931

-7713.5

-4702.5

-488.5

-928.5

-1394.75

Свои обработчики ошибок

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

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

Если происходит ошибка класса E_ERROR, работа скрипта прекращается и выводится сообщение об ошибке.

<?php

// void error_handler(string type, string message, string file, int line)

// Индивидуальный обработчик ошибок, определён функцией

// set_error_handler()

function error_handler ($type, $message, $file = __FILE__, $line = __LINE__) {

error_log("$message, $file, $line", 3, 'error_file');

if ($type & E_ERROR) {

print 'Произошла ошибка, зарегистирована.';

exit;

}

}

set_error_handler('error_handler');

?>

Файлы

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

Для того, чтобы вставить другие файлы в текущий текстовый файл PHP, может использоваться директива include "filename". Строка filename содержит имя включаемого файла.

При работе с файлами в PHP используются три действия: 1) открытие файла для чтения или записи, 2) чтения или записи, 3) закрытие файла.

Открытие файла:

fopen ($filename, $mode [, use_include_path]). Функция осуществляет открытие файла с именем, указанным в $filename, и возвращает его дескриптор (номер). Режим открытия файла mode, может принимать следующие значения:

"r" - файл открывается только для чтения. "r+" - открывается на чтение и на запись. Текущий указатель файла устанавливается в его начало.

"w" - Файл открывается только для перезаписи. Указатель файла устанавливается в его начало. Всё старое содержимое файла теряется, счётчик длины файла устанавливается равным 0. Если файл с указанным именем не существует, функция пытается его создать. "w+" - Файл открывается на чтение и на запись. Указатель файла устанавливается в его начало. Всё старое содержимое файла теряется.

"a" - Файл открывается на добавление (запись). Указатель файла помещается в конец файла. Если файл с указанным именем не существует, функция пытается его создать. "a+" - Файл открывается на чтение и на запись. Вот несколько примеров открытия файлов с помощью fopen()

$fp = fopen ("/home/a/bases.dat", "r");

$fp = fopen ("/home_dir/client/count.txt", "w+");

$fp = fopen ("http://www.yahoo.com/pp.txt", "r");

В случае успешного завершения функция fopen() возвращает "ссылку" на открытый файл, а в случае ошибки эта функция возвращает булевское значение false.

В РНР имеется возможность удаленного открытия файлов путем указания URL-адреса в качестве параметра $filename функции fopen (). Осуществлять запись в такие файлы, невозможно, но зато можно их читать.

URL, содержащие недопустимые символы (например, пробельные символы в имени файла), необходимо кодировать перед их использованием с помощью функции urlencode (). Функция urlencode () принимает единственный параметр (URL, подлежащий кодированию) и возвращает закодированный URL. Использование функции fореn()

<?php

/* Открыть файл для чтения */

$fr = fopen("myfile.txt", 'r');

/* Открыть бинарный файл для чтения/добавления */

$fr = fopen("myfile.dat", 'ba+');

/* Открыть файл для чтения/записи (искать файл в пути,

заданном директивой include_path)*/

$fr = fopen("code.php", 'w+', true);

/* Открыть файл index.php, для чтения по протоколу HTTP */

$fr = fopen("http://www.php.net/index.php", 'r');

/* Открыть файл index.php, для чтения по протоколу FTP */

$fr = fopen("ftp://ftp.php.net/index.php", 'r');

/*Закодировать URL, затем открыть для чтения по протоколу HTTP */

$url = "http://www.php.net/this is my invalid URL.php";

$url = urlencode($url);

$fr = fopen($url, 'r');

?>

Закрытие файла: bool fclose ($fp).

Для работы с текстовыми файлами наиболее часто используются функции: fgets (), которая извлекает строку из файла, и fputs (), которая записывает строку в файл.

Функция считывания строки string fgets ($fp, $length) возвращает строку длиной до length-1 байт, считанную из файла $fp. Операция чтения завершается после загрузки length-1 символов, либо после обнаружения символа конца строки, либо при обнаружении признака конца файла. Вот пример построчного вывода на экран, содержимого файла:

<? //pr415

$fp = fopen ("pr415.php", "r");

while (!feof ($fp)) {

$stroka = fgets ($fp, 80);

echo $stroka."<BR>";

}

fclose($fp);

?>

Загрузка строки с пропуском HTML-тегов выполняется функцией: string fgetss ($fp, $length [, string allowable_tags]). Функция работает идентично fgets(), однако считанной строки удаляются все HTML-теги, которые в ней присутствуют. Есть возможность использовать необязательный третий аргумент, для указания разрешенных тегов, которые удалены не будут.

Альтернативой fgets () является функция fscanf (). Синтаксис функции fscanf () показан ниже:

fscanf ($filename, $format, $var_one [, $var_two...]]])

где $filename — входной поток, $format задает шаблон для чтения, а $var_one, $var_two представляют собой переменные, в которых сохраняются разобранные фрагменты данных (эти параметры необходимо передавать по ссылке). В случае успешного завершения ввода fscanf () возвращает количество разобранных элементов, а случае ошибки возвращает значение false.

Допустимые символы форматирования функции fscanf ()

%b Двоичное число.

%с Одиночный символ.

%d Десятичное число со знаком.

%u Десятичное число без знака.

%f Число с плавающей запятой.

%о Восьмеричное число.

%s Строка.

%x Шестнадцатиричное число.

Функция fputs () служит для записи строки (или любых других данных) в указанный поток и имеет следующийсинтаксис: fputs($filename, $data [, int $length]), где $filename представляет выходной поток, $data содержит записываемые данные, а необязательный параметр $length задает размер фактически записываемых данных.

Чтение и запись бинарных файлов

Чтение данных из файла: string fread (int $fp, int length). Функция осуществляет чтение до length байт из файла, адресуемого указателем fp. Чтение прекращается, если будет считано указанное количество байт, или будет достигнут конец файла.

Запись данных в файл: int fwrite (int $fp, string str [, int length])

Функция производит запись содержимого строки string в файл, адресуемый указателем fp. Если задан аргумент length, операция записи прекращается после вывода указанного количества символов, либо при достижении конца строки.

<? //pr416

$open=fopen("my_file.txt","w+");

//Очищаем файл и добавляем в него строку,

//если файл не существует, то он создаётся:

fwrite($open,"строка\r\n");

fclose($open);

//Добавляем новую строку в конец файла:

$open=fopen("my_file.txt","a");

fwrite($open,"новая строка\r\n");

fclose($open);

?>

В созданном файле my_file.txt будут записаны две строки

строка

новая строка

Загрузка всего файла: array file (string filename [, int use_include_path]). Функция file() записывает запрошенный файл в массив. При этом каждый элемент массива представляет собой одну строку файла. Символ новой строки, является последним символом каждой строки.

<? //pr417

//Создаём массив $array, где каждый индекс будет равняться номеру строки в файле:

$array=file("pr417.php");

print_r($array);

$count=count($array); // количество строк в файле

echo $count;

?>

Будет выведено:

Array ([0] => //Создаём массив $array, где каждый индекс будет равняться номеру строки в файле: [2] => $array=file("php416.php"); [3] => print_r($array); [4] => //Подсчитываем количество строк в файле: [5] => $count=count($array); [6] => echo $count; [7] =>?>) 8

<?php //php418.php - вывод строк из файла

$fi="php418.php"; // имя файла

$array=file($fi);

//Считываем из файла первые 3 строки:

echo "<hr>";

$n=3; //количество считываемых строк

for($i=0;$i<$n;$i++)

{print "$i: $array[$i],'\n'"; }

for($i=(count($array)-$n-1);$i<count($array)-1;$i++)

{ echo "$i: $file[$i],'\n'"; }

?>

Будет выведено три первых и три последних строки:

0: <?php //php418.php - вывод строк из файла,

' '1: $fi="pr418.php"; // имя файла,

' '2: $array=file($fi);,

' '10: { echo "$i: $array[$i],'\n'"; },

' '11:,

' '12:?>,' '

Объединяем 2 файла в один массив $new_array:

<? //pr419

$files=array(

"php416.php", # первый файл

"php417.php" # второй файл

);

for($i=0;$i<count($files);$i++)

{

$array[]=file($files[$i]);

}

while(list(,$result)=each($array))

{

for($i=0;$i<count($result);$i++)

{ $new_array[]=$result[$i]; }

}

print_r($new_array); #выводим массив

?>

Пример. Удаление указанной строки из файла:

<?

$line="1"; # строка, которую нужно удалить

$file=file("my_file.txt");

$open=fopen("my_file.txt","w");

for($i=0;$i<count($file);$i++)

{

if(($i+1)!=$line){fwrite($open,$file[$i]);}

}

fclose($open);

?>

В следующем примере массив устанавливается в файл. Затем выполняется замена строки в файле на указанную с помощью функции fwrite():

<?

$line="1"; # строка, которую нужно изменить

$replace="du du du"; # на что нужно заменить

$filarr=file("my_file.txt");

$f=fopen("my_file.txt","w");

for($i=0;$i<count($filarr);$i++)

{

if(($i+1)!=$line){fwrite($f,$file[$i]);}

else{fwrite($f,$replace."\r\n");}

}

fclose($f);

?>

Поиск слова в файле. Ищем в файле file.txt слово привет:

<?PHP

$word="привет"; # искомое

$f="file.txt"; # имя файла, в котором будем искать слово

$open=fopen($file,"r");

while(!feof($open)) $search.=fgets($open,1024);

fclose($open);

if(eregi(strtolower($word),strtolower($search)))

{ echo "Слово ".$word." - найдено"; }

else

{ echo "Слово ".$word." - не найдено"; }

?>

Прямой доступ к указанной позиции бинарного файла осуществляется с помощью функции fseek (): fseek($file, $offset [, $reference]);

где $offset указывает число байт смещения от начала файла ($reference =SEEK_SET или по умолчанию) от текущей позиции файла ($reference=SEEK_CUR), от конца файла ($reference= SEEK_END). Функция fseek () может использоваться только для файлов, расположенных в локальной файловой системе и не работает с файлами, которые открываются удаленно по протоколу HTTP или FTP. Функция fseek () возвращает нуль в случае успешного завершения и -1 в случае, если указатель файла не может быть установлен. Отсчет смещений указателя в fseek () начинается с нуля. Чтобы установить указатель файла в позицию $offset, функции fseek () необходимо передать параметр $offset-l.

Копирование одного файла в другой можно выполнить с помощью функции copy(filefrom,fileto);. Функция unlink(filename) –удаляет файл. Функция rename(oldname, newname)-переименовывает файл.