تثبيت وتكوين OctoberCMS في بيئة ServBay

نظرة عامة

OctoberCMS هو نظام إدارة محتوى مفتوح المصدر يُبنى على إطار Laravel القوي، ويشتهر ببساطته ومرونته وصداقته للمطورين. يهدف هذا الدليل إلى إرشادك لكيفية تثبيت وتكوين OctoberCMS بنجاح في ServBay، الذي يمثل بيئة تطوير ويب محلية متكاملة صُممت لنظام macOS، حتى تبدأ بسرعة في تطوير مشاريعك باستخدام OctoberCMS.

ما هو OctoberCMS؟

يوفر OctoberCMS لوحة تحكم خلفية بديهية وقدرات تطوير أمامية قوية. يسمح للمطورين باستخدام مفاهيم Laravel المألوفة مثل Eloquent ORM ومحرك قوالب Blade لبناء جميع أنواع المواقع، من المدونات البسيطة إلى حلول الشركات المعقدة.

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

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

1. نظام macOS لديك مثبت عليه ServBay ويعمل.
2. تم تفعيل حزم PHP (يفضل 7.4 أو أعلى) وMySQL/MariaDB ضمن ServBay وتعمل.
3. تم تفعيل حزمة Composer في ServBay.
4. لديك معرفة أساسية باستخدام سطر الأوامر.

خطوات تثبيت OctoberCMS

فيما يلي الخطوات التفصيلية لتثبيت وتكوين OctoberCMS في بيئة ServBay:

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

أولاً، انتقل إلى مجلد الجذر للمواقع المقترح من ServBay /Applications/ServBay/www، وأنشئ مجلدًا جديدًا لمشروع OctoberCMS الخاص بك.

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

الخطوة 2: تثبيت OctoberCMS باستخدام Composer

ServBay مزود مسبقًا ومهيأ بحزمة Composer. تأكد من تمكين Composer من لوحة تحكم ServBay. الآن ومن داخل مجلد المشروع الذي أنشأته، نفّذ أمر Composer لتنزيل وتثبيت ملفات OctoberCMS الأساسية:

composer create-project october/october .

سيقوم هذا الأمر بتنزيل أحدث إصدار من OctoberCMS من المخزن الرسمي مباشرة إلى المجلد الحالي (.).

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

يحتاج OctoberCMS إلى قاعدة بيانات لتخزين المحتوى والمستخدمين والإعدادات وغيرها. سنستخدم أداة phpMyAdmin المرفقة مع ServBay لإنشاء قاعدة البيانات والمستخدم المطلوبين.

1. الدخول إلى أداة phpMyAdmin الخاصة بـ ServBay

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

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

   من المستحسن أمنيًا إنشاء مستخدم وقاعدة بيانات منفصلين لكل تطبيق.

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

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

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

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

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

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

لتتمكن من الوصول إلى تطبيق OctoberCMS عبر المتصفح، عليك إضافة موقع جديد في ServBay.

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

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

   أدخل المعلومات التالية:

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

2. حفظ التكوين وإعادة تشغيل ServBay

   بعد إكمال الإعدادات، انقر على زر الحفظ. قد تظهر رسالة تطلب منك إعادة تشغيل الحزم ذات العلاقة مثل Caddy أو Nginx وأيضًا ServBay لضمان تفعيل التغييرات. نفّذ ما يُطلب منك. سيقوم ServBay تلقائيًا بربط اسم النطاق servbay-octobercms.local بعنوان الجهاز المحلي (127.0.0.1).

الخطوة 5: إعداد متغيرات بيئة OctoberCMS

يعتمد OctoberCMS (كونه مبنيًا على Laravel) على ملف .env لإدارة متغيرات البيئة، مثل معلومات الاتصال بقاعدة البيانات، ومفتاح التطبيق، وغير ذلك.

1. نسخ ملف الإعداد البيئي الافتراضي

   من جذر مشروع OctoberCMS (/Applications/ServBay/www/servbay-octobercms-app)، انسخ ملف .env.example وأعد تسميته إلى .env:

   cd /Applications/ServBay/www/servbay-octobercms-app
   cp .env.example .env

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

   افتح ملف .env الجديد باستخدام محرر النصوص المفضل لديك. حدد إعدادات الاتصال بقاعدة البيانات وعدّلها بناءً على تفاصيل قاعدة البيانات والمستخدم الذين أنشأتهم في الخطوة 3:

   # ... إعدادات أخرى ...
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=october_user  # استبدله باسم قاعدة البيانات التي أنشأتها
   DB_USERNAME=october_user  # استبدله باسم المستخدم الذي أنشأته
   DB_PASSWORD=password123   # استبدله بكلمة المرور التي اخترتها
   
   # ... إعدادات أخرى ...

   هام: تأكد من استبدال القيم DB_DATABASE وDB_USERNAME وDB_PASSWORD بالتفاصيل الدقيقة التي أنشأتها في الخطوة 3.

