PHPTime

PHP-сайт падает под нагрузкой: как найти причину и настроить PHP-FPM

После всплеска посещаемости PHP-сайт может отвечать медленно, отдавать 502 и 504 или стать недоступным. Начните с поиска узкого места: одинаковые симптомы дают заполненный пул PHP-FPM, медленная база и нехватка памяти. Затем меняйте настройки по одной и повторяйте тот же нагрузочный тест.

1. Найдите, где запросы начинают ждать

Возьмите интервал вокруг первых ошибок и сопоставьте по времени журнал nginx, метрики PHP-FPM, загрузку процессора, память и состояние базы. В access log полезно записывать $request_time, $upstream_connect_time, $upstream_header_time и $upstream_status. Они показывают полное время запроса, время подключения к upstream, ожидание его заголовков и полученный статус. Сравнивайте их по маршрутам: медленный поиск легко теряется в общей статистике за счёт быстрых ответов из кеша.

СигналЧто проверить
502 от nginxТочную ошибку в error log, доступность сокета PHP-FPM, перезапуски воркеров и события OOM.
504 от nginxНа каком этапе истёк таймаут, сколько запросов ждёт в очереди FPM, какие SQL-запросы и внешние вызовы задержались.
Растёт listen queueВсе ли воркеры заняты, есть ли запас CPU и памяти, сколько времени воркеры проводят в ожидании базы или сети.
Растёт счётчик max children reachedДостигает ли пул лимита в проблемные минуты. Смотрите прирост счётчика за интервал и сверяйте его с очередью и задержками.

Статус FPM держите во внутренней сети или за ограничением доступа. Если во время инцидента основной пул занят, выделите отдельный сокет через pm.status_listen, чтобы получать статус даже при заполненной очереди. Для поиска медленных участков включите slowlog и задайте request_slowlog_timeout по допустимой задержке приложения. Стек из slowlog помогает понять, дошёл ли запрос до PHP и где именно он задержался.

2. Рассчитайте pm.max_children по памяти и проверьте CPU

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

  1. Определите бюджет памяти FPM. Для контейнера исходите из его лимита. На общем сервере вычтите память nginx, базы, агентов и других сервисов. Оставьте запас на пики и перезапуск.
  2. Измерьте воркеры после прогрева на типичных и тяжёлых маршрутах. На Linux полезен PSS из /proc/<pid>/smaps_rollup: он учитывает долю общей памяти процесса. Простое сложение RSS повторно учитывает общие страницы. Для оценки прироста можно сравнить суммарную память FPM при двух уровнях параллелизма на одинаковом профиле запросов.
  3. Выберите начальный потолок и проверьте его под нагрузкой. Например, если из 1 280 МиБ бюджета FPM после вычета общей и постоянной памяти осталось 1 120 МиБ, а дополнительный прогретый воркер требует около 70 МиБ, расчёт даёт 16 процессов. Начните ниже, если тяжёлые запросы заметно увеличивают расход памяти.

Пример настроек существующего пула с режимом dynamic для этого расчёта:

ini
; Потолок рассчитан для этого пула и проверяется под нагрузкой
pm = dynamic
pm.max_children = 16
pm.start_servers = 4
pm.min_spare_servers = 4
pm.max_spare_servers = 8

Свободные воркеры помогают пережить короткий всплеск без ожидания запуска процессов. Если CPU уже насыщен, повышение pm.max_children часто увеличивает время ответа. Если воркеры ждут базу, проверьте лимит соединений и блокировки: увеличение пула может перенести очередь в СУБД. pm.max_requests пригодится при подтверждённом росте памяти воркеров со временем. Слишком частая ротация добавляет расходы на запуск и прогрев.

3. Включите OPcache и согласуйте его с деплоем

На PHP 8.3–8.5 OPcache хранит скомпилированный байткод в общей памяти и сокращает работу при повторном выполнении скриптов. Проверяйте настройки в окружении FPM: вывод CLI может относиться к другому набору INI-файлов.

