Вывод ошибок в PHP можно настроить разными способами в зависимости от целей — для разработки или production. Рассмотрим основные варианты включения отображения ошибок в браузере и записи их в лог.
При разработке полезно видеть на экране как можно больше информации об ошибках, чтобы быстрее исправлять код. Но в production лучше скрывать ошибки от пользователя и записывать их в отдельный файл.
Использование ini-файла
Один из самых простых способов настройки вывода ошибок и предупреждений в PHP — это использование ini-файла. В нем можно указать значения для директив display_errors и display_startup_errors. Они определяют, будут ли ошибки отображаться пользователю или нет. Также в ini-файле задается директива error_reporting, отвечающая за то, какие конкретно ошибки и предупреждения будут выводиться.
- Директива display_errors обычно выключена на рабочих сайтах, чтобы скрыть ошибки от пользователей.
- А display_startup_errors нужна для отображения ошибок инициализации PHP, на которые не влияет display_errors.
Также в ini-файле можно настроить параметры записи ошибок в лог. Это позволяет скрывать ошибки от пользователей, но при этом фиксировать их для дальнейшего анализа и исправления разработчиком.
Файл конфигурации PHP обычно называется php.ini и располагается в каталоге с установленным PHP.
Настройка в .htaccess
Файл .htaccess позволяет настроить поведение сервера Apache непосредственно для конкретного сайта или каталога. Это удобно, когда нет доступа к основной конфигурации сервера или ini-файлу PHP.
В .htaccess можно задать значения для директив display_errors и display_startup_errors, чтобы включить или отключить вывод ошибок PHP. Также поддерживается директива error_reporting для фильтрации конкретных типов ошибок и предупреждений.
Кроме того, используя .htaccess можно настроить запись ошибок и предупреждений в custom лог-файл. Для этого служит директива php_flag log_errors. В качестве пути к логу можно указать относительный путь к каталогу сайта или абсолютный.
- Преимущество настройки логирования в .htaccess в том, что не нужны права на запись в системные логи сервера.
- Но есть и недостаток — на производительность может повлиять запись в файл на диск при каждой ошибке.
Функции и триггеры
Помимо настроек на уровне ini-файла или .htaccess, в PHP есть функции для управления выводом ошибок и предупреждений во время выполнения скрипта.
Одна из таких функций — error_reporting(). Она позволяет задать, какие именно сообщения об ошибках и предупреждениях будут выводиться. Это более гибкий способ настройки по сравнению с директивой error_reporting в конфигурационных файлах.
- С помощью констант E_ERROR, E_WARNING и т.д. можно точно указать типы сообщений.
- А используя побитовые операторы & (И), | (ИЛИ), ~ (НЕ) добиться нужной комбинации.
Еще одна полезная функция — trigger_error(). Она позволяет генерировать сообщения об ошибках и предупреждениях программно, в нужных местах кода:
trigger_error(‘Ошибка при подключении к БД!’, E_USER_ERROR);
Такие сообщения можно использовать для отладки, логирования или вместо исключений в старом коде. Уровень сообщения определяет, как с ним будет обращаться PHP.
Рекомендации для production сайта
При разработке и тестировании полезно видеть все возможные ошибки и предупреждения PHP. Но на рабочем production сайте вывод сообщений об ошибках пользователям нежелателен по соображениям безопасности.
Во-первых, вывод стектрейса и другой отладочной информации может раскрыть структуру сайта злоумышленникам. А во-вторых, сообщения об ошибках портят юзер экспириенс для обычных посетителей.
Поэтому на рабочем сайте рекомендуется:
- Выключить директивы display_errors и display_startup_errors в php.ini или .htaccess;
- Оставить только критические ошибки в error_reporting — E_ERROR или E_ALL & ~E_NOTICE & ~E_WARNING;
- Настроить логирование ошибок и предупреждений в отдельный файл для анализа.
Такой подход позволит скрыть неполадки от посетителей, но при этом оперативно получать информацию для решения проблем и повышения стабильности сайта.
