تعديل wp-config.php بأمان في WordPress 2026: خطوات قبل وبعد التعديل

تعديل ملف wp-config.php في WordPress عملية بسيطة تقنيًا لكنها حساسة؛ خطأ Syntax واحد أوحفظ الملف بترميز غير صحيح قد يوقف الموقع بالكامل. لذلك هذه الصفحة مخصصة لـطريقة التعديل الآمنة نفسها، وليس لشرح كل Constants واستخدامات الملف.

إذا كنت تريد مرجعًا شاملًا لمعاني الإعدادات داخل الملف مثل Database credentials وDebug وMemory وSecurity keys، راجع دليل wp-config.php الكامل. هنا سنركز على Workflow التعديل والاسترداد.

المصدر الرسمي: WordPress Developer Handbook – Editing wp-config.php.

قبل أن تعدل الملف

1. خذ نسخة من الملف الحالي. نزّل نسخة محلية أوأنشئ Backup من لوحة الاستضافة.
2. اعرف طريقة الرجوع. يجب أن يكون لديك File Manager أوSFTP/SSH تستطيع الوصول به حتى لو تعطلت لوحة WordPress.
3. حدد التغيير المطلوب فقط. لا تعدل أكثر من Constant أوجزء في نفس المرة إذا لم تكن هناك حاجة.
4. يفضل Staging للتغييرات التي تؤثر على Database أوURLs أوDebug أوMemory.

أين يوجد wp-config.php؟

يوجد عادةً في جذر تثبيت WordPress، بجوار مجلدات مثل:

wp-admin/
wp-content/
wp-includes/
wp-config.php

WordPress تسمح في بعض التركيبات بوضع الملف مستوى واحدًا أعلى من Document Root، لذلك لو لم تجده في الجذر افحص بنية الاستضافة قبل إنشاء ملف جديد بالخطأ.

استخدم محرر نصوص أوCode Editor

استخدم محررًا يحفظ Plain Text مثل VS Code أوNotepad++ أوالمحرر المدمج في File Manager. لا تستخدم Microsoft Word أوأي محرر يضيف Formatting أوSmart Quotes.

احفظ الملف كـUTF-8 بدون إضافات غير ضرورية في بداية الملف. المشكلة المعروفة ليست “وجود سطر فارغ وحده” فقط؛ الأخطر هو وجود Bytes أوOutput قبل PHP opening tag، مثل BOM أوأحرف مخفية.

لا تضف Closing PHP Tag في نهاية الملف

في ملفات PHP التي تحتوي PHP فقط — ومنها wp-config.php المعتاد — من الأفضل ألا تضيف ?> في النهاية. هذا يقلل احتمال خروج مسافات أوأحرف بعد الإغلاق تسبب أخطاء Headers.

إذا كان ملفك الحالي لا يحتوي Closing tag، اتركه كما هو.

أين أضيف Constants الجديدة؟

معظم Constants المخصصة يجب إضافتها قبل السطر:

/* That's all, stop editing! Happy publishing. */

أوالمكافئ الموجود في نسختك. لا تضع Constants بعد تحميل WordPress إذا كانت الوثائق تطلب تعريفها قبل bootstrap.

مثال آمن: تفعيل Debug على Staging

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

هذا مثال للتشخيص وليس إعدادًا دائمًا لكل Production site. بعد انتهاء التحقيق، راجع الحاجة إلى Debug وLogs وحجم الملف الناتج.

لا تكرر نفس Constant

قبل إضافة سطر جديد ابحث عن الاسم داخل الملف. تعريف Constant مرتين قد ينتج Warning أويسبب ارتباكًا حول القيمة الفعلية المستخدمة.

مثال: إذا كان WP_DEBUG موجودًا بالفعل، عدّل قيمته بدل إضافة تعريف ثانٍ.

تعديل بيانات قاعدة البيانات

الثوابت الأساسية تشمل عادةً:

DB_NAME
DB_USER
DB_PASSWORD
DB_HOST

لا تعدلها إلا إذا تغيرت قاعدة البيانات أوCredentials فعلًا. خطأ واحد هنا يؤدي غالبًا إلى Error establishing a database connection.

لا ترسل Screenshot يحتوي DB_PASSWORD أوAuthentication keys إلى دعم عام أوGit repository.

احذر من Smart Quotes

انسخ الأكواد من مصدر موثوق وتأكد أن علامات الاقتباس هي:

'value'
"value"

وليست علامات Typographic مثل “ ” أو‘ ’. Smart Quotes داخل PHP قد تسبب Parse Error.