ini
; Пример стартовой конфигурации для FPM
opcache.enable = 1
opcache.memory_consumption = 192
opcache.max_accelerated_files = 20000
; Проверяем изменения файлов с интервалом в две секунды
opcache.validate_timestamps = 1
opcache.revalidate_freq = 2

После прогрева снимите показатели из opcache_get_status(false) в защищённом окружении. Смотрите на свободную память, заполнение таблицы ключей и прирост счётчиков перезапусков. Если растёт oom_restarts, проверьте ёмкость памяти OPcache. Если растёт hash_restarts, проверьте лимит ключей и количество кешируемых файлов. Заложите общую память OPcache в бюджет FPM.

При opcache.validate_timestamps=0 деплой должен обновлять кеш во всех экземплярах, например заменяя контейнеры новой ревизией. Вызов opcache_reset() из CLI не сбрасывает кеш пула FPM. Для приложения с медленной базой или внешним API ускорение компиляции даст ограниченный эффект: время ожидания зависимостей останется.

4. Кешируйте ответы до обращения к PHP

Статику обслуживайте через nginx. Для публичных страниц с одинаковым ответом для всех посетителей используйте FastCGI-кеш nginx или кеш на CDN. При попадании в такой кеш запрос не занимает воркер PHP. Начните с конкретных маршрутов и короткого TTL. Включите fastcgi_cache_lock, чтобы на промахе один запрос заполнял кеш, пока остальные ждут в пределах настроенного таймаута.

Исключите из общего кеша личный кабинет, корзину и другие персонализированные ответы. Для запросов с авторизацией или сессионной cookie настройте и fastcgi_cache_bypass, и fastcgi_no_cache. Первая директива пропускает чтение из кеша, вторая запрещает сохранение ответа. Сохраните обработку заголовков Cache-Control и Set-Cookie. Если содержимое зависит от языка или параметров запроса, отражайте эти различия в ключе либо отключайте общий кеш для таких запросов.

При проверке прогрейте один и тот же маршрут анонимно и под двумя разными учётными записями. Проверьте тело и заголовки каждого ответа. Для диагностики можно временно вывести $upstream_cache_status и убедиться, что публичная страница переходит из MISS в HIT, а обход кеша для авторизованных запросов работает.

Для дорогих выборок, которые нужны внутри динамических страниц, подходит кеш приложения. Назначьте срок жизни, продумайте сброс после записи и ограничьте время обращения к хранилищу. Добавьте небольшой случайный разброс TTL для групп ключей, чтобы они не истекали одновременно. Отдельно проверьте поведение при холодном кеше и недоступном хранилище.

5. Ограничьте дорогие запросы на входе в nginx

limit_req позволяет ограничить частоту обращений к ресурсоёмким маршрутам до передачи запросов в FPM. Объявите зону в контексте http, а ограничение добавьте в существующий location поиска или другого дорогого маршрута. Значения ниже иллюстративные. Рабочий порог зависит от обычного поведения клиентов и ёмкости сервиса.

nginx
# В контексте http объявляем общую зону для ключей
limit_req_zone $binary_remote_addr zone=search_per_ip:10m rate=2r/s;

# В существующем location поиска допускаем короткий всплеск
limit_req zone=search_per_ip burst=5 nodelay;
limit_req_status 429;

За CDN или балансировщиком сначала настройте восстановление IP клиента от доверенных прокси. Иначе под общий лимит могут попасть все пользователи одного прокси. Даже с корректным IP учитывайте клиентов за общим NAT. Перед ограничением проверьте ожидаемые срабатывания через limit_req_dry_run.

При исчерпании соединений проверьте worker_connections и лимиты открытых файлов. Nginx расходует соединения и на клиентов, и на upstream, поэтому значение worker_connections нельзя напрямую считать ёмкостью в клиентских запросах. Согласуйте таймауты по цепочке: тяжёлую операцию желательно прервать на уровне приложения или зависимости, пока ещё можно вернуть управляемый ответ. fastcgi_read_timeout ограничивает интервал между чтениями данных от FPM. Повышение этого значения может продлить ожидание клиента, оставив причину задержки на месте.

