ربط ووردبريس المحلي بقاعدة MySQL تعمل على منفذ مختلف

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

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

متى تحتاج منفذا مختلفا؟

الأكثر شيوعا أن تكون لديك خدمة MySQL أخرى تستخدم 3306، أو تعمل بنسخة محلية ثانية حتى لا تؤثر في مشروع آخر. في هذه الحالة لا تغير مشروعا قائما عشوائيا؛ اختر منفذا متاحا وسجل إعداداته مع اسم قاعدة البيانات.

الإعداد الذي يحتاجه ووردبريس

احفظ نسخة من ملف wp-config.php أولا. ستجده في المجلد الرئيسي للموقع بجانب مجلدات ووردبريس. الأسطر التالية مثال توضيحي؛ استخدم أسماء القاعدة والمستخدم وكلمة المرور الخاصة ببيئتك، ولا تستبدلها بالقيم المكتوبة هنا:

define( 'DB_NAME', 'gzkhabar_local' );
define( 'DB_USER', 'local_user' );
define( 'DB_PASSWORD', 'local_password' );
define( 'DB_HOST', '127.0.0.1:3308' );

النقطة المهمة هي السطر الأخير: نضع المضيف والمنفذ معا. توثيق ووردبريس يورد الصيغة نفسها للمنافذ البديلة مثل 127.0.0.1:3307.

لماذا نستخدم 127.0.0.1 بدل localhost في هذا المثال؟

كلاهما يعمل في حالات كثيرة، لكن 127.0.0.1:3308 يوضح أننا نريد اتصال TCP إلى هذا المنفذ تحديدا. في بعض البيئات يعامل النظام localhost بطريقة مختلفة أو يحاول استخدام socket؛ لذلك يكون العنوان الرقمي مفيدا عند تشخيص مشكلة المنفذ المحلي.

خطوات اختبار مرتبة

1. شغل MySQL على المنفذ الذي اخترته وتأكد أنه يستمع على 127.0.0.1 فقط.
2. إذا كنت تنشئ موقعا محليا جديدا، أنشئ له قاعدة فارغة بترميز utf8mb4 الذي يدعم العربية والرموز. أما الموقع المثبت مسبقا، فاربطه بقاعدته الصحيحة ولا تستبدلها بقاعدة فارغة.
3. ضع اسم القاعدة والمستخدم وكلمة المرور وDB_HOST في wp-config.
4. افتح الموقع المحلي. إذا كانت هذه أول مرة، سيظهر تثبيت ووردبريس؛ وإذا كان مثبتا ستفتح الصفحة أو الإدارة.
5. تحقق من خدمة MySQL نفسها بأمر بسيط مثل SELECT VERSION(); بدل افتراض أنها ما زالت تعمل.

نتيجة تجربتنا

بدأنا خدمة MySQL 8.4.3 على 127.0.0.1:3308، وأنشأنا قاعدة gzkhabar_local بترميز utf8mb4، ثم حدثنا DB_HOST. بعدها شغلنا ووردبريس، أنشأنا صفحات الموقع والمقالات، وفحصنا الصفحة الرئيسية فاستجابت برمز 200.

أخطاء شائعة

• تغيير المنفذ في MySQL ونسيان wp-config: سيستمر ووردبريس في محاولة المنفذ القديم.
• تشغيل خدمة ثم إغلاقها: ظهور «Error establishing a database connection» قد يعني ببساطة أن MySQL متوقفة.
• استخدام root بلا كلمة مرور في موقع حي: هذا غير مقبول في الاستضافة. أنشئ مستخدما محدود الصلاحيات وكلمة مرور قوية لكل قاعدة إنتاج.
• فتح MySQL على الشبكة دون حاجة: في جهاز التطوير اربطها بـ 127.0.0.1 ما لم تكن تحتاج وصولا شبكيا وتفهم تبعاته.
• نسخ wp-config المحلي إلى الخادم: ملف الإنتاج يحتاج بياناته ومفاتيحه وأوضاعه الخاصة، ولا يحمل عناوين localhost أو إعدادات debug المحلية.

هل أعدل wp-config من لوحة ووردبريس؟

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

تفاصيل التجربة ونتيجتها

تاريخ التجربة: 18 أغسطس 2026؛ ووردبريس: 7.0.4؛ PHP: 8.3.33؛ مكان التنفيذ وأدواته: MySQL 8.4.3 محلي على 127.0.0.1:3308.

بعد ربط DB_HOST بالمنفذ 3308 أعادت الصفحة الرئيسية HTTP 200. قبل تشغيل خدمة MySQL ظهر خطأ الاتصال المعتاد من ووردبريس.

تحقق إضافي، 19 أغسطس 2026: قرأنا المضيف من إعداد البيئة دون عرض أي كلمة مرور، ثم نفذنا SELECT 1 عبر اتصال ووردبريس نفسه. نجاح SELECT 1 يثبت الاتصال في هذا المختبر، ولا يثبت نجاح كل الاستعلامات أو صلاحيات موقعك الإنتاجي.

المصدر الرسمي

• WordPress: إعداد DB_HOST واستخدام منفذ MySQL بديل.