بعد الحفظ: اختبر فورًا

لا تغلق File Manager قبل التأكد أن الموقع يعمل. اختبر:

• Homepage.
• /wp-admin/.
• صفحة أووظيفة مرتبطة بالتعديل.
• REST/API أوCron إذا كان التغيير يؤثر عليهما.
• PHP error log أوdebug.log عند استخدام Debug.

لو ظهر Fatal Error بعد الحفظ، أعد النسخة السابقة من الملف قبل تجربة تعديل جديد.

أخطاء شائعة بعد تعديل wp-config.php

Parse error / unexpected token

غالبًا خطأ PHP syntax: فاصلة منقوطة مفقودة، quote غير مغلقة، قوس ناقص أوSmart Quotes.

Error establishing a database connection

راجع DB_NAME وDB_USER وDB_PASSWORD وDB_HOST وتأكد أن Database server يعمل.

Cannot modify header information

قد ينتج عن Output مبكر من ملف PHP: BOM، أحرف أوWhitespace خارج PHP، أوPlugin/Theme آخر. لا تفترض أن wp-config.php هو السبب الوحيد؛ راجع أول ملف يذكره الـWarning.

White screen أو500

استرجع الملف السابق أولًا. إذا عاد الموقع، قارن التغيير الجديد وحده وراجع PHP logs.

هل أعدل الملف من داخل WordPress؟

لا أنصح ببناء Workflow يعتمد على تعديل wp-config.php من داخل لوحة WordPress. الملف أعلى حساسية من Theme files، ووجود مسار خارجي مثل SFTP/File Manager مهم للاسترداد إذا تسبب التعديل في Fatal Error.

SFTP أمFile Manager؟

كلاهما صالح إذا كانت الصلاحيات مناسبة. SFTP/SSH أفضل غالبًا للفرق التقنية وVersion-controlled workflows، بينما File Manager مناسب للتعديل المحدود إذا كان يوفر Backup/Download.

لو تستخدم SSH لنقل الملفات، راجع دليل scp/OpenSSH 2026.

صلاحيات الملف

لا تجعل wp-config.php World-writable لمجرد حل مشكلة حفظ. صلاحيات الملفات تعتمد على الاستضافة وOwner/Group وPHP handler؛ استخدم القيم التي توصي بها استضافتك وWordPress بدل إعطاء 777 كحل عام.

متى لا تحتاج تعديل wp-config.php أصلًا؟

• تغيير Site Title أوTimezone — من Settings.
• تعديل Permalinks — من Settings → Permalinks.
• إضافة Snippet وظيفة عامة — استخدم Plugin/Code snippets عندما يكون أنسب.
• تغيير إعداد Plugin — استخدم API/واجهة الإضافة.

لا تستخدم wp-config.php كمكان لكل Custom code.

Checklist قبل الحفظ

• Backup للملف.
• Recovery access متاح.
• التعديل واحد ومحدد.
• لا يوجد Duplicate constant.
• Quotes وSyntax صحيحة.
• لا توجد Secrets ستتسرب في Screenshot أوGit.
• مكان التعريف قبل bootstrap الصحيح.
• تعرف ما الذي ستختبره بعد الحفظ.

Checklist بعد الحفظ

• Homepage = تعمل.
• wp-admin = يعمل.
• الوظيفة المستهدفة = تعمل.
• لا Fatal Errors جديدة.
• Logs لا تعرض مشكلة جديدة.
• Backup القديم ما زال محفوظًا حتى تتأكد من الاستقرار.

إذا أدى تعديل wp-config.php إلى خطأ متكرر، شاشة بيضاء، مشكلة اتصال بقاعدة البيانات أو تعارض لا يتضح سببه من السجلات، انتقل إلى تشخيص مشكلة ووردبريس بعد تعديل wp-config.php بدل مواصلة تغييرات متتابعة داخل الملف. الهدف هو عزل السبب ثم تنفيذ أقل تعديل قابل للرجوع واختباره.

الخلاصة

تعديل wp-config.php بأمان في WordPress يعتمد على Backup، محرر Plain Text، تغيير واحد في كل مرة، عدم تسريب Secrets، واختبار مباشر بعد الحفظ. لا تضف Closing tag أوConstants مكررة، ولا تستخدم صلاحيات واسعة كحل سريع. وإذا كنت تحتاج فهم جميع إعدادات الملف، استخدم الدليل الشامل بدل تحويل صفحة خطوات التعديل إلى قائمة Constants طويلة.