Теория: Исключения и ошибки

PHP:

1. <?php
2. set_error_handler('onError');
3. echo '<h1>Работа с исключениями (ошибками)</h1>';
4.  
5. /*
6. Здесь будет описано как работать с исключениями и ошибками.
7. Сразу хочу отметить что все написанное здесь работает, минимум, в PHP5
8. Да, да, прямо сейчас вы можете вставить весь этот код в ваш файл test.php и разобраться, как это работает.
9.  
10. Если вам знакомы исключения, этот материал МОЖЕТ оказаться полезным.
11.  
12. Для тех кто не в курсе, что за зверь эти исключения:
13. В вкратце, исключения - это, по сути, ошибки, или, как сказано в википедии, «возможные проблемы, которые могут возникнуть при выполнении программы».
14. Например, при регистрации пользователя могут происходить такие исключения:
15. * неверный e-mail
16. * такой e-mail уже используется
17. * такой логин уже зарегистрирован
18. и т.д.
19. Иногда, исключениями считают ошибки, предусмотренные программистом.
20. Мы будем использовать любую не фатальную ошибку в качестве исключения.
21. Также, предлагаю прочитать:
22. * [url=http://ru.wikipedia.org/wiki/]http://ru.wikipedia.org/wiki/[/url]Обработка_исключений
23. * [url=https://php.ru/manual/language.exceptions.php]http://php.net/manual/en/language.exceptions.html[/url]
24.  
25. Для полного погружения полезно изучить ООП и наследование
26. * [url=http://ru.wikipedia.org/wiki/]http://ru.wikipedia.org/wiki/[/url]Объектно-ориентированное_программирование
27. * [url=http://ru.wikipedia.org/wiki/]http://ru.wikipedia.org/wiki/[/url]Наследование_(программирование)
28.  
29. После прохождения этого квеста вы сможете наслаждаться такой конструкцией:
30. */
31. echo '<h2>Пример исключения</h2>';
32. try {
33.     $handle = fopen('file.txt', 'r');
34.     $line = fgets($handle, $text);
35.     fclose($handle);
36.     echo 'Строка из файла успешно прочитана: ',htmlspecialchars($line);
37. }
38. catch (ErrorException $e) {
39.     // обработка исключения работы с файлом
40.     echo '<h3>Ошибка при работе с файлом:</h3>',$e->getMessage();
41. }
42.  
43. /*
44. Ошибки и исключения в PHP это разные вещи.
45. Объединим их - ошибки будут вызвать исключения
46.  
47. Вначале кода стоит строка - set_error_handler('onError');
48. Функция set_error_handler регистрирует функцию, которая будет обрабатывать все ошибки (кроме фатальных).
49.  
50. Наша функция onError будет ловить ошибку и вызывать исключение ErrorException:
51. */
52. function onError($code, $message, $file, $line) {
53.     throw new ErrorException($message, $code, E_ALL, $file, $line);
54. }
55.  
56. /*
57. С обычного объекта исключения вы можете получить такую информацию:
58. $e->getMessage();                - Сообщение исключения
59. $e->getCode();                  - Номер ошибки
60. $e->getFile();                  - Файл, в котором произошло исключение
61. $e->getLine();                  - Строка
62. $e->getTrace();                  - обратная трассировка (массив)
63. $e->getTraceAsString();          - тоже самое ввиде строки
64. Все эти функции показали себя очень полезными.
65. Предлагаю добавить еще одну - $e->getContext()
66. В функцию которая зарегистрирована в set_error_handler PHP передает ссылку на таблицу переменных, того места, где произошла ошибка.
67. Что бы добавить эту переменную в исключение - расширим класс Exception:
68. */
69. set_error_handler('onErrorEx');
70. function onErrorEx($code, $message, $file, $line, $context) {
71.     throw new ExErrorException($message, $code, $file, $line, $context);
72. }
73. class ExErrorException extends Exception {
74.     protected $context;
75.     function __construct($message = '', $code = 0, $file = null, $line = null, $context = null) {
76.         $this->message = $message;
77.         $this->code = $code;
78.         $this->file = $file;
79.         $this->line = $line;
80.         $this->context = $context;
81.     }
82.     public function getContext() {
83.         return $this->context;
84.     }
85. }
86.  
87. echo '<h2>Расширенный обьект исключений</h2>';
88.  
89. function testContext() {
90.     $var1 = 1;
91.     $var2 = 2;
92.     // Создаем исключение, для этого, например выводим $var3, которая не определена: ошибка PHP -> onErrorEx() -> throw new ExErrorException()
93.     echo $var3;
94. }
95. try {
96.     testContext();
97. }
98. catch (ExErrorException $e) {
99.     echo '<h3>Наше исключение:</h3>';
100.     echo $e->getMessage();
101.     echo '<h3>Таблица переменных, где произошло исключение</h3>';
102.     echo '<pre>';
103.     $context = $e->getContext();
104.     print_r($context);
105.     echo '</pre>';
106. }
107.  
108. /*
109. Можно отлавливать исключения, одного блока try, разных типов:
110. */
111. class a extends Exception {}
112. class b extends Exception {}
113. echo '<h2>Обработка исключений разных типов</h2>';
114. if (isset($e)) unset($e);
115. try {
116.     $rand = rand(0, 1);
117.     $message = "Rand вернул $rand";
118.     if ($rand) {
119.         throw new a($message);
120.     }
121.     else {
122.         throw new b($message);
123.     }
124. }
125. catch (a $e) {
126.     // особый код для исключения a
127. }
128. catch (b $e) {
129.     // особый код для исключения b
130. }
131. if (isset($e)) { // общий код для исключений типа a или b
132.     echo 'Произошла ошибка типа ',get_class($e),'.<br />Сообщение исключения: ',$e->getMessage();
133. }
134.  
135.  /*
136.  Любой класс «родитель» может отлавливать исключения «детей».
137.  Исключение Exception - родитель всех исключений, им можно отловить ЛЮБОЕ исключение.
138.  Имеет значение порядок блоков catch.
139.  */
140.  
141.  echo '<h2>Наследование в исключениях</h2>';
142.  try {
143.      throw new a;
144.  }
145.  catch (Exception $e) {
146.      echo '<h3>Отловили исключение класса ',get_class($e),' при помощи родителя Exception</h3>';
147.  }
148.  catch (a $e) {
149.      echo '<h3>Этот блок не отработает, т.к. его нужно было разместить раньше</h3>';
150.  }
151.  
152. /*
153. можно отлавливать исключения по интерфейсу
154. */
155. interface MyExceptionInterface {}
156. class MyException extends Exception implements MyExceptionInterface {}
157. try {
158.     throw new MyException;
159. }
160. catch (MyExceptionInterface $e) {
161.     echo "Поймали исключение с интефейсом MyExceptionInterface";
162. }
163.  
164. /*
165. При использовании set_error_handler приготовьтесь к:
166.  
167. 1. У вас начнут появляться ошибки, которых раньше не было даже с error_reporting(E_ALL);
168. Например, при обращении к статической функции, которая не объявлена как статическая, - произойдет исключение
169.  
170. 2. Исключение подавить символом @ не получится - его следует только отлавливать.
171.  
172. 3. Мне не встречалась библиотека, написанная с учетом пункта 1, а потому при подключении/использовании «сторонних» классов/функций/framework'ов/... готовьтесь ловить исключение ;)
173. Как выход, исправляйте в них баги или, на время, отключайте set_error_handler, для этого есть функция restore_error_handler()
174.  
175.  
176. *** В данной статье, для наглядности, я сначала использовал функцию, а позже ее определял - это особенность PHP: функции определяются до выполнения кода
177. например, в самом начале в строке set_error_handler('onError'); используется функция onError, которая определяется позже
178.  
179. *** Версия и дата сборки cтатьи написана ниже ;)
180.  
181. Релевантно:
182. - [url=http://phpclub.ru/faq/PHP5/Exception]http://phpclub.ru/faq/PHP5/Exception[/url]
183. - [url=http://habrahabr.ru/blogs/php/30399/]http://habrahabr.ru/blogs/php/30399/[/url] (Обработка ошибок и исключений в PHP)
184. - [url=http://www.pyha.ru/forum/topic/103.0]http://www.pyha.ru/forum/topic/103.0[/url] (Обработка исключений в PHP)
185.  
186. Ti, version RC3, 2007-2010, специально для php.ru/forum
187. */
188. ?>

 

