تثبيت وتهيئة Bedrock في بيئة ServBay

نظرة عامة

سيرشدك هذا الدليل خطوة بخطوة لكيفية تثبيت وتهيئة Bedrock في بيئة التطوير المحلية باستخدام ServBay. يمنحك Bedrock بنية مشاريع ووردبريس حديثة، ويوفر إدارة الاعتمادات عبر Composer، ويُحسّن من ضبط الإعدادات ويلتزم بأفضل الممارسات، مما يعزز كفاءة وأمان تطوير ونشر وصيانة مشاريع ووردبريس. وبالاقتران مع قوة وسهولة إدارة البيئة في ServBay، يمكنك البدء سريعًا في تطوير مشاريع ووردبريس مع Bedrock.

ما هو Bedrock؟

Bedrock هو هيكل مشروع ووردبريس طورته Roots بهدف تعزيز تجربة تطوير ووردبريس. يختلف بشكل ملحوظ عن بنية ووردبريس التقليدية، ويتميز بما يلي:

• إدارة الاعتماديات عبر Composer: إدارة نواة ووردبريس، والثيمات، والإضافات من خلال Composer، ما يُسهّل التحديثات وحل تعارضات الاعتماديات.
• تحسين إدارة الإعدادات: تبنّي مبدأ Twelve-Factor App مع استخدام ملف .env لإدارة متغيرات البيئة وفصل الإعدادات عن الكود مما يجعلها أكثر أمانًا ومرونة.
• تنظيم هيكلي أفضل: وضع نواة ووردبريس في مجلد فرعي مستقل (web/wp) بينما تحفظ الثيمات والإضافات في web/app لتكون البنية أوضح.
• تعزيز الأمان: توفير تدابير أمان افتراضية مثل إخفاء مسارات ملفات النواة.

Bedrock هو الخيار الأفضل لبناء تطبيقات ووردبريس أكثر قوة وسهولة صيانة وحداثة.

لماذا ServBay لتطوير Bedrock؟

ServBay هو أداة تطوير ويب محلية صممت خصيصًا لنظام macOS، وتجمع بين خوادم الويب الشائعة (Caddy/Nginx/Apache)، وإصدارات PHP متعددة، وأنظمة قواعد بيانات متنوعة (MySQL/PostgreSQL/MongoDB)، بالإضافة إلى بيئات للغات تطوير مثل Node.js وPython وGo وJava. عند استخدام ServBay مع Bedrock ستحصل على:

• إعداد بيئة سريع: ServBay يأتي مُعد مسبقًا بكل ما تحتاجه Bedrock من PHP وComposer وقواعد بيانات، لا حاجة للتثبيت أو الضبط اليدوي.
• تبديل الإصدارات بسهولة: يمكنك تبديل إصدار PHP بسلاسة لاختبار توافق Bedrock مع نسخ PHP المختلفة.
• إدارة قواعد البيانات مدمجة: أنشئ وادِر قواعد بيانات Bedrock بسهولة عبر phpMyAdmin أو Adminer المتوفرة في ServBay.
• ضبط مواقع بسيط: أنشئ مواقع Bedrock (استضافة افتراضية) ووجّهها بسرعة إلى مجلد الجذر الصحيح باستخدام واجهة ServBay الرسومية.
• إدارة موحدة: إدارة جميع الحزم والمواقع المطلوبة لتطويرك المحلي من تطبيق واحد.

المتطلبات الأساسية

قبل البدء بالتثبيت، تأكد من توفر المتطلبات التالية:

• تم تثبيت ServBay ويعمل على جهاز بنظام macOS.
• لديك معرفة أساسية باستخدام الطرفية (Terminal).
• معرفة أساسية بـ Composer (سيتم تزويدك بالأوامر اللازمة في هذا الدليل).

خطوات تثبيت Bedrock

توضح هذه الفقرة كيفية تثبيت وتهيئة مشروع Bedrock في بيئة ServBay خطوة بخطوة.

الخطوة 1: إنشاء مجلد المشروع

أولًا، انتقل إلى مجلد مواقع ServBay الافتراضي /Applications/ServBay/www وأنشئ مجلدًا جديدًا باسم وصفي مثل servbay-bedrock-app.

cd /Applications/ServBay/www
mkdir servbay-bedrock-app
cd servbay-bedrock-app

سيكون هذا المجلد هو الجذر لمشروع Bedrock الخاص بك.

الخطوة 2: إنشاء مشروع Bedrock باستخدام Composer

