قلة عمال PHP-FPM تجعل الطلبات تصطف وتفشل بأخطاء 502 أو 504، وكثرتهم تستنزف الذاكرة فتقتل النواة العمليات. الرقم الصحيح يأتي من قياس ذاكرة العامل الواحد وما تستطيعون تخصيصه من RAM. يعرض هذا الدليل طريقة بسيطة وإعداداً أولياً آمناً وتفعيل السجل البطيء وإعادة تحميل الخدمة. الأوامر وفق وثائق PHP؛ لم أشغّلها على خادمكم وتختلف المسارات والإصدارات.
١. قيسوا قبل أن تغيّروا
اعثروا على متوسط ذاكرة العامل والذاكرة المتاحة لـ PHP بعد حصة نظام التشغيل وقاعدة البيانات وخادم الويب:
# Average memory per PHP-FPM worker (MB)
ps --no-headers -o rss -C php-fpm8.2 | awk '{s+=$1;n++} END {printf "workers=%d avg=%.0f MB\n", n, s/n/1024}'
free -m
sudo grep -E 'max children|pm.max_children' /var/log/php8.2-fpm.log | tail -n 5
قيسوا تحت حركة عادية لأن العمال يكبرون مع الوقت. وموقع ووردبريس بإضافات كثيرة يستهلك غالباً أكثر بكثير من سكربت صغير.
٢. احسبوا حداً أقصى آمناً
اقسموا الذاكرة التي تستطيعون منحها لـ PHP على متوسط حجم العامل ثم أبقوا هامشاً. فمثلاً مع نحو 2000 ميغابايت متاحة و80 ميغابايت للعامل يترك حد قريب من 20 مجالاً للذروات. هذا حساب توضيحي لا قياس لخادمكم.
٣. مجمّع أولي آمن
استخدموا مدير العمليات dynamic وضعوا حداً من حسابكم وأعيدوا تدوير العمال بانتظام وفعّلوا السجل البطيء لتروا أي الطلبات تطول:
; /etc/php/8.2/fpm/pool.d/www.conf
pm = dynamic
pm.max_children = 20
pm.start_servers = 4
pm.min_spare_servers = 2
pm.max_spare_servers = 6
pm.max_requests = 500
request_terminate_timeout = 60s
slowlog = /var/log/php-fpm-slow.log
request_slowlog_timeout = 5s
تخفيض pm.max_requests يساعد ضد تسرب الذاكرة في بعض الإضافات. ويعرض السجل البطيء تتبع المكدس للطلبات التي تتجاوز العتبة وهو يقترن جيداً بفحوص قاعدة البيانات في دليل سجل الاستعلامات البطيئة.
٤. اختبروا وأعيدوا التحميل دون انقطاع
اختبروا الإعداد دائماً أولاً. تُبقي إعادة التحميل الطلبات الجارية حية بينما يقطعها إعادة التشغيل:
sudo php-fpm8.2 -t # test the configuration
sudo systemctl reload php8.2-fpm
sudo systemctl status php8.2-fpm --no-pager
sudo tail -n 20 /var/log/php-fpm-slow.log
راقبوا السجل بحثاً عن تحذير “max_children reached”. إن ظهر كثيراً وما زالت الذاكرة حرة فارفعوا الحد تدريجياً. وإن كانت الذاكرة ضيقة فأصلحوا الشيفرة البطيئة أو أضيفوا تخزيناً مؤقتاً بدل ذلك؛ راجعوا دليل TTFB.
٥. أخطاء شائعة
هذه الإعدادات تسبب معظم مشاكل المجمّع:
pm.max_children = 200 ; 200 x 80 MB = 16 GB: the kernel kills processes (OOM)
pm.max_children = 2 ; requests queue and users see 502/504
pm = static with big values on a small VPS
وتذكروا أن لخادم الويب مهلات منسجمة وإلا قد يستسلم قبل أن ينتهي PHP.
٦. مثال توضيحي وليس قياساً حقيقياً
افترضوا خادماً افتراضياً (مختلقاً) بذاكرة 4 غيغابايت يعرض الموقع عليه أخطاء 502 عند الذروة. يقول السجل إن max_children بلغ حده ومتوسط العمال نحو 80 ميغابايت. يمكن تخصيص نحو 2 غيغابايت لـ PHP فيكون حد قريب من 20 معقولاً. بعد رفعه من 5 إلى 20 وتفعيل السجل البطيء تتوقف الأخطاء وتبقى الذاكرة ضمن الحدود.
٧. أخطاء شائعة
- تخمين pm.max_children.
- رفعه حتى ينفد ذاكرة الخادم.
- إعادة التشغيل بدل إعادة التحميل.
- تجاهل تحذير max_children في السجل.
- عدم تفعيل السجل البطيء.
- نسيان مهل خادم الويب المنسجمة.
٨. أسئلة شائعة
ماذا يفعل max_children؟ يحدد عدد عمال PHP الذين يعملون في وقت واحد.
dynamic أم ondemand أم static؟ dynamic افتراضي متوازن وondemand يوفر الذاكرة في المواقع الهادئة وstatic يناسب الخوادم المخصصة المزدحمة.
كيف أعرف أن الحد منخفض؟ يظهر max_children reached في السجل وقد يرى المستخدمون 502 أو 504.
هل مزيد من العمال أسرع دائماً؟ لا. حين تنفد الذاكرة يسوء الأداء كثيراً.
٩. قائمة تحقق سريعة
- قيسوا متوسط ذاكرة العامل.
- قدّروا الذاكرة المتاحة لـ PHP.
- احسبوا حداً مع هامش.
- عدّلوا ملف المجمّع.
- شغّلوا php-fpm -t.
- أعيدوا تحميل الخدمة.
- راقبوا السجلات والسجل البطيء.
إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.
تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.
المراجع الرسمية
PHP manual: FPM configuration · PHP manual: FastCGI Process Manager · nginx: ngx_http_fastcgi_module · ps(1) manual
