تثبيت وتكوين Craft CMS في بيئة ServBay

نظرة عامة

يُعد Craft CMS نظام إدارة محتوى قوي ومرن (CMS) يُفضله المطورون لما يقدمه من إمكانيات متقدمة في نمذجة المحتوى، وواجهة مستخدم بديهية، وميزات صديقة للمطورين. وهو مثالي لبناء مواقع معقدة ومخصصة بالكامل.

عند استخدام ServBay كبيئة تطوير محلية لمواقع Craft CMS، ستستفيد من العديد من المزايا، كتوفر PHP مُعد مسبقًا، وقواعد البيانات (مثل MySQL أو PostgreSQL)، وخوادم ويب (Caddy أو Nginx)، بالإضافة إلى Composer وأدوات سطر الأوامر المدمجة، ما يُسهّل كثيرًا عملية التثبيت والإعداد.

هذا الدليل يشرح خطوة بخطوة كيفية تثبيت وتكوين مشروع Craft CMS ضمن بيئة ServBay.

المتطلبات

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

1. تثبيت ServBay وتشغيله: تحقق من أنك قمت بتثبيت ServBay بنجاح على macOS، وأن إصدار PHP المطلوب (لمعرفة متطلبات الإصدار راجع دليل Craft CMS الرسمي) وقاعدة البيانات المرغوبة (عادة MySQL أو PostgreSQL) نشطة. يدعم ServBay عدة إصدارات من PHP وقواعد بيانات، ويمكنك التبديل بينها حسب متطلبات Craft CMS بسهولة.
2. معرفة أساسيات التعامل مع سطر الأوامر: ستحتاج إلى تنفيذ بعض الأوامر عبر Terminal، مثل إنشاء مجلد وتشغيل Composer.
3. الإلمام بـ Composer: يستخدم Craft CMS أداة Composer لإدارة الاعتمادات. يحتوي ServBay على Composer مثبت مسبقًا، لكن عليك معرفة كيفية تنفيذ أمر composer create-project.

خطوات تثبيت Craft CMS

إليك الخطوات التفصيلية لتثبيت وتكوين Craft CMS في بيئة ServBay:

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

ابدأ بإنشاء مجلد جديد لمشروعك ضمن دليل الويب الافتراضي لـ ServBay: /Applications/ServBay/www. يُعد هذا المجلد الدليل الرئيسي الذي تم ضبطه ليخدم المواقع، ما يسمح بالوصول المباشر لمشروعك.

افتح الطرفية ونفذ الأوامر التالية:

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

بهذا، سيتم إنشاء مجلد باسم servbay-craft-app داخل /Applications/ServBay/www والدخول إليه مباشرة.

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

بما أن Composer مدمج بالفعل في ServBay، يمكنك استخدامه لتثبيت Craft CMS ضمن مجلد المشروع. يوصى دائمًا باستخدام Composer لتنصيب Craft CMS.

داخل مجلد servbay-craft-app نفذ الأمر:

composer create-project craftcms/craft .

سيقوم هذا الأمر بتنزيل أحدث إصدار من Craft CMS وكل الحزم التابعة في نفس المجلد الحالي (.). انتظر بصبر حتى ينتهي Composer من التحميل والتثبيت.

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

يحتاج Craft CMS إلى قاعدة بيانات لتخزين المحتوى والإعدادات. سنستخدم أداة phpMyAdmin أو Adminer المضمنة مع ServBay لإنشاء قاعدة البيانات والمستخدم. المثال هنا سيُركز على phpMyAdmin.

