Как включить отображение ошибок в PHP

1. Быстрый способ включить ошибки

Когда вы работаете над проектом, важно видеть ошибки для быстрого их устранения. Используйте следующий код для включения ошибок. Этот подход отлично подходит для разработки, но помните: оставлять включенные ошибки на рабочем сервере небезопасно.

Этот код включает:

  • Отображение всех ошибок, предупреждений и уведомлений;
  • Показ ошибок, возникающих на этапе запуска PHP.
PHP 
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

Примечание: Этот метод не отображает синтаксические ошибки (например, забытая точка с запятой). Для их устранения придется работать через настройки php.ini или .htaccess.

2. Включение ошибок через php.ini

Если вы не видите ошибок даже после использования ini_set, проверьте настройки вашего php.ini файла. Это основной файл конфигурации PHP. Добавьте в него следующие строки:

PHP.INI 
display_errors = on
error_reporting = E_ALL

Чтобы найти ваш php.ini, выполните функцию phpinfo() в файле PHP. В результатах найдите строку Loaded Configuration File.

Совет: После внесения изменений перезапустите сервер, чтобы настройки применились.

3. Включение ошибок через .htaccess

Иногда хостинг-провайдеры не дают доступа к php.ini, но позволяют использовать файл .htaccess. Добавьте туда следующие строки:

.HTACCESS 
php_flag display_errors on
php_flag display_startup_errors on

Файл .htaccess должен находиться в корневой директории вашего сайта или в папке с проектом. Обратите внимание, что не все серверы поддерживают эти директивы.

Примечание: Если ошибки не отображаются, возможно, настройки сервера не позволяют изменять php.ini через .htaccess. Обратитесь к администратору сервера.

4. Настройка отчета об ошибках

Функция error_reporting позволяет разработчику выбирать, какие именно типы ошибок будут отображаться. Например:

  • E_ERROR — критические ошибки, которые приводят к завершению выполнения скрипта;
  • E_WARNING — предупреждения, которые не останавливают выполнение скрипта;
  • E_NOTICE — уведомления, например, об использовании необъявленных переменных;
  • E_ALL — все возможные типы ошибок и предупреждений.

Пример настройки для отображения только предупреждений:

PHP 
error_reporting(E_WARNING);

Чтобы скрыть уведомления, но показывать остальные ошибки:

PHP 
error_reporting(E_ALL & ~E_NOTICE);

Использование символа & ~ позволяет исключить определенные типы ошибок из отображения.

5. Логирование ошибок в файл

На рабочих серверах не рекомендуется отображать ошибки пользователям. Вместо этого их можно записывать в журнал (лог). Для этого используйте функцию error_log. Она принимает до четырех параметров:

  1. Сообщение об ошибке;
  2. Тип логирования (0 — стандартный лог, 1 — отправка на email, 3 — запись в файл);
  3. Файл для записи (для типа 3);
  4. Дополнительные заголовки (опционально).

Пример записи ошибки в файл:

PHP 
error_log("Ошибка: файл не найден", 3, "logs/errors.log");

Убедитесь, что путь к файлу logs/errors.log доступен для записи.

Для отправки ошибок на email:

PHP 
error_log("Критическая ошибка!", 1, "admin@example.com");

Важно: Для работы этой функции необходимо настроить параметры SMTP в php.ini.

6. Отключение ошибок

Иногда нужно полностью отключить отображение ошибок (например, для защиты от утечки данных в рабочей среде). Используйте следующий код:

PHP 
error_reporting(0);
        ini_set('display_errors', 0);

Примечание: Логирование ошибок можно оставить включенным для анализа, даже если они не отображаются в браузере.

7. Проверка конфигурации PHP

Иногда важно проверить текущие настройки PHP, включая путь к загруженному файлу конфигурации php.ini. Для этого используйте функцию phpinfo(). Она выводит всю информацию о текущей конфигурации PHP, включая:

  • Загруженный файл конфигурации (Loaded Configuration File);
  • Установленные модули и их версии;
  • Доступные директивы и их значения.