الخطوة 6: تشغيل معالج تثبيت OctoberCMS

يقدّم OctoberCMS معالج تثبيت عبر الويب لإكمال الإعداد، كتهيئة قاعدة البيانات وإنشاء الحساب الإداري.

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

   افتح المتصفح وادخل اسم النطاق الذي أعددته في الخطوة 4، متبوعًا بمسار /install.php، مثلاً:

   https://servbay-octobercms.local/install.php

   يفترض أن تظهر لك صفحة معالج تثبيت OctoberCMS.

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

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

   • نوع قاعدة البيانات: MySQL
   • مضيف قاعدة البيانات: localhost أو 127.0.0.1
   • اسم القاعدة: october_user
   • اسم المستخدم: october_user
   • كلمة المرور: password123

   (مرة أخرى، استخدم كلمة المرور الحقيقية التي اخترتها)

3. تعبئة بيانات الحساب الإداري

   تابع الخطوات وأدخل البيانات الخاصة بحساب المدير الذي ستستخدمه للدخول إلى لوحة تحكم OctoberCMS: اسم المستخدم، كلمة المرور، البريد الإلكتروني، إلخ.

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

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

الخطوة 7: تثبيت الإضافات والقوالب (اختياري)

بعد اكتمال التثبيت، يمكنك تسجيل الدخول إلى لوحة التحكم الخلفية لـ OctoberCMS (https://servbay-octobercms.local/backend).

1. تثبيت إضافات

   من داخل لوحة التحكم، توجّه إلى "النظام" ← "التحديث" ← "الإضافات". يمكنك البحث وتثبيت إضافات متنوعة من Marketplace لتوسيع وظائف موقعك.

2. تثبيت القوالب

   انتقل إلى "النظام" ← "التحديث" ← "القوالب". تصفح وثبّت القالب الذي يناسب مشروعك.

الإعداد والاستخدام الأساسي بعد التثبيت

بعد التثبيت الناجح لـ OctoberCMS، يمكنك البدء في بناء موقعك مباشرة. وفيما يلي بعض الخطوات والوظائف الأساسية:

• دخول الواجهة الأمامية: من خلال اسم النطاق المحلي https://servbay-octobercms.local/ يمكنك رؤية الصفحة الرئيسية (عادةً القالب الافتراضي).
• دخول لوحة التحكم الخلفية: انتقل إلى https://servbay-octobercms.local/backend وسجّل دخولك بالحساب الإداري الذي أنشأته أثناء التثبيت.
• إنشاء صفحات: من لوحة التحكم: "CMS" ← "صفحات" يمكنك إنشاء وتحرير صفحات الموقع.
• إضافة محتوى قابل لإعادة الاستخدام: من "CMS" ← "المحتوى" يمكنك إضافة أجزاء محتوى تُستخدم عدة مرات بالموقع.
• تكوين القالب: من "CMS" ← "القوالب" يمكنك ضبط الإعدادات والتخطيطات والأجزاء المستخدمة في القالب الحالي.
• إدارة المستخدمين والصلاحيات: من "النظام" ← "الإدارة" يمكنك إدارة مشرفي النظام وصلاحياتهم.

الأسئلة المتكررة (FAQ)

• س: عند الدخول إلى servbay-octobercms.local تظهر صفحة ServBay الافتراضية أو خطأ؟
  • ج: تحقق من إضافة موقع servbay-octobercms.local بنجاح في لوحة تحكم ServBay، وأن المجلد الجذري يشير إلى /Applications/ServBay/www/servbay-octobercms-app. تأكد من إعادة تشغيل ServBay بعد إضافة/تعديل إعدادات الموقع. تحقق من أن Caddy/Nginx وPHP يعملان بشكل صحيح.
• س: عند فتح https://servbay-octobercms.local/install.php تظهر صفحة فارغة أو خطأ؟
  • ج: عادةً ما يعود السبب إلى أخطاء PHP. راجع سجل الأخطاء الخاص بـ PHP عبر لوحة تحكم ServBay. من الأسباب الشائعة: صلاحيات الملفات (تأكد أن مجلدات storage، themes، وplugins قابلة للكتابة من قبل خادم الويب)، إصدار PHP غير متوافق، أو نقص إضافات PHP اللازمة.
• س: ظهر خطأ اتصال بقاعدة البيانات أثناء التثبيت؟
  • ج: دقّق جيدًا بيانات الاتصال في ملف .env (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD) أنها تطابق تمامًا ما أنشأته في phpMyAdmin. تأكد من أن MySQL/MariaDB تعمل ضمن ServBay.
• س: فشل أمر composer create-project؟
  • ج: تأكد من تفعيل حزمة Composer وPHP بالإصدار الصحيح في لوحة تحكم ServBay، وأن الاتصال بالإنترنت متوفر حيث يحتاج Composer لتنزيل الملفات.

الخلاصة

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