همه مقالات تخصصی

صفحهٔ وضعیت PHP-FPM: ببینید pool واقعاً چقدر شلوغ است

pm.status_path و ping را در PHP-FPM فعال کنید، دسترسی را محدود کنید و از max children reached و listen queue برای تنظیم pool استفاده کنید.

صفحهٔ وضعیت PHP-FPM: ببینید pool واقعاً چقدر شلوغ است

تنظیم pm.max_children بدون داده حدس است. صفحهٔ وضعیت PHP-FPM می‌گوید چند پروسه فعال است، صف انتظار دارید یا نه و آیا pool به سقف رسیده است. این راهنما آن را امن فعال می‌کند و خروجی را تفسیر می‌کند.

۱. فعال‌سازی در pool

; /etc/php/8.3/fpm/pool.d/www.conf (نسخه را مطابق سرور تغییر دهید)
pm.status_path = /fpm-status
ping.path = /fpm-ping
ping.response = pong

پس از تغییر، سرویس PHP-FPM را reload کنید. بدون محدودیت دسترسی، این صفحه اطلاعات داخلی را فاش می‌کند.

۲. دسترسی محدود در Nginx

location = /fpm-status {
    allow 127.0.0.1;
    deny all;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $fastcgi_script_name;
    fastcgi_pass unix:/run/php/php-fpm.sock;
}

فقط خود سرور (127.0.0.1) اجازه دارد. مسیر را عمومی نکنید.

۳. خواندن خروجی

curl -s http://127.0.0.1/fpm-status

این فیلدها مهم‌اند: active processes و idle processes بار لحظه‌ای را نشان می‌دهند، listen queue درخواست‌های منتظر پروسه‌اند، max children reached تعداد دفعاتی است که سقف pm.max_children پر شده و slow requests درخواست‌های کندتر از آستانهٔ slowlog‌اند.

۴. تصمیم‌گیری

اگر max children reached بالا می‌رود و listen queue صفر نیست، pool کم است؛ ولی قبل از افزایش، مصرف حافظهٔ هر پروسه را بسنجید تا سرور به OOM نرسد (حافظه و OOM). اگر pool هیچ‌وقت پر نمی‌شود، افزایش آن فایده‌ای ندارد. راهنمای کامل تنظیم در تنظیم pool است.

۵. پایش

خروجی را به‌صورت دوره‌ای ثبت یا به ابزار مانیتورینگ بدهید. مسیر ping برای healthcheck ساده مناسب است.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید در ساعت اوج، max children reached از ۰ به عددی بزرگ رسید و listen queue هم مثبت بود. بعد از افزایش محتاطانهٔ pm.max_children با توجه به حافظهٔ آزاد، شمارنده دیگر بالا نرفت. این سناریو فقط برای توضیح است، نه اندازه‌گیری واقعی.

۷. اشتباه‌های رایج

  • باز گذاشتن /fpm-status برای همه.
  • افزایش max_children بدون سنجش حافظه.
  • خواندن خروجی فقط یک بار در ساعت کم‌بار.
  • فراموش‌کردن reload بعد از تغییر pool.

۸. پرسش‌های متداول

ping و status چه فرقی دارند؟ ping فقط زنده‌بودن را می‌گوید و status آمار کامل می‌دهد.

با ?full چه می‌شود؟ جزئیات هر پروسه را هم نشان می‌دهد.

برای چند pool چه کنم؟ هر pool مسیر وضعیت خودش را دارد.

۹. چک‌لیست سریع

  1. status_path و ping فعال شد.
  2. دسترسی در Nginx محدود شد.
  3. reload انجام شد.
  4. خروجی در ساعت اوج خوانده شد.
  5. تغییر pool با حافظه سنجیده شد.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

PHP manual: FPM configuration · Nginx ngx_http_fastcgi_module