Пример:

PHP 
phpinfo();

Совет: Никогда не оставляйте этот файл доступным на сервере, так как он содержит много конфиденциальной информации о вашем окружении.

8. Отображение только критичных ошибок

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

PHP 
error_reporting(E_ERROR);

Вы также можете комбинировать параметры, например:

PHP 
error_reporting(E_ERROR | E_PARSE);

В этом случае будут отображаться только критичные ошибки и ошибки синтаксиса.

9. Настройка журнала ошибок через сервер

На уровне сервера можно задать путь к файлу журнала ошибок. Например, для Apache используйте следующую директиву:

APACHE 
ErrorLog "/var/log/apache2/errors.log"

Для Nginx аналогичная директива:

NGINX 
error_log /var/log/nginx/errors.log;

Убедитесь, что файл журнала доступен для записи. Эти настройки особенно полезны для отладки на сервере.

10. Уведомления о критичных ошибках на email

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

PHP 
error_log("Критическая ошибка!", 1, "admin@example.com");

Перед использованием убедитесь, что в php.ini настроены параметры SMTP:

  • SMTP — адрес SMTP-сервера;
  • smtp_port — порт SMTP;
  • sendmail_from — адрес отправителя.

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

11. Обработка ошибок через исключения

PHP поддерживает механизм исключений, который позволяет перехватывать и обрабатывать ошибки в блоках try/catch. Это полезно для управления ошибками на уровне логики приложения.

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

PHP 
try {
    // Код, который может вызвать исключение
    if (!file_exists("example.txt")) {
        throw new Exception("Файл не найден");
    }
    echo "Файл найден!";
} catch (Exception $e) {
    // Обработка ошибки
    echo "Ошибка: " . $e->getMessage();
}

Здесь метод throw создает исключение, а блок catch перехватывает его и обрабатывает.

Совет: Используйте исключения для управления ошибками в логике, а не для стандартных ошибок, которые лучше обрабатывать через error_reporting.

12. Создание пользовательских исключений

Вы можете создавать собственные классы исключений, чтобы лучше структурировать обработку ошибок в сложных проектах. Вот пример:

PHP 
class MyCustomException extends Exception {
    public function customMessage() {
        return "Ошибка в строке {$this->getLine()} файла {$this->getFile()}: {$this->getMessage()}";
    }
}

try {
    // Код, который вызывает исключение
    throw new MyCustomException("Произошла ошибка");
} catch (MyCustomException $e) {
    // Обработка пользовательского исключения
    echo $e->customMessage();
}

Такой подход упрощает отладку и делает обработку ошибок более структурированной.

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

13. Перехват фатальных ошибок

Фатальные ошибки обычно завершают выполнение скрипта. Однако их можно перехватить с помощью функции register_shutdown_function. Пример:

PHP 
register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && ($error["type"] === E_ERROR || $error["type"] === E_PARSE)) {
        echo "Фатальная ошибка: {$error['message']}";
    }
});

Эта функция регистрирует колбэк, который выполняется при завершении работы скрипта, позволяя обработать последние ошибки.

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

14. Использование пользовательского обработчика ошибок

Вы можете переопределить стандартное поведение PHP для обработки ошибок с помощью функции set_error_handler. Пример:

PHP 
function customErrorHandler($errno, $errstr, $errfile, $errline) {
    echo "Ошибка [{$errno}] в файле {$errfile} на строке {$errline}: {$errstr}";
    // Вы можете логировать или обрабатывать ошибку
    return true; // Предотвращает выполнение стандартного обработчика
}

set_error_handler("customErrorHandler");

// Пример ошибки
echo $undefined_variable;

Этот код позволяет вам настроить индивидуальную обработку ошибок, подходящую для вашего приложения.

Совет: Используйте set_error_handler для создания гибкой системы обработки ошибок в ваших проектах.