شاشة الموت البيضاء WordPress
صفحة فارغة تماما مع عدم وجود خطأ ولا HTML. توقفت PHP منتصف الطلب وذهبت الرسالة إلى سجل لم تقرأه بعد.
(a blank white page, no text at all)
الشاشة فارغة لأن display_errors متوقفة ، ليس لأنه لا يوجد شيء لقوله. قم بالتبديل على WP_DEBUG_LOG ، وأعد تحميل الصفحة مرة واحدة ، واقرأ wp-content/debug.log - آخر إدخال يسمي الملف والخط الذي توقف.
الأسباب الأرجح أولًا.
افحص القائمة بالترتيب. يتيح لك كل فحص تأكيد السبب أو استبعاده قبل تغيير أي شيء، لأن الحلول تختلف والتخمين يكلّف أكثر من تنفيذ أمر للتحقق.
| السبب | كيفية التحقق | الإصلاح |
|---|---|---|
| خطأ PHP فادح في مكون إضافي أو سمة | يبدأ إدخال السجل بـ "خطأ فادح PHP" ويسمي ملفًا تحت wp-content . هذا المسار هو الجواب. | تعطيل البرنامج المساعد المسمى أو تبديل السمة. إذا كان الملف ينتمي إلى سمة ، فإن التبديل إلى سمة افتراضية يعيد الموقع أثناء النظر إليه. |
| تم الوصول إلى الحد الأقصى للذاكرة | السجل يقول "الحجم المسموح به للذاكرة ... استنفدت". صفحة فارغة وقتل خارج الذاكرة تبدو متطابقة من المتصفح. | رفع الحد الكافي لتحميل الصفحة ، ثم العثور على ما يحتاج الذاكرة. الحد هو أعراض وليس السبب. |
| فقط wp-admin أبيض | الواجهة الأمامية تجعل لوحة القيادة لا ، أو العكس. يشير عدم التماثل إلى رمز المشرف فقط. | القاتل هو في مسار المشرف فقط. إعادة تسمية دليل الإضافات عبر SFTP للعودة إلى الداخل ، ثم إعادة تنشيط واحد في وقت واحد. |
| OPcache يخدم ملف تجميع قديم | كان الموقع على ما يرام ، تم تحرير ملف ، والآن هو فارغ - وأسماء الخطأ سطر لم يعد موجودًا في الملف. | تدفق OPcache. تحرير PHP في مكان دون تدفق يترك النسخة المترجمة والمصدر لا يوافق. |
| خطأ في بناء الجملة في ملف قمت بتحريره للتو | php -l على الملف الذي لمست تقارير الماضي الخطأ دون الحاجة WordPress على الإطلاق. | إصلاح بناء الجملة أو استعادة النسخة السابقة. A الضالة دعامة في wp-config.php أو functions.php يأخذ كل صفحة في وقت واحد. |
الإصلاح خطوة بخطوة.
تفترض الأوامر توفر WP-CLI والوصول إلى سطر الأوامر. إن لم يتوفرا، تشرح كل خطوة الإجراء كي تنفذه من لوحة التحكم أو عبر SFTP.
أعد تشغيل الرسالة
تسجيل الدخول بدلاً من العرض: تريد التفاصيل دون نشر تتبع كومة للزوار.
wp config set WP_DEBUG true --raw wp config set WP_DEBUG_LOG true --raw wp config set WP_DEBUG_DISPLAY false --raw
أعد تحميل الصفحة الفارغة مرة واحدة ، ثم اقرأ السجل
المدخل الأخير لك كل شيء فوقه قد يكون ضوضاء قديمة
tail -n 30 wp-content/debug.log
إذا كان اسمه البرنامج المساعد، واتخاذ هذا البرنامج المساعد من الطلب
يكفي إلغاء التفعيل بالاسم ؛ لا تحتاج إلى حذف أي شيء.
wp plugin deactivate the-named-plugin
إذا لم تتمكن من الوصول إلى wp-admin على الإطلاق ، فقم بتعطيل الإضافات من نظام الملفات
إعادة تسمية الدليل يجعل WordPress لا يجد أي مكونات إضافية ، وهو ما يكفي لاستعادة لوحة المعلومات.
mv wp-content/plugins wp-content/plugins.off
قم بتصحيح التصحيح عند الانتهاء من ذلك
سجل التصحيح اليسار على ينمو دون حدود وسجلات المسارات التي لا تفضل نشرها.
wp config set WP_DEBUG false --raw
ما تتولاه المنصة عنك.
الشاشة البيضاء هي حادث تكوين بدلاً من ميزة WordPress: يتم إخبار PHP بعدم عرض الأخطاء ولا يتم إخبار أي شيء بتسجيلها. هنا السجل قيد التشغيل وقابل للكتابة من الطلب الأول ، لذلك فإن الخطأ القاتل هو سطر يمكنك قراءته بدلاً من صفحة فارغة. استنساخ الموقع قبل التحديث يعني أن المكون الإضافي الذي يقتله يفعل ذلك على نسخة لا يزورها أحد.
الأسئلة الشائعة.
لماذا الصفحة فارغة بدلاً من إظهار الخطأ؟
الواجهة الأمامية جيدة ولكن wp-admin أبيض. لماذا هناك فقط؟
لقد أصلحت الملف لكن الصفحة لا تزال فارغة.
هل يمكنني العثور على الجاني دون أي وصول سطر الأوامر؟
إن لم يكن هذا هو السبب.
قد تبدو هذه الأخطاء متشابهة في المتصفح.