كل المقالات التقنية

تسجيل أخطاء PHP في بيئة الإنتاج: display_errors مُعطَّل وlog_errors مُفعَّل

أرسلوا أخطاء PHP إلى ملف سجل في الإنتاج وأوقفوا عرضها للزوار واستخدموا WP_DEBUG_LOG في ووردبريس مؤقتاً وبأمان.

تسجيل أخطاء PHP في بيئة الإنتاج: display_errors مُعطَّل وlog_errors مُفعَّل

خطأ PHP يُطبع على الصفحة يكشف مسارات الملفات والتفاصيل الداخلية للجميع، لكن إذا لم يُسجَّل في أي مكان فلن ترون المشكلة. الطريقة الصحيحة هي إيقاف العرض وتفعيل التسجيل في ملف.

١. إعدادات php.ini

display_errors = Off
log_errors = On
error_log = /var/log/php/error.log
error_reporting = E_ALL

يجب أن يوجد مسار السجل وأن يستطيع مستخدم PHP (مثل www-data) الكتابة فيه. استخدموا php --ini لمعرفة ملف ini الفعال وphp -i | grep error_log للقيمة الحالية؛ وفي PHP-FPM يختلف ini مجلد fpm عن ini سطر الأوامر.

٢. مخرجات عمال FPM

; في ملف المجمّع
catch_workers_output = yes

يوجّه هذا الخيار مخرجات stderr للعمال إلى سجل FPM. وبعد تغيير ini أو المجمّع أعيدوا تحميل خدمة PHP-FPM.

٣. ووردبريس

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

تكتب هذه الأسطر الثلاثة في wp-config.php الأخطاء إلى wp-content/debug.log دون طباعتها على الصفحة. فعّلوها لفترة استكشاف الأخطاء فقط ثم عطّلوها. وامنعوا الوصول العام إلى debug.log. ولمزيد من التقوية راجعوا wp-config.php وإعدادات PHP الآمنة.

٤. القراءة والبحث

tail -f /var/log/php/error.log
grep -E 'Fatal|Warning' /var/log/php/error.log | tail -20

غالباً ما يسبب Fatal شاشة بيضاء أو 500. وآخر Fatal قبل وقت المشكلة هو الدليل الرئيسي.

٥. تدوير السجل

السجل بلا تدوير يملأ القرص. اضبطوا logrotate لهذا الملف.

٦. مثال توضيحي وليس قياساً حقيقياً

لنفترض أن موقعاً يعطي 500 بلا سبب ظاهر ولم تقل صفحة الخطأ شيئاً. بعد تفعيل log_errors أظهر السجل Fatal يتعلق بحد الذاكرة. ثم صُحّح ذلك الحد فقط. هذا سيناريو مختلق للتوضيح وليس قياساً حقيقياً.

٧. أخطاء شائعة

  • display_errors مفعّل في موقع عام.
  • مسار سجل بلا إذن كتابة.
  • ترك WP_DEBUG_LOG مفعّلاً بعد انتهاء العمل.
  • وضع debug.log في مسار قابل للتنزيل.

٨. أسئلة شائعة

لماذا السجل فارغ؟ مشكلة مسار أو إذن، أو ini لا يقرؤه FPM.

ما قيمة error_reporting؟ في الإنتاج يفيد E_ALL مع إيقاف العرض لاستكشاف الأخطاء.

ألا تكفي سجلات Nginx أو Apache؟ تسجل PHP نفسها أخطاء التطبيق.

٩. قائمة تحقق سريعة

  1. display_errors مُعطَّل.
  2. log_errors مفعّل والمسار قابل للكتابة.
  3. أُعيد التحميل.
  4. debug.log في ووردبريس مؤقت ومحجوب.
  5. ضُبط تدوير السجل.

إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.

تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.

المراجع الرسمية

PHP manual: error handling configuration · ووردبريس: debugging