6. Проверьте изменения нагрузочным тестом

Выполняйте тест на стенде, близком к рабочему окружению по квотам CPU и памяти, объёму базы и настройкам кеша. Подготовьте смесь маршрутов из журналов: публичные страницы, поиск, авторизованные чтения и, если они влияют на нагрузку, операции записи на тестовых данных. Исключите реальные платежи, письма и другие внешние действия тестовых запросов.

  1. Снимите исходный профиль. Прогрейте приложение, поднимайте интенсивность ступенями и выдерживайте каждую ступень, чтобы увидеть накопление очереди.
  2. Запишите поданную и фактически обработанную частоту запросов, p95 и p99 задержки, долю 429 и 5xx, очередь FPM, CPU, пик памяти и число активных соединений с базой. Проверьте, что генератор выдерживает заданную интенсивность: иначе часть нагрузки просто не дойдёт до сайта.
  3. Меняйте один параметр за прогон. Сравните результаты при одинаковой интенсивности и проверяйте, что очередь уходит после всплеска. Повторите прогоны с холодным кешем и после перезапуска FPM.

Заранее задайте допустимую задержку и долю ошибок для целевой нагрузки. Если после изменения пропускная способность выросла, но p99 или время восстановления очереди вышли за эти границы, конфигурация ещё требует настройки.

7. Чек-лист перед выпуском

  • Причина сбоя сопоставлена по времени с журналами nginx, очередью FPM и метриками зависимостей.
  • pm.max_children укладывается в бюджет памяти с запасом, а база выдерживает число одновременных запросов.
  • OPcache включён в FPM, его заполнение измерено после прогрева, а деплой обновляет байткод.
  • Публичные ответы кешируются, персонализированные проверены под разными учётными записями.
  • Лимиты nginx проверены на реальном профиле нагрузки, а таймауты согласованы между приложением и зависимостями.
  • Повторный тест прошёл на целевой нагрузке, при холодном старте и коротком пике. После выкладки те же метрики проверены на рабочем трафике.

Частые вопросы

Как понять, что достигнут предел pm.max_children?

Смотрите на статус FPM во время замедления. Если активных воркеров столько же, сколько допускает pm.max_children, одновременно растут listen queue и счётчик max children reached, пул достиг потолка. Перед увеличением лимита проверьте память, CPU и состояние базы.

Почему после увеличения pm.max_children сайт стал отвечать медленнее?

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

Чем OPcache отличается от FastCGI-кеша nginx?

OPcache хранит байткод и экономит время на компиляции PHP-скриптов. FastCGI-кеш хранит готовый ответ. При попадании в него nginx возвращает страницу без обращения к PHP-FPM.

Справка по теме

Ещё в разделе «Linux и серверы»

Горячие клавиши в PhpStorm на Linux: чиним работу в русской раскладке

Почему в PhpStorm на Linux не работают горячие клавиши в русской раскладке и как это исправить: javaagent, vmoptions, XIM, Wayland и настройки IDE.

6 мин

Поиск текста в файлах в Linux: grep, find, ripgrep и примеры для PHP-проекта

Как искать текст в файлах Linux: grep -rn, find с фильтрами по дате, ripgrep для больших проектов. Разбор на примере современного PHP-кода.

5 мин

Сайт на PHP недоступен: пошаговый чек-лист диагностики

Пошаговая диагностика недоступного PHP-сайта: проверяем DNS, TLS, веб-сервер, PHP-FPM, базу данных, свободное место и логи, чтобы найти причину сбоя.

8 мин

Google Drive в Linux: rclone, монтирование, синхронизация и бэкапы сайта

Настройка Google Drive в Linux через rclone: подключение, монтирование, синхронизация и автоматические бэкапы сайта. Практическое руководство для разработчиков.

8 мин