обработка исключений - это более удобный способ обработки ошибок, а ошибки могут возникать ВЕЗДЕ, а посему, обрабатывать исключения можна везде, вплоть до паранои

 

вот пример того как исключения могут облегчить жизнь:

Кусок кода получает реферер и сверяет его хост с текущим.


ДО исключений.
Код запутан и слишком излишен, в стиле "две страници ассамблера, что делает не знаю, но трогать баюсь" (С) БОР

PHP:

1. <?php
2. $referer = isset($_SERVER['HTTP_REFERER']) ? $_SERVER['HTTP_REFERER'] : false;
3. $our = false;
4. if ($referer) {
5.     $arr = @parse_url($referer);
6.     if ($arr) {
7.         if (isset($arr['host']) and strcasecmp($arr['host'], $_SERVER['HTTP_HOST']) == 0) $our = 1;
8.     }
9.     else {
10.         $referer = false;
11.     }
12. }

ПОСЛЕ исключений

PHP:

1. <?php
2. try {
3.     $referer = $_SERVER['HTTP_REFERER'];
4.     $arr = parse_url(referer);
5.     $our = strcasecmp($arr['host'], $_SERVER['HTTP_HOST']) == 0;
6. }
7. catch (ErrorExceptionEx $e) {
8.     $our = $referer = false;
9. }

 

