أخطاء PHP القاتلة في cPanel

Summary: يحدث خطأ PHP القاتل (fatal error) عندما تواجه PHP مشكلة حرجة تمنع تنفيذ سكربت. وبخلاف التحذيرات والإشعارات، توقف الأخطاء القاتلة التطبيق فورًا، مما قد

يحدث خطأ PHP القاتل (fatal error) عندما تواجه PHP مشكلة حرجة تمنع تنفيذ سكربت. وبخلاف التحذيرات والإشعارات، توقف الأخطاء القاتلة التطبيق فورًا، مما قد ينتج عنه صفحة فارغة أو رسالة خطأ حرجة أو استجابة HTTP 500.

يشرح هذا الدليل أكثر أسباب أخطاء PHP القاتلة شيوعًا ويقدم إجراءات استكشاف أخطاء خطوة بخطوة باستخدام cPanel.

نظرة عامة

تنجم أخطاء PHP القاتلة عادةً عن:

• تعارض الإضافات أو الامتدادات
• مشكلات توافق القالب
• إصدارات PHP غير مدعومة
• ذاكرة PHP غير كافية
• ملفات تطبيق تالفة
• امتدادات PHP مفقودة
• أذونات ملفات غير صحيحة
• أخطاء برمجية
• تحديثات برمجية فاشلة

يتطلب حل المشكلة عادةً تحديد الخطأ المحدد وتصحيح التكوين أو مشكلة التطبيق المسببة.

رسائل خطأ شائعة

قد تواجه واحدًا أو أكثر من الأخطاء التالية:

Fatal error: Allowed memory size exhausted

Fatal error: Uncaught Error

Call to undefined function

Maximum execution time exceeded

Cannot redeclare function

Class not found

Parse error

عرض سجلات أخطاء PHP

سجل أخطاء PHP هو أفضل مكان لبدء استكشاف الأخطاء.

لعرض أحدث الأخطاء:

1. سجّل الدخول إلى cPanel.
2. افتح Errors أو Metrics → Errors.
3. راجع أحدث المدخلات.
4. حدّد الملف أو الإضافة أو القالب أو السكربت المتأثر.

تتضمن معظم الأخطاء القاتلة اسم الملف ورقم السطر الذي حدث فيه الخطأ.

تفعيل الإبلاغ عن أخطاء PHP

إذا لم تقدم السجلات معلومات كافية، فيمكن للإبلاغ المؤقت عن الأخطاء أن يساعد في تحديد المشكلة.

أضف الشيفرة التالية إلى تطبيق PHP أثناء استكشاف الأخطاء:

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

بعد تحديد المشكلة، عطّل الإبلاغ عن الأخطاء لتجنب عرض معلومات حساسة للعامة.

زيادة حد ذاكرة PHP

نقص ذاكرة PHP من أكثر أسباب الأخطاء القاتلة شيوعًا.

يمكنك زيادة حد الذاكرة باستخدام MultiPHP INI Editor في cPanel.

تشمل القيم الموصى بها:

256M

أو

512M

إذا كنت تشغّل WordPress، فيمكن أيضًا زيادة حد الذاكرة عبر ملف wp-config.php.

التحقق من إصدار PHP

قد تفشل التطبيقات إذا كانت تعمل على إصدار PHP غير متوافق.

للتحقق من إصدارك الحالي:

1. افتح MultiPHP Manager أو Select PHP Version.
2. حدّد موقع النطاق المتأثر.
3. تأكد من أن إصدار PHP المحدد مدعوم من تطبيقك.
4. غيّر الإصدار عند اللزوم.

يحسّن استخدام إصدار PHP مدعوم الاستقرار والأمان معًا.

التحقق من امتدادات PHP المطلوبة

تتطلب كثير من تطبيقات PHP امتدادات محددة لتعمل بشكل صحيح.

تشمل الامتدادات الشائعة:

• mysqli
• mbstring
• curl
• gd
• intl
• zip
• xml
• openssl

إذا كان امتداد مطلوب مفقودًا، فقد يولّد التطبيق أخطاء قاتلة أثناء التنفيذ.

تعطيل الإضافات المثبتة حديثًا

إذا ظهر الخطأ بعد تثبيت إضافة أو تحديثها، فعطّلها مؤقتًا.

لـ WordPress:

1. افتح File Manager.
2. انتقل إلى:

public_html/wp-content/plugins/

3. غيّر اسم مجلد الإضافة.

مثال:

example-plugin

إلى:

example-plugin-disabled

أعد تحميل الموقع لمعرفة ما إذا كانت الإضافة هي السبب — وهذا مصدر شائع للمشاكل بعد مباشرة من تحديث نواة WordPress.

التبديل إلى قالب افتراضي

قد تسبب تعارضات القوالب أيضًا أخطاء PHP قاتلة، كما قد تتسبب في خطأ 500 Internal Server Error.

انتقل إلى:

public_html/wp-content/themes/

غيّر اسم مجلد القالب النشط.

إذا توفر قالب WordPress افتراضي، فسيفعّله WordPress تلقائيًا.

استبدال ملفات التطبيق التالفة

قد تضر التحديثات المنقطعة أو عمليات الرفع غير المكتملة بملفات التطبيق.

لتثبيتات WordPress:

• نزّل نسخة جديدة من WordPress.
• استبدل مجلدي wp-admin وwp-includes.
• لا تستبدل مجلد wp-content أو ملف wp-config.php.

يستعيد هذا ملفات نواة التطبيق دون التأثير على محتوى الموقع.

استعادة نسخة احتياطية

إذا بدأت المشكلة بعد تغييرات حديثة، فقد تحلها استعادة نسخة احتياطية.

حسب نظام النسخ الاحتياطي لديك، يمكنك استعادة:

• ملفات الموقع
• قاعدة البيانات
• حساب cPanel الكامل

تحقق دائمًا من أن النسخة الاحتياطية حديثة قبل الاستعادة.

إصلاح ملف .htaccess

يمكن لملف .htaccess التالف أن يعطّل تنفيذ PHP.

للاختبار:

1. افتح File Manager.
2. انتقل إلى الدليل الجذر لموقعك.
3. غيّر اسم:

.htaccess

إلى:

.htaccess_old

أعد تحميل الموقع.

إذا تم حل المشكلة، فأنشئ ملف .htaccess جديدًا.

لـ WordPress:

• افتح Settings → Permalinks
• انقر على Save Changes

مراجعة أذونات الملفات

قد تمنع الأذونات غير الصحيحة PHP من الوصول إلى الملفات المطلوبة.

قيم الأذونات الموصى بها:

تجنب منح أذونات 777، لأنها تولد مخاطر أمنية وقد يحجبها الخادم.

التواصل مع مزود الاستضافة

إذا استمرت المشكلة بعد إكمال الخطوات أعلاه، فتواصل مع مزود الاستضافة.

زوّده بالمعلومات التالية إن توفرت:

• رسالة الخطأ
• عنوان URL لموقعك
• الطابع الزمني للخطأ
• إصدار PHP
• التغييرات الأخيرة التي أجريتها على الموقع

يمكن لمزود الاستضافة مراجعة:

• سجلات أخطاء PHP
• سجلات Apache أو LiteSpeed
• استخدام موارد الخادم
• امتدادات PHP مفقودة
• أذونات الحساب
• تكوين الخادم

تحدد هذه السجلات عادةً السبب الجذري للخطأ القاتل.