تم تضمين Composer مسبقًا في ServBay، لذلك يمكنك استخدام الأمر composer مباشرة من الطرفية. بينما تكون في مجلد المشروع الذي أنشأته (/Applications/ServBay/www/servbay-bedrock-app)، نفذ الأمر التالي لإنشاء مشروع Bedrock:

composer create-project roots/bedrock .

سيقوم هذا الأمر بتحميل أحدث إصدار من Bedrock وجميع الاعتمادات اللازمة إلى المجلد الحالي (.). قد يستغرق ذلك عدة دقائق حسب سرعة الإنترنت لديك.

الخطوة 3: إنشاء قاعدة بيانات ومستخدم

يحتاج Bedrock (مثل ووردبريس) إلى قاعدة بيانات لحفظ إعدادات ومحتوى الموقع. سنستخدم phpMyAdmin المتاح في ServBay لإنشاء قاعدة البيانات والمستخدم.

1. الوصول إلى phpMyAdmin في ServBay

   افتح متصفح الإنترنت واذهب إلى العنوان المحلي الافتراضي لـ ServBay https://servbay.host/. من صفحة الترحيب، انقر على رابط "phpMyAdmin" للدخول إلى صفحة إدارة قواعد البيانات.

2. إنشاء مستخدم قاعدة بيانات جديد

   يُفضل إنشاء مستخدم وقاعدة بيانات منفصلين لكل مشروع لأسباب أمنية وسهولة الإدارة.

   1. الدخول إلى صفحة حسابات المستخدمين

      في الشاشة الرئيسية لـ phpMyAdmin، من القائمة العلوية اختر "حسابات المستخدمين".

   2. إضافة مستخدم جديد

      انقر على "إضافة حساب مستخدم". ثم أدخل التفاصيل التالية:

      • اسم المستخدم: اختر اسمًا مناسبًا مثل bedrock_user.
      • اسم المضيف: اختر localhost (للسماح بالاتصال المحلي فقط).
      • كلمة المرور: أدخل كلمة مرور قوية واحفظها (يمكنك استخدام password123 لاختبار التطوير المحلي فقط، وللبيئة الحية استخدم كلمة مرور قوية وفريدة).
      • إعادة الإدخال: كرر كلمة المرور التي أدخلتها.

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

      تأكد من تفعيل خيار "منح جميع الصلاحيات" ليتمكن المستخدم من إدارة القاعدة بالكامل.

      انقر على زر "تنفيذ" أسفل الصفحة لإتمام إنشاء المستخدم والقاعدة.

الخطوة 4: تهيئة Bedrock

Bedrock يستخدم متغيرات البيئة لإدارة الإعدادات، وتُحفظ غالبًا في ملف .env في المجلد الجذري للمشروع.

1. نسخ وتعديل ملف الإعدادات

   في مجلد مشروع Bedrock (/Applications/ServBay/www/servbay-bedrock-app) ستجد ملفًا باسم .env.example. انسخه وسمّه .env:

   cp .env.example .env

   ملف .env هو الملف الفعلي للإعدادات، بينما .env.example هو للعرض ولا يحتوي على معلومات حساسة.

2. تعديل ملف .env

   افتح ملف .env في محرر النصوص المفضل لديك (كالـ VS Code أو Sublime Text أو Nano)، وابحث عن إعدادات ربط قاعدة البيانات ثم عدلها بحسب ما أنشأته في الخطوة السابقة:

   # Database
   DB_NAME='bedrock_user' # اسم قاعدة البيانات، يطابق اسم المستخدم
   DB_USER='bedrock_user' # اسم المستخدم لقاعدة البيانات
   DB_PASSWORD='password123' # كلمة مرور قاعدة البيانات
   DB_HOST='localhost' # عنوان الخادم، عادة 'localhost' في بيئة ServBay
   DB_PREFIX='wp_' # بادئة جداول ووردبريس، يمكنك تركها افتراضية أو تعديلها
   
   # WordPress Environment
   WP_ENV='development' # البيئة الحالية: development أو staging أو production
   
   # Site URLs
   WP_HOME='http://servbay-bedrock.local' # عنوان الموقع الكامل
   WP_SITEURL='${WP_HOME}/wp' # رابط مجلد نواة ووردبريس

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

   يحدد كل من WP_HOME وWP_SITEURL عنوان الدخول إلى موقعك من المتصفح. servbay-bedrock.local هو اسم شائع بيئيًا للبيئة المحلية، ويمكن تغييره حسب تفضيلك. يشير WP_SITEURL إلى مجلد نواة ووردبريس الفرعي (web/wp).

   يمكنك أيضًا إعداد خصائص Bedrock وووردبريس أخرى في ملف .env مثل إضافة ثابتات أو ضبط إعدادات البريد الإلكتروني وغير ذلك.

