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

تخيل هذا السيناريو: تحاول الدخول إلى موقعك أو لوحة تحكم الإدارة، وفجأة.. لا شيء! مجرد شاشة بيضاء فارغة تماماً بدون أي رسالة خطأ. هذا ما نسميه في عالم البرمجة "شاشة الموت البيضاء" (White Screen of Death).

بصفتي عبد السلام البيطار، مبرمج ووردبريس وخبير سيو، واجهت هذه المشكلة مئات المرات مع عملائي في سوريا والسعودية. السبب غالباً ما يكون بسيطاً (خطأ في كود PHP أو استهلاك الذاكرة)، لكنه يبدو مرعباً للمبتدئين.

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

تنبيه هام قبل البدء: الخطوات التالية تتطلب تعديلاً على ملفات الموقع الرئيسية. تأكد دائماً من أخذ نسخة احتياطية (Backup) لموقعك قبل لمس أي كود.

السبب الأول: استنفاد ذاكرة الـ PHP (Memory Limit)

هذا هو السبب الأكثر شيوعاً. السكريبتات في موقعك تحتاج لذاكرة لتعمل، وإذا تجاوزت الحد المسموح به من الاستضافة، سيتوقف الموقع.

لحل هذه المشكلة، نقوم بزيادة حد الذاكرة برمجياً. ادخل إلى مدير الملفات (File Manager) في استضافتك، وابحث عن ملف wp-config.php وأضف الكود التالي قبل سطر "That's all, stop editing":

// زيادة ذاكرة PHP في ووردبريس - كود بواسطة عبد السلام البيطار
define( 'WP_MEMORY_LIMIT', '256M' );

هذا الكود يخبر السيرفر برفع الحد المسموح به إلى 256 ميجابايت، وهو ما يكفي عادةً لحل المشكلة فوراً.

السبب الثاني: تعارض في الإضافات (Plugin Conflict)

أحياناً، تقوم بتحديث إضافة معينة، فيحدث تضارب في الأكواد (Code Conflict) مع القالب أو مع إضافة أخرى. بما أنك لا تستطيع الدخول للوحة التحكم لتعطيل الإضافة، سأعلمك الطريقة الاحترافية عبر الـ FTP أو السي بانل:

1. اذهب إلى مسار: wp-content/plugins.
2. قم بتغيير اسم مجلد الإضافة المشكوك فيها (مثلاً: أضف _old للاسم).
3. حاول فتح الموقع. إذا عاد للعمل، فقد وجدت المجرم!

السبب الثالث: تفعيل وضع التصحيح (Debugging Mode)

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

عدّل ملف wp-config.php مرة أخرى، وابحث عن هذا السطر وغيّر القيمة من false إلى true:

// تفعيل وضع المطورين لاكتشاف الأخطاء
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

الآن، بدلاً من الشاشة البيضاء، ستظهر لك رسالة خطأ واضحة تشير إلى الملف والسطر الذي يسبب المشكلة (مثلاً: Fatal error in line 45...). هذه هي الطريقة التي أستخدمها شخصياً في عبد السلام البيطار للحلول الرقمية لتشخيص أعقد المشاكل في دقائق.

هل مازلت تواجه المشكلة؟

أحياناً يكون العطل أعمق من ذلك (مشكلة في إصدار PHP في السيرفر، أو ملفات Core تالفة). التعامل مع هذه الحالات يتطلب خبرة برمجية دقيقة لضمان عدم فقدان البيانات.

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

أصلح موقعي الآن (طلب تدخل تقني)