Сайт на PHP недоступен: пошаговый чек-лист диагностики
Если сайт перестал открываться, начните с одного запроса к проблемной странице и запишите, где он остановился. Ошибка DNS, тайм-аут соединения и ответ 502 ведут к разным проверкам. Этот чек-лист поможет локализовать сбой до перезапуска служб или отката релиза.
1. Зафиксируйте симптом и масштаб сбоя
Запишите домен, путь, время с часовым поясом, HTTP-статус и идентификатор запроса, если сервер его вернул. Проверьте проблемную страницу из другой сети. Если сбой проявляется только после входа или отправки формы, обычный запрос к главной может вернуть 200, пока нужный сценарий падает. При повторной проверке используйте безопасный запрос, который не создаёт записи и не повторяет платежи.
| Симптом | С чего начать |
|---|---|
| Имя не разрешается | DNS и делегирование домена |
| Тайм-аут соединения или отказ | Сеть, порт, правила доступа и служба на порту |
| Ошибка сертификата | Имя в сертификате, срок действия, цепочка и точка завершения TLS |
| 404 или 403 | Виртуальный хост, корень сайта, маршрутизация и права доступа |
| 500 | Журнал приложения и ошибки PHP за время запроса |
| 502, 503 или 504 | Журнал прокси, состояние upstream и время ожидания ответа |
Код ответа задаёт направление поиска. Если перед приложением стоят CDN и балансировщик, выясните, какой слой сформировал ответ. Ошибка 502 может прийти от CDN при недоступном origin или от Nginx при проблеме с PHP-FPM.
2. Проверьте DNS, соединение и TLS
Сравните записи A и AAAA с ожидаемыми адресами публичной точки входа. Если используется CDN, публичный DNS обычно указывает на CDN. Сравните ответ резолвера, на котором виден сбой, с ответом авторитетного сервера зоны. При NXDOMAIN проверьте имя, наличие записи и делегирование. При SERVFAIL проверьте доступность серверов зоны и, если включён DNSSEC, согласованность DS и DNSKEY. Если часть клиентов получает старый адрес после миграции, учтите TTL. Если сбой виден только по IPv6, проверьте, обслуживает ли новый сервер опубликованный адрес AAAA.
site_host=example.test
# Подставьте домен и IP проверяемой точки входа.
entry_ip=192.0.2.10
dig "$site_host" A +noall +comments +answer
dig "$site_host" AAAA +noall +comments +answer
# Обходим DNS, сохраняя имя хоста для HTTP и TLS.
curl -sS -D - -o /dev/null --connect-timeout 5 --max-time 15 \
--proto-default https --resolve "$site_host:443:$entry_ip" "$site_host"Успешный запрос с --resolve показывает, что конкретный IP отвечает на запрос с нужным именем. Если обычный запрос падает, сравните адреса, на которые реально попадает клиент, включая IPv6. Прямой тест origin имеет смысл, если он принимает соединения из вашей сети. При ошибке TLS проверьте сертификат на том узле, который видит клиент. Сохраните проверку сертификата включённой, чтобы тест выявлял проблемы с именем и цепочкой.
3. Проверьте веб-сервер и виртуальный хост
Убедитесь, что ожидаемый процесс слушает нужный порт. На сервере за балансировщиком ориентируйтесь на порт, указанный в конфигурации upstream. В контейнерной схеме проверяйте сокеты и порты в сетевом окружении соответствующего контейнера.
# Пример для Nginx на Linux с systemd.
sudo ss -ltnp '( sport = :80 or sport = :443 )'
sudo systemctl status nginx --no-pager
sudo nginx -t
sudo journalctl -u nginx --since '15 minutes ago' --no-pagerДля Apache используйте apachectl configtest и apachectl -S. Проверьте, что запрос попадает в нужный виртуальный хост, корень сайта указывает на каталог входной точки приложения, а процесс может читать файлы и проходить по родительским каталогам. Сопоставьте запрос с access log и error log, заданными в конфигурации. Проверка синтаксиса показывает, что конфигурацию можно прочитать, а её фактическую работу подтверждает запрос.
Сравните ответ на заведомо существующий статический файл, который веб-сервер отдаёт напрямую, и на PHP-страницу. Если файл отдаётся, а PHP-запрос падает, проверьте передачу запроса в FPM и запуск приложения. При CDN выполняйте сравнение на origin или убедитесь, что статический ответ получен без участия кэша.
4. Проверьте PHP-FPM и запуск приложения
Сверьте fastcgi_pass в Nginx или адрес FastCGI в Apache с параметром listen нужного пула. Для Unix-сокета проверьте, что он существует и доступен пользователю веб-сервера. Для TCP проверьте адрес, порт и сетевую доступность из окружения веб-сервера. После обновления PHP конфигурация хоста может по-прежнему указывать на сокет старого пула.
# Подставьте имя установленной службы PHP-FPM.
fpm_unit=php8.5-fpm
sudo systemctl status "$fpm_unit" --no-pager
sudo journalctl -u "$fpm_unit" --since '15 minutes ago' --no-pagerПри отказе соединения проверьте, поднялся ли пул и слушает ли он указанный адрес. При ошибке прав доступа проверьте владельца и режим сокета, права родительских каталогов и ограничения SELinux или AppArmor, если они действуют. Сообщение Primary script unknown ведёт к проверке SCRIPT_FILENAME и наличия файла в окружении FPM. При 504 и предупреждениях о достижении pm.max_children выясните, чем заняты воркеры. Используйте настроенный slowlog FPM и метрики времени запросов. Увеличение числа воркеров требует запаса памяти и может усилить нагрузку на базу.
После релиза проверьте версию PHP и расширения именно в FPM. Вывод php -v относится к CLI, у которого могут быть другой бинарник и другой файл настроек. При переходе между PHP 8.3, 8.4 и 8.5 сверяйте требования Composer с окружением приложения. Убедитесь, что артефакт содержит зависимости, обновлены необходимые кэши и выполнены совместимые миграции. В production держите display_errors выключенным, а log_errors включённым. Проверьте, что ошибки действительно попадают в журнал.
5. Проверьте базу данных из окружения приложения
Проверяйте соединение из контейнера или хоста PHP с теми же настройками подключения, что использует приложение. Успешный вход в базу с ноутбука подтверждает доступность только с ноутбука. Разберите ошибку по этапам. Тайм-аут соединения ведёт к проверке сети и адреса. Ошибка аутентификации указывает на учётные данные или правила доступа. Ошибка уже после подключения может быть связана со схемой, блокировками или перегрузкой.
Для короткой проверки PDO можно выполнить запрос SELECT 1. Пример рассчитан на CLI внутри окружения приложения, где уже переданы DB_DSN, DB_USER и DB_PASSWORD и установлен нужный драйвер PDO. Используйте действующие настройки TLS и тайм-аутов приложения, если они передаются отдельно.
<?php
declare(strict_types=1);
$dsn = getenv('DB_DSN');
$user = getenv('DB_USER');
$password = getenv('DB_PASSWORD');
if ($dsn === false || $dsn === '' || $user === false || $password === false) {
fwrite(STDERR, "Отсутствуют настройки подключения\n");
exit(2);
}
try {
$pdo = new PDO($dsn, $user, $password, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
$pdo->query('SELECT 1')->fetchColumn();
echo "База отвечает\n";
} catch (PDOException $error) {
// Выводим только код, без DSN и текста ошибки драйвера.
fwrite(STDERR, 'Ошибка PDO, код ' . $error->getCode() . PHP_EOL);
exit(1);
}Если запрос проходит, проверьте схему и права на таблицы, которые использует проблемный маршрут. При медленных ответах сопоставьте время запроса с активными соединениями, блокировками и журналом медленных запросов. Если после выкладки не хватает таблицы или колонки, сверьте миграции и совместимость схемы со старой версией приложения перед откатом.
6. Проверьте диск, inode и память
Приложение может начать возвращать 500 из-за невозможности записать сессию, кэш или временный файл. Свободные гигабайты сами по себе не гарантируют запись. Файловая система может исчерпать inode, упереться в квоту или перейти в режим только для чтения. Проверяйте конкретные тома с данными приложения, логами и базой. В контейнерной среде учитывайте смонтированные тома и диск хоста.
# Замените /srv/app на фактический каталог приложения.
df -h /srv/app /var/log /tmp
df -i /srv/app /var/log /tmp
findmnt -T /srv/app
sudo journalctl -k --since '30 minutes ago' --no-pagerВ журнале ядра ищите ошибки ввода-вывода, перемонтирование файловой системы и события OOM. При контейнерном лимите памяти смотрите также причину завершения процесса или контейнера. Если FPM периодически исчезает под нагрузкой, сопоставьте перезапуски с этими событиями. При переполнении диска найдите растущий каталог и освободите место средствами штатной ротации или перенесите подтверждённые временные файлы. Сохраните журналы за период сбоя.
7. Соберите цепочку по логам и подтвердите восстановление
Возьмите запрос из первого шага и сопоставьте записи CDN или балансировщика, веб-сервера, FPM и приложения по идентификатору запроса. Если общего идентификатора нет, используйте время с часовым поясом, метод и путь. Проследите запрос до первого слоя, который зафиксировал ошибку или перестал отвечать. Сверьте этот момент с последним релизом, обновлением сертификата, переключением DNS и событиями инфраструктуры.
- Запишите внешний симптом и определите, затронут ли весь сайт или один сценарий.
- Проверьте DNS, соединение и TLS до нужной точки входа.
- Сравните статический и динамический ответы и найдите запрос в журнале веб-сервера.
- Проверьте upstream, сокет FPM, запуск приложения, доступ к базе и состояние томов.
- Примените исправление к слою, на котором обнаружили причину. После изменения конфигурации проверьте её синтаксис перед перезагрузкой службы.
- Повторите исходный сценарий снаружи. Проверьте статус, ожидаемое содержимое и нужное действие приложения. Убедитесь по журналам и метрикам, что ошибки и тайм-ауты перестали повторяться.
Частые вопросы
Почему статический файл открывается, а PHP-страница возвращает 502?
Проверьте журнал прокси за время запроса и сопоставьте адрес FastCGI с параметром listen нужного пула. Частые причины включают остановку PHP-FPM, смену пути к сокету после обновления и отсутствие доступа к сокету у веб-сервера. Если ответ сформировал CDN, сначала проверьте его соединение с origin.
Что проверять, если база отвечает, а сайт возвращает 504?
Проверьте занятость воркеров FPM и длительность обработки конкретного маршрута. Простой запрос к базе подтверждает соединение, а задержку могут создавать блокировки, тяжёлый запрос, ожидание внешнего API или очередь перед пулом.
Почему сайт открылся после перезапуска, но снова упал?
Перезапуск может временно освободить воркеры, память или соединения. Сопоставьте оба сбоя с логами FPM, событиями OOM, заполнением диска и метриками базы. После исправления повторите исходный сценарий и проверьте поведение сайта под обычной нагрузкой.