الخطوة 5: ضبط خادم الويب (موقع ServBay)

لتمكين خادم الويب في ServBay من تشغيل مشروع Bedrock، أضف موقعًا (مضيفًا افتراضيًا) جديدًا في التطبيق.

1. إضافة موقع جديد

   افتح تطبيق ServBay، من القائمة الجانبية اختر "المواقع"، ثم انقر على زر "+" أو "إضافة موقع". أدخل التفاصيل التالية:

   • الاسم: اسم دلالي مثل My Bedrock Site (خاص بالإدارة داخل ServBay).
   • النطاق: أدخل النطاق الذي وضعته في متغير WP_HOME بملف .env، مثل servbay-bedrock.local. سيربط ServBay هذا النطاق تلقائيًا بـ 127.0.0.1.
   • نوع الموقع: اختر PHP.
   • إصدار PHP: اختر إصدار PHP حديث ومتوافق مع Bedrock (يفضل الأحدث المتاح في ServBay).
   • مجلد الجذر للموقع: هام جدًا. الجذر لموقع Bedrock هو المجلد الفرعي web داخل مشروعك، وليس مجلد المشروع نفسه. حدّد الجذر كالتالي: /Applications/ServBay/www/servbay-bedrock-app/web.

2. حفظ الإعدادات

   بعد ملء كل الحقول، احفظ الإعدادات. سيقوم ServBay بتحديث ضبط الخادم تلقائيًا؛ إذا ظهرت رسالة تطلب إعادة التشغيل فاستجب لها.

الخطوة 6: إكمال تثبيت ووردبريس

الآن أصبح مشروع Bedrock جاهزًا، وتم ضبط الموقع في ServBay. يمكنك متابعة تثبيت ووردبريس عبر الويب بالخطوات التقليدية.

1. الدخول إلى صفحة التثبيت

   من المتصفح، اذهب إلى العنوان الذي أدخلته في WP_SITEURL بملف .env وكذلك في إعدادات موقع ServBay، مثل: http://servbay-bedrock.local/wp. إذا كان كل شيء صحيحًا ستظهر لك صفحة معالج تثبيت ووردبريس.

2. إدخال بيانات قاعدة البيانات

   سيطلب منك المعالج إدخال بيانات قاعدة البيانات. استخدم نفس البيانات التي أنشأتها في الخطوات السابقة:

   • اسم قاعدة البيانات: bedrock_user
   • اسم المستخدم: bedrock_user
   • كلمة المرور: كما أدخلتها في phpMyAdmin (مثل password123)
   • مضيف قاعدة البيانات: localhost
   • بادئة الجداول: wp_ (اتركها افتراضية عادةً)

   انقر "إرسال" ليحاول ووردبريس الاتصال بقاعدة البيانات.

3. إدخال معلومات الموقع

   إذا تم الاتصال بنجاح ستظهر صفحة إدخال معلومات الموقع كالتالي:

   • عنوان الموقع: اسم موقعك.
   • اسم المستخدم: اسم مستخدم المسؤول.
   • كلمة المرور: كلمة مرور قوية للمسؤول.
   • البريد الإلكتروني: بريد إلكتروني للمسؤول.
   • ظهور الموقع لمحركات البحث: ينصح في البيئة المحلية تفعيل خيار "منع محركات البحث من فهرسة هذا الموقع".

4. إكمال التثبيت

   انقر على "تثبيت ووردبريس". سيكتمل التثبيت وتظهر رسالة نجاح مع رابط للدخول للوحة تحكم ووردبريس.

الخطوة 7: تثبيت الثيمات والإضافات (بواسطة Composer)

Bedrock يشجع على إدارة الثيمات والإضافات بواسطة Composer بدلًا من لوحة تحكم ووردبريس.

1. إيجاد اسم حزمة Composer للثيم/الإضافة

   هناك الكثير من الثيمات والإضافات الشهيرة متوفرة كحزم Composer، وغالبًا ستجدها في Packagist (packagist.org) أو WordPress Packagist (wpackagist.org). وعادةً يكون اسم الحزمة بالشكل vendor/package-name مثل wpackagist-theme/twentytwentyone أو wpackagist-plugin/wordpress-seo.

