PHP существует довольно давно и разработал свои особенности и особенности. Он также разработал свой собственный вид отчетов об ошибках, который довольно прост. В этом посте мы покажем вам, как легко добавить мониторинг ошибок для PHP.
- Что такое ошибка PHP?
- Какие бывают типы ошибок в PHP?
- Ошибки синтаксического анализа или синтаксиса
- Фатальные ошибки
- Предупреждение об ошибках
- Уведомление об ошибках
- Как включить отчеты об ошибках в PHP
- Сколько уровней ошибок доступно в PHP?
- Ошибки отображения PHP
- Что такое предупреждение PHP?
- Как помогают отчеты о сбоях
- Завершение отчета об ошибках PHP
Что такое ошибка PHP?
Ошибка PHP — это структура данных, представляющая что-то, что пошло не так в вашем приложении. В PHP есть несколько конкретных способов вызова ошибок. Один из простых способов имитировать ошибку — использовать die()функцию:
die("something bad happened!");
Это завершит программу PHP и сообщит об ошибке. Когда программа завершается, это то, что мы называем фатальной ошибкой. Позже вы увидите, что мы можем контролировать, как именно обрабатывается ошибка, в случае, если нам нужно вызвать некоторую логику очистки или перенаправить сообщение об ошибке. Вы также можете смоделировать это с помощью trigger_error()функции:
<?php trigger_error("something happened"); //error level is E_USER_NOTICE //You can control error level trigger_error("something bad happened", E_USER_ERROR); ?>
По умолчанию это вызовет в системе некритическое уведомление. Вы можете переопределить уровень ошибки, если вам нужна более серьезная ошибка.
На самом деле в PHP есть две формы ошибок: стандартные обычные ошибки и исключения.
Исключения были введены в PHP 5. Они дают вам легче семантику, как try, throwи catch. Исключение легко создать. Это следует из большого успеха языков со статической типизацией, таких как C # и Java.
throw new Exception("Yo, something exceptional happened);
Перехват и выдача исключений, как правило, более упрощены, чем более традиционная обработка ошибок PHP. Вы также можете иметь более локализованную обработку ошибок, а не только глобальную обработку ошибок с помощью set_error_handler (). Вы можете окружить конкретную логику блоками try / catch, которые заботятся только о конкретных исключениях:
<?php try { doSystemLogic(); } catch (SystemException $e) { echo 'Caught system exception '; } try { doUserLogic(); } catch (Exception $e) { echo 'Caught misc exception '; } ?>
Какие бывают типы ошибок в PHP?
Ошибка PHP — это не одно и то же, но бывает четырех разных типов:
- синтаксические или синтаксические ошибки
- фатальные ошибки
- предупреждения об ошибках
- замечать ошибки
Ошибки синтаксического анализа или синтаксиса
Первая категория ошибок в PHP — это ошибки синтаксического анализа, также называемые синтаксическими ошибками. Они просто означают, что в вашем скрипте есть один или несколько неправильных символов. Возможно, вы пропустили точку с запятой или неправильно поставили скобку. Взгляните на следующий пример:
<?php $age = 25; if ($age >= 18 { echo 'Of Age'; } else { echo 'Minor'; } ?>
Запустив приведенный выше сценарий, я получаю следующую ошибку:
Parse error: syntax error, unexpected '{' in <path> on line 4
С помощью сообщения об ошибке легко увидеть, что в операторе if отсутствует закрывающая скобка. Давайте исправим это:
<?php $age = 25; if ($age >= 18) { echo 'Of Age'; } else { echo 'Minor'; } ?>
Фатальные ошибки
Неустранимые ошибки, как следует из их названия, — это те, которые способны убить — или привести к сбою — приложение. Другими словами, фатальные ошибки — это критические ошибки, означающие, что произошло что-то катастрофическое, и приложение не может продолжать работу.
Часто причиной фатальных ошибок является неопределенный класс, функция или другой артефакт. Если сценарий пытается использовать несуществующую функцию, PHP не знает, что делать, и сценарий необходимо остановить.
Рассмотрим следующий сценарий:
<?php function add($a, $b) { return $a + $b; } echo '2 + 2 is ' . sum(2, 2); ?>
Как видите, сценарий определяет функцию с именем add, а затем пытается вызвать ее с неправильным именем. Эта ситуация приводит к фатальной ошибке:
Fatal error: Uncaught Error: Call to undefined function sum() in F:\xampp\htdocs\test.php:7 Stack trace: #0 {main} thrown in <path> on line 7
Все, что нужно для решения ошибки, — это изменить вызов функции на правильное имя, добавить:
echo '2 + 2 is ' . add(2, 2);
Предупреждение об ошибках
Предупреждающие ошибки — это ошибки, которые не приводят к завершению работы скрипта. Подобно тому, что происходит на других языках, предупреждение в PHP обычно представляет собой что-то, что еще не является серьезной проблемой — или, по крайней мере, не критичной, — но может стать серьезной проблемой в будущем, поэтому вам лучше сохранить глаз на это.
Взгляните на следующий код:
<?php $components = parse_url(); var_dump($components); ?>
После выполнения приведенного выше кода мы получаем следующее предупреждение:
Warning: parse_url() expects at least 1 parameter, 0 given in <path> on line 2
Предупреждение вызывает тот факт, что мы не предоставили параметр функции parse_url. Давайте исправим это:
<?php $components = parse_url('https://example.com'); var_dump($components); ?>
Это устраняет предупреждение:
array(2) { ["scheme"]=> string(5) "https" ["host"]=> string(11) "example.com" }
Уведомление об ошибках
Уведомления об ошибках похожи на предупреждения в том, что они также не останавливают выполнение скрипта. Вы также должны думать об ошибках уведомления как о том, что PHP предупреждает вас о том, что может стать проблемой в будущем. Однако уведомления обычно считаются менее важными или менее важными, чем предупреждения.
Рассмотрим следующий фрагмент кода, который представляет собой измененную версию сценария, использованного в предыдущих разделах:
<?php $numbers = "1,2,5,6"; $parts = explode(",", $integers); echo 'The first number is ' . $parts[0]; ?>
Как видите, сценарий определяет переменную $ numbers, а затем пытается передать переменную с именем $ inteers в функцию explode.
Неопределенные переменные действительно являются одной из основных причин уведомлений в PHP. Чтобы ошибка исчезла, достаточно изменить переменную $ inteers на $ numbers.
Как включить отчеты об ошибках в PHP
Включить отчеты об ошибках в PHP очень просто. Вы просто вызываете функцию в своем скрипте:
<?php error_reporting(E_ALL); //You can also report all errors by using -1 error_reporting(-1); //If you are feeling old school ini_set('error_reporting', E_ALL); ?>
Здесь сказано: «Пожалуйста, сообщайте об ошибках всех уровней». Мы рассмотрим, какие уровни есть позже, но считаем это категорией ошибок. По сути, он говорит: «Сообщайте обо всех категориях ошибок». Вы можете отключить отчет об ошибках, установив 0:
<?php error_reporting(0); ?>
Параметр метода в error_reporting()действительности является битовой маской. Вы можете указать в нем различные комбинации уровней ошибок, используя эту маску, как видите:
<?php error_reporting(E_ERROR | E_WARNING | E_PARSE); ?>
В нем говорится: «сообщать о фатальных ошибках, предупреждениях и ошибках синтаксического анализатора». Вы можете просто разделить их знаком «|» чтобы добавить больше ошибок. Иногда вам могут потребоваться более расширенные настройки отчетов об ошибках. Вы можете использовать операторы битовой маски для составления отчетов по различным критериям:
<?php // Report all errors except E_NOTICE error_reporting(E_ALL & ~E_NOTICE); ?>
Как видите, вы можете гибко определять, о каких ошибках сообщать. Возникает вопрос: о каких типах ошибок и исключений следует сообщать?
Сколько уровней ошибок доступно в PHP?
В PHP 5 целых 16 уровней ошибок. Эти ошибки представляют категорию, а иногда и серьезность ошибки в PHP. Их много, но многочисленные категории позволяют легко определить, где отлаживать ошибку, исходя только из ее уровня. Итак, если вы хотите сделать что-то конкретное только для ошибок пользователя, например, проверку ввода, вы можете определить обработчик условий для всего, что начинается с E_USER. Если вы хотите убедиться, что вы закрыли ресурс, вы можете сделать это, указав на ошибки, оканчивающиеся на _ERROR.
Ошибки в PHP по большей части классифицируются по степени серьезности (предупреждение об ошибке, уведомление) и источнику (пользователь, компилятор, среда выполнения).
Я хочу остановиться на нескольких популярных из них.
Во-первых, у нас есть общие ошибки:
- E_ERROR (значение 1): это типичная фатальная ошибка. Если вы видите этого плохого парня, ваше приложение готово. Перезагрузите и попробуйте еще раз.
- E_WARNING (2): это ошибки, которые не приводят к сбою вашего приложения. Похоже, что большинство ошибок находятся на этом уровне.
Далее у нас есть пользовательские ошибки:
- E_USER_ERROR (256): созданная пользователем версия указанной выше фатальной ошибки. Это часто создается с помощью trigger_error ().
- E_USER_NOTICE (1024): созданная пользователем версия информационного события. Обычно это не оказывает неблагоприятного воздействия на приложение, как и log.info ().
Последняя категория, на которую следует обратить внимание, — это ошибки жизненного цикла приложения, обычно с «core» или «compile» в названии:
- EE_CORE_ERROR (16): Подобно фатальным ошибкам выше, эта ошибка может возникнуть только при запуске приложения PHP.
- EE_COMPILE_WARNING (128): нефатальная ошибка, которая возникает только тогда, когда скрипт PHP не компилируется.
Есть еще несколько ошибок. Вы можете найти их полный список здесь.
Ошибки отображения PHP
Отображение сообщений об ошибках в PHP часто сбивает с толку. Просто погуглите «Отображение сообщения об ошибке PHP» и посмотрите. Почему так?
В PHP вы можете решить, отображать ли ошибки или нет. Это отличается от сообщения о них. Сообщение о них гарантирует, что ошибки не будут проглочены. Но отображение их покажет их пользователю. Вы можете настроить отображение всех ошибок PHP с помощью директив display_errors и display_startup_errors:
<?php ini_set('display_errors', 1); ini_set('display_startup_errors', 1); ?>
Их включение гарантирует, что они будут отображаться в теле веб-ответа пользователю. Обычно рекомендуется отключать их в среде, не связанной с разработкой. Целочисленный параметр метода также является битовой маской, как в error_reporting(). Здесь также применяются те же правила и параметры для этого параметра.
Что такое предупреждение PHP?
Выше вы заметили, что одним из уровней ошибок является E_WARNING. Вы также могли заметить, что многие уровни ошибок имеют версии предупреждений. Я хочу немного в этом разобраться. Основное различие между предупреждением и ошибкой в PHP заключается в том, завершает ли оно приложение. В PHP большинство ошибок фактически не останавливают выполнение скрипта.
Вот пример:
<?php $x = 1; trigger_error("user warning!", E_USER_WARNING); $x = 3; echo "$x is ${$x}"; ?>
Вы все равно будете видеть, $x is 3несмотря на срабатывание предупреждения. Это может быть полезно, если вы хотите собрать список ошибок проверки. Я лично предпочитаю использовать исключения в наши дни, но ваш опыт может отличаться.
Конечно, вы можете настроить отображение предупреждений PHP или нет. Для этого вы должны использовать конфигурацию display_errors, которую вы видели в предыдущем разделе.
Как помогают отчеты о сбоях
PHP упрощает настройку внешних инструментов отчетов об ошибках, подобных тем, которые предлагает Raygun. Он предоставляет несколько различных ловушек для своей среды выполнения, чтобы обрабатывать ошибки и отправлять их по сети. См. Этот пример, взятый со страницы PHP Raygun :
namespace { // paste your 'requires' statement $client = new \Raygun4php\RaygunClient("apikey for your application"); function error_handler($errno, $errstr, $errfile, $errline ) { global $client; $client->SendError($errno, $errstr, $errfile, $errline); } function exception_handler($exception) { global $client; $client->SendException($exception); } set_exception_handler('exception_handler'); set_error_handler("error_handler"); }
Сначала мы объявляем клиента, используя ключ API для безопасности:
$client = new \Raygun4php\RaygunClient("apikey for your application");
Затем мы создаем пару функций, которые обрабатывают наши ошибки и исключения:
function error_handler($errno, $errstr, $errfile, $errline ) { global $client; $client->SendError($errno, $errstr, $errfile, $errline); } function exception_handler($exception) { global $client; $client->SendException($exception); }
Обратите внимание, что мы вызываем SendError()функцию, передавая некоторые важные сведения о структуре данных ошибки. Это сделает удаленный вызов Raygun.
Наконец, мы подключаем их к среде выполнения PHP, глобально обрабатывая как традиционные ошибки, так и новые исключения:
set_exception_handler('exception_handler'); set_error_handler("error_handler");
Вот и все. Имея все это на месте, мы можем получить красиво отформатированный отчет об ошибках, который может выглядеть следующим образом:
Завершение отчета об ошибках PHP
Как видите, отчеты об ошибках PHP просты. Вы можете инициировать исключения с помощью специальных функций. Вы также можете запускать исключения, как и в других типизированных языках.
Также вы можете легко подключить свои собственные обработчики и управлять отчетностью и отображением ошибок. Это позволяет нам подключить инструмент Raygun без особых усилий — не стесняйтесь подписаться на пробную версию Raygun и добавить ее в свое приложение за считанные минуты.