Обработка ошибок в Nginx и страницы ошибок


Обработка ошибок в Nginx иногда требуется когда нужно менять код ответа или выполнять определенный скрипт при определенном коде HTTP коде, отдаваемом веб-сервером.

Ниже приведём фрагмент конфигурационного файла, позволяющий это делать.



Обработка ошибок в Nginx


Ошибки обрабатываются за счёт директивы error_page.

Её первый аргумент — код ошибки. Далее через знак равно идёт инструкция с указанием что делать дальше.

В приведенном ниже файле для кода 404 заменяется ответ на 200 ОК и потом запрос передаётся для обработки PHP скрипту.



Принципиальна в файле одна строка error_page 404 =200 /err_404.php;



За счет нее для всех запросов, заканчивающихся ошибкой 404 будет меняться код ответа сервера на 200. Затем запросы будут переадресовываться в блок err_404.php и там обрабатываться в соответствии с заданными правилами.


В блоке в данном случае настроено проксирование в php-fpm. Но могут быть заданы любые другие правила.


server {
    listen 443 ssl http2;

    server_name example.com www.example.com;

    root /var/www/web/sites/example.com;

    index index.html index.htm index.php;

    ssl_certificate /etc/nginx/ssl/example.com.full.crt;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES256-SHA384;
    ssl_ecdh_curve secp384r1;
    error_page 404 =200 /err_404.php;



location = /err_404.php {
root /var/www/web/sites/example.com;
try_files      $uri $uri/;
fastcgi_pass   127.0.0.1:9001;
fastcgi_index  err_404.php;
include        fastcgi_params;
fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_ignore_client_abort off;

}
   location ~ .php$ {
        try_files      $uri $uri/ =404;
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_index  index.php;
        include        fastcgi_params;
        fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_ignore_client_abort off;

    }

    location ~ /\.ht {
        deny all;
    }

    location = /favicon.ico {
        log_not_found off;
        access_log off;
    }

    location = /robots.txt {
        allow all;
        log_not_found off;
        access_log off;
    }

    location @error {
    return 500;
    }

}


Как проверить работают ли настройки определяющие страницы ошибок Nginx и обрабатывающие запросы


Запросы и ответы изначально и после настроек можно увидеть в логе доступа веб-сервера. Стандартный путь к нему — /var/log/nginx/access.log. Также лог может задаваться индивидуально для каждого сайта.



Пример лога с кодами ответа 404:

Обработка ошибок в Nginx


Можно выполнить определенный запрос, проверить код ответа и результат, потом задать настройки и выполнить тот же запрос ещё раз оценив результат.

После сохранения конфигурационных файлов нужно перезапускать веб-сервер.



Код ответа и правила обработки запроса можно проверить обратившись в терминале к сайту при помощь curl.

curl -I https://example.com



С ключом -I будет отправлен запрос типа head, будут запрошены только заголовки. В ответе можно будет видеть код 404, 200, переадресацию или результат выполнения другихх заданных правил.

Использование curl предпочтительнее проверки в браузере потому что исключается кэширование браузера.



Также код ответа будет видно в консоли разработчика браузера.



Читайте про настройку работы Nignx с PHP-FPM

Сказать спасибо