Calitatea hostingului dă valoare site-ului tău.

PHP și administrare · Ghid practic

PHP-FPM saturat: cum găsești blocajul fără să mărești limitele la întâmplare

Un site PHP care răspunde greu poate avea pool-ul PHP-FPM ocupat, cozi de cereri sau procese blocate. Ghidul explică ce măsori, cum corelezi statusul și logurile și când are sens să schimbi configurația.

Înțelege ce spune statusul pool-ului

PHP-FPM împarte lucrul între procese copil care preiau cererile FastCGI. Valoarea `pm.max_children` limitează numărul acestora, deci o limită atinsă poate crea o coadă și poate crește timpul de răspuns. Nu înseamnă automat că aplicația are nevoie de mai mulți copii: fiecare proces consumă memorie, iar un număr prea mare poate epuiza memoria serverului.

Dacă mediul permite, activează pagina de stare FPM pentru utilizare administrativă și protejeaz-o de accesul public. Urmărește procesele active și idle, lungimea maximă a cozii, numărul de conexiuni acceptate și indicatorul „max children reached”. Înregistrează aceste valori în timpul perioadei cu probleme, deoarece un instantaneu după ce traficul a scăzut poate ascunde blocajul.

Notează și resursele serverului în același interval: RAM disponibilă, swap, CPU, load și activitatea discului. Dacă FPM are mulți copii activi, dar CPU-ul este redus, cererile pot aștepta baza de date ori o interfață externă. Creșterea proceselor în acel caz poate intensifica presiunea asupra dependenței lente.

Localizează cererile lente și cauza lor

Configurează temporar slowlog-ul FPM cu un prag care surprinde cereri anormal de lungi, nu fiecare solicitare obișnuită. Un backtrace poate arăta funcția PHP activă când cererea a depășit pragul. Corelează linia cu ora și ruta din logul web, apoi verifică dacă blocajul vine dintr-o interogare SQL, un apel HTTP, un proces de generare sau un plugin al aplicației.

Folosește slow query log-ul bazei de date când există indicii de așteptare SQL și verifică planul interogărilor înainte de optimizare. Pentru apeluri către servicii externe, înregistrează durata și timeout-ul, cu grijă să nu pui tokenuri sau date sensibile în log. Repetă observația după o singură schimbare, astfel încât efectul ei să fie măsurabil.

Un timeout de la proxy și un timeout PHP pot avea limite diferite. Compară setările serverului web, FPM și aplicației. Dacă gateway-ul renunță înainte ca scriptul să termine, vizitatorul primește eroare chiar dacă procesul încă ocupă un copil FPM.

Ajustează pool-ul după măsurători

Modurile `static`, `dynamic` și `ondemand` controlează cum sunt pornite și păstrate procesele. `dynamic` păstrează un interval de procese libere, iar `ondemand` pornește procese la cerere și le elimină după inactivitate; niciun mod nu este potrivit automat pentru toate site-urile. Compară latența de pornire, memoria și profilul traficului înainte să alegi.

Calculează limita de copii având în vedere memoria totală disponibilă pentru sistem, web server, baza de date și alte pool-uri. Măsoară memoria rezidentă a proceselor în sarcini reprezentative și păstrează rezervă pentru vârfuri. Dacă procesele cresc în memorie pe termen lung, `pm.max_requests` poate recicla lucrătorii periodic, dar nu repară o scurgere din extensie sau aplicație.

După schimbare, urmărește aceleași măsurători: coadă, latențe, memorie, erori și procese terminate. Păstrează configurația precedentă și validează sintaxa înainte de reload. Dacă simptomele persistă, revino la investigația aplicației și a dependențelor în loc să mărești succesiv toate timeout-urile.

Checklist pentru următoarea apariție

Păstrează ora exactă, URL-ul afectat, statusul HTTP, mesajul din log și dacă problema afectează toate paginile sau numai o rută. Notează și ce s-a schimbat recent: deploy, plugin, import, campanie sau volum de comenzi. Aceste informații reduc riscul de a confunda o limită tehnică cu o regresie de aplicație.

Pagina de status și backtrace-urile pot conține informații interne, așa că limitează accesul și perioada de păstrare. După încheierea diagnosticului, dezactivează endpointurile temporare ori restricționează-le corespunzător și arhivează doar logurile necesare.

Întrebări frecvente

Ce înseamnă „max children reached”?

Pool-ul a atins plafonul de procese copil și alte cereri pot aștepta. Verifică durata cererilor și memoria înainte să mărești limita.

Este bine să cresc pm.max_children?

Numai dacă există memorie disponibilă și cererile sunt limitate de capacitatea pool-ului. Dacă fiecare proces așteaptă o bază de date lentă, mai mulți copii pot amplifica blocajul.

Pot lăsa pagina de status publică?

Nu este recomandat. Protejeaz-o prin acces administrativ sau rețea internă, fiindcă expune starea proceselor și a cererilor.

Surse și documentare

Explicație editorială generală, bazată pe documentația de mai jos. Configurația concretă și condițiile furnizorului pot diferi. Documentare: 22 noiembrie 2026.