كيف تتعامل مع خطأ Syntax Error في ووردبريس

مقدمة

خطأ Syntax Error في ووردبريس من أكثر الأخطاء التي تخض المستخدم، لأنه غالبًا يمنع الموقع من العمل ويعرض شاشة بيضاء مع رسالة غريبة. في الحقيقة الخطأ سببه بسيط: مشكلة في كتابة كود PHP. في هذا المقال نشرح الأسباب، وكيف تشخص الخطأ وتصلحه بخطوات واضحة تناسب المستخدم العادي والمطور.

أسباب ظهور خطأ Syntax Error في ووردبريس

1. أخطاء في كود PHP

• نسيان الفاصلة المنقوطة ; في نهاية السطر.
• فتح قوس وعدم إغلاقه مثل ( أو {.
• علامات تنصيص غير متطابقة "…' أو استخدام نوع مختلف عند الفتح والإغلاق.
• إضافة كود في مكان غير صحيح داخل ملف القالب أو الإضافة.

2. نسخ كود من الإنترنت بدون مراجعة

• كود مكتوب لإصدار PHP مختلف عن الإصدار على الخادم.
• وجود مسافات أو أحرف مخفية تأتي مع النسخ واللصق من بعض المواقع.

3. تعديل مباشر على ملفات القالب أو الإضافات

استخدام محرر الملفات داخل لوحة التحكم للتعديل على القالب أو الإضافات بدون نسخة احتياطية يزيد احتمال حدوث Syntax Error لأن أي خطأ بسيط يوقف الموقع بالكامل.

خطوات تشخيص الخطأ

1. قراءة رسالة الخطأ

عادةً تظهر رسالة تحتوي على:

• نوع الخطأ: مثل Parse error أو Syntax error.
• اسم الملف: مثل /wp-content/themes/theme-name/functions.php.
• رقم السطر الذي توقف عنده التنفيذ.

سجّل هذه البيانات فهي نقطة البداية في الحل.

2. تفعيل وضع التصحيح في ووردبريس

لو كانت الرسالة غير واضحة أو لا تظهر، فعّل التصحيح من ملف wp-config.php بإضافة أو تعديل الأسطر التالية:

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

بعد الحفظ أعد تحميل الموقع، أو راجع ملف wp-content/debug.log لرؤية تفاصيل الخطأ.

3. تحديد الملف المتسبب

باستخدام المعلومات السابقة، ادخل لملفات الموقع عبر File Manager أو FTP، واذهب إلى الملف المذكور في الرسالة وافتحه بمحرر يدعم تلوين الأكواد.

حلول بسيطة للمستخدم العادي

1. التراجع عن آخر تعديل

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

2. تعطيل جميع الإضافات مؤقتًا

1. ادخل إلى مجلد wp-content.
2. غيّر اسم مجلد plugins إلى plugins-off.
3. افتح الموقع؛ إذا عمل فالمشكلة في إحدى الإضافات.
4. أعد اسم المجلد كما كان، ثم عطّل الإضافات من لوحة التحكم واحدة تلو الأخرى حتى تحدد الإضافة المسببة للمشكلة.

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

إذا كانت الرسالة مرتبطة بملف في مجلد القالب، جرّب تفعيل قالب ووردبريس افتراضي:

• تأكد من وجود قالب مثل twentytwentyfour في wp-content/themes.
• غيّر اسم مجلد القالب الحالي لإيقافه، وسيحاول ووردبريس استخدام القالب الافتراضي تلقائيًا.

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

إذا كان لديك Backup حديث، استعادة ملفات القالب أو الإضافة من النسخة الاحتياطية غالبًا يكون أسرع حل بدون الدخول في تفاصيل الكود.

حلول متقدمة للمطورين

1. مراجعة الكود وإصلاحه

انتقل إلى السطر المذكور في رسالة الخطأ وما حوله، وابحث عن:

• أقواس غير مغلقة.
• علامات تنصيص ناقصة.
• فاصلة منقوطة مفقودة.

مثال بسيط على خطأ شائع:

<?php
function example() {
echo 'Hello World'
}


الكود الصحيح يكون:

<?php
function example() {
echo 'Hello World';
}


2. استخدام WP-CLI

إذا كان لديك وصول لسطر الأوامر، يمكنك تعطيل الإضافات أو تفعيل قالب افتراضي باستخدام WP-CLI:

wp plugin deactivate --all
wp theme activate twentytwentyfour

3. التحقق من نسخة PHP

تأكد أن الكود متوافق مع إصدار PHP على الخادم. بعض التركيبات مثل match أو الأنماط الحديثة تحتاج PHP 8 أو أعلى. يمكنك معرفة الإصدار من لوحة الاستضافة أو عبر الأمر:

php -v

أدوات وروابط مفيدة

• Debugging in WordPress – شرح رسمي من ووردبريس لتفعيل وضع التصحيح ومراجعة الأخطاء.
• Query Monitor – إضافة قوية لعرض الأخطاء والاستعلامات في الواجهة الخلفية.
• PHP Manual – التوثيق الرسمي للغة PHP لمراجعة الدوال والبُنى التركيبية.

الخاتمة

خطأ Syntax Error مزعج لكنه واضح وسهل الحل متى عرفت الملف والسطر المتسببين فيه. ابدأ دائمًا بالتراجع عن آخر تعديل أو تعطيل الإضافات والقالب، ثم انتقل إلى إصلاح الكود مباشرة إذا كان لديك خبرة. حافظ على نسخ احتياطية دورية، ولا تعدل الملفات الحساسة إلا من خلال محرر كود موثوق أو بيئة تجريبية، حتى تحافظ على استقرار موقعك وتقليل فرص تكرار المشكلة.