2. تثبيت الحزمة عبر Composer

   من مجلد مشروع Bedrock (/Applications/ServBay/www/servbay-bedrock-app)، شغّل الأمر المناسب:

   لتثبيت ثيم:

   composer require wpackagist-theme/your-theme-name

   لتثبيت إضافة:

   composer require wpackagist-plugin/your-plugin-name

   استبدل your-theme-name وyour-plugin-name بالأسماء الصحيحة. ستُثبت الثيمات في web/app/themes والإضافات في web/app/plugins.

3. تفعيل الثيمات/الإضافات من لوحة تحكم ووردبريس

   سجل الدخول للوحة التحكم (http://servbay-bedrock.local/wp/wp-admin/):

   • لتفعيل ثيم: اختر "المظهر" → "الثيمات" وابحث عن ثيمك وقم بتفعيله.
   • لتفعيل الإضافة: اختر "الإضافات" → "الإضافات المنصبة" وابحث عن الإضافة ثم فعّلها.

   رغم أن Bedrock يدعم التثبيت بالطريقة التقليدية عبر رفع zip من ووردبريس، إلا أن إدارة الثيمات والإضافات عبر Composer هي الطريقة الحديثة والمفضلة.

بناء موقعك باستخدام Bedrock

لقد أعددت الآن Bedrock بنجاح في بيئة ServBay. يمكنك البدء في بناء موقعك كأي موقع ووردبريس عادي مع الاستفادة من ميزات Bedrock الحديثة:

• إنشاء الصفحات والمقالات: ادخل لوحة تحكم ووردبريس، وأضف محتوى جديدًا.
• ضبط قوائم التنقل: من المظهر → القوائم.
• تخصيص الودجتات: في المظهر → الودجتات يمكنك إدارة مناطق الموقع الجانبية.
• تطوير الثيمات والإضافات: للمطورين، يمكنك برمجة ثيماتك في web/app/themes والإضافات في web/app/plugins.
• إدارة الإعدادات: إدارة إعدادات البيئة (تطوير، تجريبي، إنتاج) من خلال ملف .env.

الأسئلة الشائعة (FAQ)

• س: تظهر رسالة 404 عند زيارة http://servbay-bedrock.local؟
  • ج: تحقق أن نطاق الموقع مضبوط في ServBay كما هو في المتصفح.
  • ج: تأكد أن مجلد الجذر في ضبط الموقع هو /Applications/ServBay/www/servbay-bedrock-app/web.
  • ج: تأكد أن خادم الويب في ServBay يعمل.
  • ج: تحقق من صحة إعداد WP_HOME في ملف .env.
• س: تظهر مشكلة ربط قاعدة البيانات عند الدخول إلى http://servbay-bedrock.local/wp؟
  • ج: تأكد من صحة قيم DB_NAME، DB_USER، DB_PASSWORD، DB_HOST في .env وأنها تطابق بيانات قاعدة البيانات التي أنشأتها في phpMyAdmin.
  • ج: تحقق من تشغيل خدمة MySQL أو قاعدة البيانات المختارة في ServBay.
  • ج: تأكد من منح جميع الصلاحيات المناسبة للمستخدم عبر phpMyAdmin.
• س: لماذا لا تظهر الثيمات/الإضافات المثبتة عبر Composer في لوحة تحكم ووردبريس؟
  • ج: إذا استخدمت Composer للتثبيت، احرص على تشغيل composer install أو composer require من مجلد المشروع.
  • ج: الثيمات المثبتة تجدها في web/app/themes والإضافات في web/app/plugins.
  • ج: ابحث عنها في "المظهر" → "الثيمات" أو "الإضافات" → "الإضافات المنصبة" وفعّلها.
• س: كيف أقوم بتحديث Bedrock أو ووردبريس أو الثيمات والإضافات؟
  • ج: استخدم أمر composer update من مجلد المشروع لتحديث الجميع، أو composer update vendor/package-name لتحديث حزمة معينة. قد تحتاج بعد ذلك لتنفيذ تحديث قاعدة البيانات من لوحة تحكم ووردبريس إذا طُلب منك ذلك.

الخلاصة

باتباع الخطوات أعلاه تكون قد أنشأت مشروع Bedrock على بيئة ServBay المحلية بنجاح. والاستفادة من بيئة التطوير الثرية وسهلة الإدارة التي يوفرها ServBay إلى جانب تدفق العمل الحديث في Bedrock تمنحك كفاءة وأمانًا عاليين في تطوير وصيانة مشاريع ووردبريس. ابدأ الآن في بناء موقع ووردبريس المقبل مستفيدا من مزايا Bedrock!