1. الدخول إلى phpMyAdmin المدمج مع ServBay

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

   ملاحظة: اسم المستخدم الافتراضي للولوج إلى phpMyAdmin في ServBay عادةً ما يكون root وكلمة المرور الافتراضية ServBay.dev. لأسباب أمنية، ينصح بتغيير كلمة مرور المستخدم root أو إنشاء مستخدم مدير جديد فورًا بعد تسجيل الدخول.

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

   حتى وإن كان بالإمكان استخدام حساب root مع Craft CMS، إلا أن الأفضل أمنيًا وعمليًا إنشاء مستخدم مستقل لكل تطبيق.

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

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

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

      اضغط "إضافة حساب مستخدم". ثم أدخل المعلومات التالية:

      • اسم المستخدم: مثل craft_user (مخصص لربط Craft بقاعدة البيانات)
      • اسم المضيف: اختر localhost للدلالة على أن الاتصال محلي فقط.
      • كلمة المرور: اختر كلمة مرور قوية (لا تستخدم مثال password123، خاصة بيئة الإنتاج. في التطوير المحلي يمكن استخدام كلمة بسيطة، لكن لا تنس القواعد الأمنية).
      • إعادة إدخال كلمة المرور: للتأكيد.
      • في قسم "قاعدة البيانات لهذا المستخدم"، اختر "إنشاء قاعدة بيانات بنفس اسم المستخدم ومنحه كافة الصلاحيات". ستُنشئ بذلك قاعدة بيانات باسم craft_user ويُمنح هذا المستخدم كافة الصلاحيات عليها تلقائيًا.
      • تأكد من تفعيل خيار "منح كافة الصلاحيات".
      • في أسفل الصفحة، اضغط على زر "تنفيذ".

   الآن لديك مستخدم قاعدة بيانات جديد باسم craft_user وقاعدة بيانات بنفس الاسم وجميع الصلاحيات اللازمة.

الخطوة 4: ضبط خادم الويب (إنشاء موقع جديد في ServBay)

حتى يستطيع خادم الويب (Caddy أو Nginx) العمل على مشروعك Craft CMS، عليك تسجيل إعدادات "موقع" جديدة داخل ServBay.

1. شغّل تطبيق ServBay

   قم بفتح تطبيق ServBay.

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

   من شريط التنقل الأيسر، اختر تبويب "المواقع" (قد يظهر اسمه كـ"المضيف" في بعض الإصدارات). ثم اضغط على زر "+" أو "إضافة موقع" لإدخال موقع جديد.

   أدخل التفاصيل التالية:

   • الاسم: اختر اسمًا واضحًا مثل My Craft Site.
   • النطاق: اكتب النطاق المطلوب للاستخدام المحلي مثل servbay-craft.local. سيقوم ServBay بضبط DNS تلقائيًا لتتمكن من الدخول عبر هذا النطاق.
   • نوع الموقع: اختر PHP.
   • إصدار PHP: اختر إصدار PHP المتوافق مع Craft CMS (والذي تحققنا منه في المتطلبات). يتيح ServBay تثبيت وإدارة عدة إصدارات PHP.
   • جذر الموقع: هذه خطوة مهمة جدًا. ملفات Craft العامة توجد في مجلد web داخل مشروعك وليس المجلد الجذري نفسه. يجب أن يشير جذر الموقع هنا إلى: /Applications/ServBay/www/servbay-craft-app/web تأكد أن المسار صحيح ويشير إلى مجلد web الخاص بمشروعك.

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

   بعد ملء جميع الحقول، اضغط زر "حفظ". سيتم تحديث إعدادات خادم الويب تلقائياً وستظهر في قائمة المواقع اسم ونطاق المشروع الذي أضفته مثل servbay-craft.local.

الخطوة 5: تشغيل مثبت Craft CMS

أصبح بإمكانك الآن الدخول لمثبت Craft CMS من المتصفح عبر النطاق المحلي الذي قمت بتكوينه.

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

   افتح المتصفح وانتقل إلى النطاق https://servbay-craft.local/. سيكتشف Craft CMS أن التثبيت غير مكتمل ويعيد توجيهك تلقائيًا إلى موقع التثبيت غالبًا: https://servbay-craft.local/index.php?p=admin/install.

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

   في خطوة ضبط قاعدة البيانات، أدخل بياناتك التي أنشأتها سابقًا كالآتي:

   • مخدم قاعدة البيانات: localhost
   • اسم قاعدة البيانات: craft_user (أو الاسم الذي أنشأته)
   • اسم المستخدم: craft_user
   • كلمة المرور: الكلمة التي حددتها لهذا المستخدم.

   ثم تابع. إذا تم الاتصال بنجاح، ستنتقل للخطوة الموالية.

3. إنشاء حساب المدير

   أكمل المعلومات المطلوبة لإنشاء حساب مسؤول Craft CMS باختيار اسم مستخدم، كلمة مرور، وبريد إلكتروني. يُفضل اختيار كلمة مرور قوية.

   ثم تابع.

