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

الشاشة البيضاء أو الخطأ الحرج في ووردبريس: وضع الاسترداد وخطوات آمنة

استخدموا وضع الاسترداد وسجل الأخطاء وإعادة تسمية المجلدات القابلة للتراجع لإصلاح الشاشة البيضاء أو الخطأ الحرج دون حذف شيء.

الشاشة البيضاء أو الخطأ الحرج في ووردبريس: وضع الاسترداد وخطوات آمنة

عبارة “There has been a critical error on this website” أو صفحة بيضاء عادية تعني غالباً أن PHP توقفت عند خطأ قاتل، وأكثر ما يكون في إضافة أو قالب أو بعد تحديث. رد الفعل الخطر هو الحذف. أما الآمن فهو إيجاد المكوّن الواحد الفاشل وإيقافه بطريقة يمكن التراجع عنها والاحتفاظ بالأدلة. ينتقل هذا الدليل من أرفق أداة وهي وضع الاسترداد إلى إعادة التسمية القابلة للتراجع وWP-CLI وينتهي بمنع التكرار.

١. افحصوا البريد ووضع الاسترداد أولاً

منذ ووردبريس 5.2 يرسل الخطأ القاتل بريداً إلى عنوان المدير مع رابط استرداد خاص. افتحوه وسجلوا الدخول فيوقف ووردبريس الإضافة أو القالب المتسبب ويخبركم أيهما. عطّلوا ذلك المكوّن أو حدّثوه من لوحة التحكم. افحصوا مجلد البريد المزعج والعنوان في Settings, General؛ فإن كان العنوان قديماً لن يصل الرابط، وهذا أحد أسباب إبقائه محدثاً.

٢. اقرؤوا الخطأ الحقيقي

الصفحة البيضاء تخفي الرسالة لكن السجل يحتفظ بها. فعّلوا التسجيل دون عرض الأخطاء (راجعوا دليل التحديث لعادة النسخ الاحتياطي الآمنة قبل التغييرات) وأعيدوا إنتاج المشكلة واقرؤوا نهاية السجل:

tail -n 30 wp-content/debug.log

سطر مثل “Uncaught Error” يتبعه مسار تحت wp-content/plugins/ يسمّي الإضافة. و”Allowed memory size exhausted” يشير إلى الذاكرة لا إلى الشيفرة. وفي cPanel شُرحت ملفات السجل في دليل حدود الموارد ودليل سجلات أخطاء PHP.

٣. أوقفوا المشتبه به بإعادة تسمية قابلة للتراجع

إن تعذر تسجيل الدخول فاستخدموا مدير الملفات أو FTP أو SSH. إعادة تسمية المجلد تعطّل الإضافة دون فقدان ملفاتها وإعداداتها:

cd wp-content
# Rename one suspect plugin folder (reversible)
mv plugins/example-plugin plugins/example-plugin.off

# Or disable all plugins at once to test
mv plugins plugins.off && mkdir plugins

أعيدوا تحميل الموقع. إن عاد فالإضافة كانت السبب؛ أعيدوا أسماء المجلدات واحداً واحداً لمعرفة أيها. أعيدوا التسمية ولا تحذفوا لتتمكنوا من استعادة الحالة الدقيقة والإبلاغ عن الخلل لمطور الإضافة.

٤. استخدموا WP-CLI عند توفر الصدفة

يستطيع WP-CLI تعطيل إضافة أو تبديل قالب حتى والموقع معطوب إن تخطيتم تحميل الإضافات والقوالب:

wp plugin list --status=active --fields=name,version
wp plugin deactivate example-plugin --skip-plugins --skip-themes
wp theme list --fields=name,status
wp theme activate twentytwentyfour --skip-plugins --skip-themes

إن كان القالب هو السبب فتفعيل قالب افتراضي يعيد الموقع لتصلحوا القالب المخصص. دوّنوا كل تغيير.

٥. افحصوا الذاكرة وإصدار PHP وآخر تغيير

اسألوا ما الذي تغيّر آخر مرة: تحديث إضافة أو تبديل إصدار PHP أو مقتطف جديد. والرجوع خطوة واحدة هو الأسرع غالباً؛ يشرح دليل إصدار PHP تبديل الإصدار. وإن كانت الذاكرة هي المشكلة فارفعوا الحد باعتدال وابحثوا عن الإضافة التي تستهلك هذا القدر.

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

افترضوا أن السجل يقول إن ملفاً في wp-content/plugins/example-plugin/main.php استدعى دالة غير موجودة بعد ترقية PHP (حالة مختلقة). إعادة تسمية ذلك المجلد وحده تعيد الموقع خلال دقيقة. ثم تحدّثون الإضافة أو تختارون غيرها ولا تعيدون الاسم إلا عند تثبيت إصدار متوافق. لم يُحذف شيء وأخبركم سطر السجل أين تنظرون بالضبط.

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

  • حذف الإضافات أو كامل wp-content في ذعر.
  • تعطيل كل الإضافات والسجل سمّى واحدة.
  • تجاهل بريد الاسترداد.
  • رفع حد الذاكرة إلى قيمة ضخمة دون معرفة السبب.
  • ترك التصحيح مفعلاً بعد الإصلاح.
  • عدة تغييرات قبل الاختبار.

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

هل تضيع إعداداتي بإعادة تسمية مجلد الإضافة؟ غالباً لا. الإعدادات في قاعدة البيانات وتعود عند تفعيل الإضافة من جديد.

لا يصلني بريد الاسترداد، ماذا أفعل؟ استخدموا طريقة السجل وإعادة التسمية وتحققوا من صحة بريد المدير في الإعدادات.

هل الشاشة البيضاء دائماً إضافة؟ لا. قد تكون قالباً أو إصدار PHP أو ذاكرة أو ملفاً تالفاً. السجل يحدد.

هل أستعيد نسخة احتياطية فوراً؟ إن كان الموقع حرجاً ولديكم نسخة سليمة فنعم، لكن اعرفوا السبب وإلا عاد.

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

  1. افحصوا البريد لرابط الاسترداد.
  2. فعّلوا التسجيل واقرؤوا الخطأ.
  3. غيّروا اسم مجلد الإضافة أو القالب المذكور.
  4. اختبروا الموقع ولوحة الإدارة.
  5. استخدموا WP-CLI عند توفر الصدفة.
  6. أصلحوا المكوّن أو حدّثوه أو استبدلوه.
  7. أوقفوا التصحيح ودوّنوا السبب.

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

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

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

ووردبريس Documentation: FAQ Troubleshooting · ووردبريس: Debugging in ووردبريس · Make ووردبريس Core: Fatal error recovery mode · WP-CLI: wp plugin deactivate