dark-demon
скромный вопрос: как Вы узнаете об ошибках на работающих проектах?

 

и ошибки, возникающие при использовании @

 

Существующий ключ в середине массива
0.000124931335449 // if .. else
0.000010013580322 // @
0.000005960464478 // ErrorExceptionEx

Не существующий ключ в середине массива
0.000012874603271 // if .. else
0.000005960464478 // @
0.000005006790161 // ErrorExceptionEx

PHP:

1. <?
2. class ErrorExceptionEx extends Exception {
3.  
4.  
5.     protected $context;
6.  
7.  
8.     function __construct($message = '', $code = 0, $file = null, $line = null, $context = null) {
9.         $this->message = $message;
10.         $this->code = $code;
11.         $this->file = $file;
12.         $this->line = $line;
13.         $this->context = $context;
14.     }
15.  
16.  
17.     public function getContext() {
18.         return $this->context;
19.     }
20.  
21.  
22. }
23.  
24. function onErrorEx($code, $message, $file, $line, $context) { throw new ErrorExceptionEx($message, $code, $file, $line, $context); }
25. function setExErrorHandler() { set_error_handler('onErrorEx'); }
26. setExErrorHandler();
27.  
28. // большой массив
29. $a = range(1, 1024*32);
30.  
31. echo '<h2>Существующий ключ в середине массива</h2>';
32. $key = floor(count($a)/2);
33. test($key);
34.  
35. echo '<h2>Не существующий ключ в середине массива</h2>';
36. $key++;
37. unset($a[$key]);
38. test($key);
39.  
40. function test($i) {
41.     global $a;
42.  
43.     // @
44.     restore_error_handler();
45.     $t = microtime(true);
46.  
47.     @$a[$i]++;
48.  
49.     echo number_format(microtime(true)-$t, 15), '<br />';
50.     setExErrorHandler();
51.  
52.     // if
53.     $t = microtime(true);
54.  
55.     if (isset($a[$i])) $a[$i]++;
56.     else $a[$i] = 1;
57.  
58.     echo number_format(microtime(true)-$t, 15), '<br />';
59.  
60.     // Exception
61.     $t = microtime(true);
62.  
63.     try { $a[$i]++; }
64.     catch (ErrorExceptionEx $e) { $a[$i] = 1; }
65.  
66.     echo number_format(microtime(true)-$t, 15), '<br />';
67. }

 

Тоже самое, только с переменными:

Cуществующая переменная
0.000088930130005 // if .. else
0.000009059906006 // @
0.000005006790161 // ErrorExceptionEx

Не существующая переменная
0.000010967254639 // if .. else
0.000006198883057 // @
0.000051975250244 // ErrorExceptionEx

 

Такая схема, это прямая разруха юзабилити.

Исключение вызывается в месте, которое не знает как его обработать.
Обычно это класс.
Класс посетителя, в нем метод регистрации, этот метод не знает как решать проблему неверных данных – он создает исключение.
Исключение может содержать информацию о нескольких ошибках.