4. ضبط إعدادات الموقع

   أضف اسم الموقع والمعلومات الأساسية.

   اضغط زر "إكمال التثبيت (Finish Up)". سيقوم Craft CMS بإعداد الجداول وتوليد ملفات الإعداد بشكل تلقائي.

   بعد الانتهاء ستُوجَه مباشرة لصفحة تسجيل الدخول لإدارة Craft CMS.

الخطوة 6: الضبط الأولي والاستكشاف

بعد الدخول للوحة إدارة Craft CMS يمكنك إجراء بعض الإعدادات أو التعرف على المنصة:

1. تحقق من ملف .env: يدير Craft CMS متغيرات البيئة مثل إعدادات الاتصال بقاعدة البيانات عبر ملف .env الذي يُنشئ تلقائيًا في جذر المشروع (servbay-craft-app/). يمكنك تعديل هذا الملف، مثل تحديد قيمة CRAFT_ENVIRONMENT إلى dev لكونه بيئة تطوير.
2. تثبيت الإضافات: من لوحة التحكم، اختر "الإضافات (Plugins)" لاستعراض أو تثبيت أو إدارة الإضافات لتوسيع وظائف Craft.
3. بناء الهيكلية: استكشف قسم "الإعدادات (Settings)" لبناء الحقول والأقسام (Sections)، والتصنيفات (Categories)، والوسوم (Tags) وغير ذلك.
4. إعداد البريد: إذا رغبت باختبار إرسال البريد محليًا، يمكنك ضبط Craft لاستخدام أدوات البريد المحلي المدمجة في ServBay مثل Mailpit أو Mailhog سواء عبر ملف .env أو من إعدادات البريد في لوحة الإدارة، حيث يكون الخادم عادةً localhost والمنفذ حسب إعدادات الأداة (تجد المنفذ معروضًا في لوحة ServBay).

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

• س: ماذا أفعل إذا ظهرت مشكلة في الاتصال بقاعدة البيانات أثناء التثبيت؟
  • ج: تحقق من صحة معلومات الاتصال التي أدخلتها (العنوان localhost، اسم القاعدة، المستخدم، كلمة المرور) وتوافقها تمامًا مع البيانات التي أنشأتها في phpMyAdmin. أيضًا تأكد من تشغيل خدمات قاعدة البيانات (MySQL أو PostgreSQL) داخل ServBay.
• س: تظهر صفحة 404 أو شاشة فارغة حين أدخل servbay-craft.local؟
  • ج:
    • تحقق أن جذر الموقع الذي أدخلته في إعداد الموقع يوجه بدقة إلى /Applications/ServBay/www/servbay-craft-app/web فهذه أكثر الأخطاء شيوعًا.
    • احرص أن خادم الويب (Caddy أو Nginx) وخدمات PHP في ServBay تعمل.
    • تحقق من وجود الموقع ضمن قائمة المواقع المفّعلة داخل ServBay تحت اسم servbay-craft.local.
• س: تثبيت Craft CMS عبر Composer بطيء جدًا أو يفشل؟
  • ج: غالبًا السبب شبكة الإنترنت أو مصدر Composer. يمكنك تغيير مصدر Composer إلى مرآة محلية مثل Aliyun أو Packagist China.
• س: بعد التثبيت، تفتقد لوحة الإدارة أو الموقع للأنماط (CSS) أو تظهر مشاكل بالصور؟
  • ج: السبب عادةً أذونات الملفات. تأكد أن المستخدم الذي يدير ServBay لديه صلاحيات الكتابة على مجلدات مثل storage وweb/cpresources. غالبًا يعالج ServBay الأذونات تلقائيًا، لكن إذا ظهرت المشكلة تحقق يدويًا أو أعد ضبط الصلاحيات لهذه المجلدات.

الخلاصة

باتباعك لهذه الخطوات، ستكون قد أتممت بنجاح تثبيت وتكوين Craft CMS في بيئة التطوير المحلية ServBay. تعد بيئة ServBay المتكاملة مثالية للتحكم في إصدارات PHP وإدارة قواعد البيانات وضبط خوادم الويب بسهولة، لتتمكن من التركيز على تطوير منظومتك عبر Craft CMS. والآن يمكنك الاستفادة من إمكانيات Craft المتقدمة في إدارة المحتوى لبناء موقعك أو تطبيقك بمرونة وكفاءة.