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 ограничивает число дочерних процессов пула. Каждый воркер обрабатывает один запрос за раз. При заполнении пула новые подключения могут ждать в очереди, а повышение лимита увеличивает потребление памяти и число одновременных обращений к базе.
- Определите бюджет памяти FPM. Для контейнера исходите из его лимита. На общем сервере вычтите память nginx, базы, агентов и других сервисов. Оставьте запас на пики и перезапуск.
- Измерьте воркеры после прогрева на типичных и тяжёлых маршрутах. На Linux полезен PSS из
/proc/<pid>/smaps_rollup: он учитывает долю общей памяти процесса. Простое сложение RSS повторно учитывает общие страницы. Для оценки прироста можно сравнить суммарную память FPM при двух уровнях параллелизма на одинаковом профиле запросов. - Выберите начальный потолок и проверьте его под нагрузкой. Например, если из 1 280 МиБ бюджета FPM после вычета общей и постоянной памяти осталось 1 120 МиБ, а дополнительный прогретый воркер требует около 70 МиБ, расчёт даёт 16 процессов. Начните ниже, если тяжёлые запросы заметно увеличивают расход памяти.
Пример настроек существующего пула с режимом dynamic для этого расчёта:
; Потолок рассчитан для этого пула и проверяется под нагрузкой
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-файлов.
; Пример стартовой конфигурации для 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 поиска или другого дорогого маршрута. Значения ниже иллюстративные. Рабочий порог зависит от обычного поведения клиентов и ёмкости сервиса.
# В контексте 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 и памяти, объёму базы и настройкам кеша. Подготовьте смесь маршрутов из журналов: публичные страницы, поиск, авторизованные чтения и, если они влияют на нагрузку, операции записи на тестовых данных. Исключите реальные платежи, письма и другие внешние действия тестовых запросов.
- Снимите исходный профиль. Прогрейте приложение, поднимайте интенсивность ступенями и выдерживайте каждую ступень, чтобы увидеть накопление очереди.
- Запишите поданную и фактически обработанную частоту запросов, p95 и p99 задержки, долю 429 и 5xx, очередь FPM, CPU, пик памяти и число активных соединений с базой. Проверьте, что генератор выдерживает заданную интенсивность: иначе часть нагрузки просто не дойдёт до сайта.
- Меняйте один параметр за прогон. Сравните результаты при одинаковой интенсивности и проверяйте, что очередь уходит после всплеска. Повторите прогоны с холодным кешем и после перезапуска 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.