تثبيت وتكوين ExpressionEngine CMS في بيئة ServBay المحلية

نظرة عامة

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

أما ServBay فهو بيئة تطوير ويب محلية متكاملة مصممة خصيصاً لنظام macOS، حيث يوفر حلاً شاملاً يدمج بين أشهر خوادم الويب (مثل Nginx, Caddy, Apache)، بيئات تشغيل لغات البرمجة (PHP, Node.js, Python, Go, Java, Ruby, Rust, .NET)، قواعد البيانات (MySQL, PostgreSQL, MongoDB, Redis)، وأدوات المطورين (Composer, npm/yarn, phpMyAdmin/Adminer). باستخدام ServBay، يمكن للمطورين تثبيت وإدارة بيئة التطوير المحلية بسهولة كبيرة.

يستعرض هذا الدليل خطوة بخطوة كيفية تثبيت وتكوين ExpressionEngine في بيئة ServBay، لمساعدتك في بدء مشروعك بسهولة وسرعة.

لماذا استخدام ServBay لتثبيت ExpressionEngine؟

يوفر تثبيت ExpressionEngine محلياً باستخدام ServBay العديد من الفوائد:

• تكامل البيئة: يوفر ServBay كل ما يلزم من بيئة PHP، وقاعدة بيانات MySQL، وخادم ويب دون الحاجة للتثبيت المنفصل لكل مكون.
• دعم عدة إصدارات: يمكنك بسهولة تغيير أو اختيار إصدار PHP المناسب لمتطلبات إصدار ExpressionEngine الخاص بك داخل ServBay.
• إدارة قواعد بيانات سهلة: يأتي ServBay مدمجاً مع phpMyAdmin أو Adminer، مما يسهل إنشاء وإدارة قواعد بيانات ExpressionEngine.
• تهيئة مواقع ببساطة: يمكنك إعداد موقع جديد وربطه بمجلد المشروع في ExpressionEngine باستخدام واجهة ServBay الرسومية بكل سهولة.
• العزل والإدارة: يسمح لك ServBay بإنشاء إعدادات مستقلة لكل مشروع، لمنع تضارب البيئات بين المشاريع المختلفة.

المتطلبات المسبقة

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

1. أن يكون ServBay مثبتاً ومشغلاً على جهاز macOS الخاص بك. إذا لم يكن مثبتًا، توجه إلى الموقع الرسمي لـ ServBay للحصول على دليل التثبيت.
2. معرفة أساسية باستخدام سطر الأوامر في الطرفية.
3. فهم أساسي لمفاهيم قواعد البيانات (مثل قاعدة البيانات والمستخدم).
4. توفر صلاحيات الكتابة على مجلد الجذر الافتراضي لمواقع ServBay وهو /Applications/ServBay/www.

خطوات التثبيت

سنتبع الخطوات التالية لتثبيت وتكوين ExpressionEngine في بيئة ServBay.

الخطوة 1: تجهيز مجلد المشروع وتنزيل ExpressionEngine

أولاً، افتح تطبيق الطرفية (Terminal). انتقل إلى مجلد المواقع الافتراضي لـ ServBay /Applications/ServBay/www، ثم أنشئ مجلد مشروع جديد (مثلاً servbay-ee-app)، وادخل إليه.

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

بعد ذلك، استخدم أمر curl لتنزيل أحدث نسخة من ExpressionEngine إلى نفس المجلد. الخيار -L لمتابعة التحويلات، و -o لتحديد اسم الملف.

curl -L https://expressionengine.com/latest -o expressionengine.zip

الخطوة 2: فك ضغط ملفات ExpressionEngine

بعد اكتمال التنزيل، استخدم أمر unzip لفك ضغط ملف expressionengine.zip داخل مجلد servbay-ee-app. بعد الاكتمال، يُفضل حذف الملف المضغوط للتوفير في المساحة.

unzip expressionengine.zip
rm expressionengine.zip

ستجد الآن ملفات ExpressionEngine داخل مجلد المشروع servbay-ee-app.

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

يحتاج ExpressionEngine إلى قاعدة بيانات لتخزين البيانات والإعدادات. ServBay يوفر لك MySQL وphpMyAdmin لإدارة قواعد البيانات بسهولة.

1. الدخول إلى أداة إدارة قواعد البيانات المدمجة (phpMyAdmin)

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

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

   بعد الدخول، سننشئ مستخدماً وقاعدة بيانات مخصصة لـ ExpressionEngine.

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

   بذلك أصبح لديك قاعدة بيانات باسم ee_user ومستخدم بنفس الاسم لديه جميع صلاحيات الوصول.

الخطوة 4: إعداد الموقع ضمن ServBay

الآن نحتاج أن نحدد لـ ServBay كيف يتعامل مع النطاقات المحلية (مثل servbay-ee.local) ويوجهها لمجلد مشروع ExpressionEngine.

1. افتح ServBay وأضف موقعًا جديدًا

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

   • الاسم: سمِّ إعداد الموقع باسم سهل التمييز (مثلاً My ExpressionEngine Site).
   • النطاق (Domain): أدخل اسم النطاق المحلي الذي ترغب باستخدامه (مثلاً servbay-ee.local). سيضيف ServBay هذا النطاق تلقائياً لملف hosts ويجعله يشير على العنوان المحلي 127.0.0.1.
   • نوع الموقع: اختر PHP لأن ExpressionEngine يعمل على PHP.
   • إصدار PHP: اختر إصدار متوافق مع نسخة ExpressionEngine التي لديك. يمكنك تغيير الإصدار حسب الحاجة.
   • جذر الموقع: اختر المجلد الذي أنشأته سابقاً (/Applications/ServBay/www/servbay-ee-app).
   • خادم الويب: يمكنك اختيار أي خادم ويب مدعوم (Nginx, Caddy, Apache). الإعدادات الافتراضية تكفي لاستخدام محلي.

2. حفظ وتطبيق الإعدادات

   بعد ملء كل الحقول، اضغط "حفظ" أو "تطبيق". ربما يحتاج ServBay لإعادة تشغيل خوادم الويب. وافق على إعادة التشغيل وانتظر حتى يكتمل.

   الآن، عند زيارة https://servbay-ee.local/ في متصفحك، سيتم توجيهك إلى مجلد مشروع ExpressionEngine تلقائياً.

الخطوة 5: تشغيل برنامج تثبيت ExpressionEngine عبر الويب

يتيح ExpressionEngine برنامج تثبيت عبر المتصفح يرشدك خطوة بخطوة عبر الإعدادات النهائية.

1. زيارة صفحة التثبيت

   افتح متصفحك وادخل اسم النطاق الذي أعددته، وأضف إليه ملف الدخول إلى برنامج التثبيت admin.php. في الوضع الافتراضي يكون العنوان كالتالي:

   https://servbay-ee.local/admin.php

   يجب أن ترى الآن صفحة الترحيب أو دليل التثبيت الخاص بـ ExpressionEngine.

2. إكمال بيانات الإرشاد

   سيتطلب منك معالج التثبيت إدخال معلومات أساسية، منها:

   • بيانات قاعدة البيانات:
     • مضيف القاعدة (Database Host): localhost
     • اسم القاعدة (Database Name): ee_user (كما أنشأتها في الخطوة الثالثة)
     • اسم المستخدم (Database Username): ee_user
     • كلمة المرور (Database Password): كلمة المرور التي حددتها سابقًا
   • بيانات المدير: اختر كلمة مرور قوية وبيانات للمشرف الرئيسي.
   • إعدادات الموقع: الاسم، الرابط، إلخ.

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

   راجع معلوماتك، ثم اضغط "تثبيت" أو زر الإكمال. سيقوم ExpressionEngine بإنشاء الجداول الضرورية وإكمال الإعداد.

   بعد الانتهاء، ستنتقل غالباً إلى صفحة تسجيل الدخول أو لوحة التحكم.

الخطوة 6: الضبط الأساسي بعد التثبيت

بعد تثبيت ExpressionEngine الأساسي، يمكنك متابعة تثبيت الإضافات والقوالب وإجراء الضبط المطلوب.

1. تسجيل الدخول للوحة التحكم

   من خلال اسم النطاق الذي أنشأته (مثلاً https://servbay-ee.local/admin.php)، سجل دخولك بحساب المشرف الذي أنشأته أثناء التثبيت.

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

   من لوحة التحكم، انتقل إلى "المطور" -> "الإضافات" -> "الإضافات". يمكنك مراجعة وتثبيت الإضافات حسب حاجتك.

3. إضافة وتهيئة القوالب

   من "تصميم" -> "قوالب". يمكنك هنا إنشاء قوالب أو مجموعات قوالب، وكتابة كود HTML/CSS/EE لتنسيق وعرض محتوى الموقع.

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

بعد التثبيت والتكوين بنجاح، يمكنك البدء باستخدام ExpressionEngine لتطوير وإدارة محتوى موقعك. فيما يلي ملخص لأهم الخطوات الابتدائية:

إنشاء القنوات والمشاركات

جوهر ExpressionEngine يعتمد على "القناة" و"المشاركة": القناة تحدد نوع وهيكل البيانات، وكل مشاركة تمثل وحدة محتوى فعلية.

1. إنشاء قناة: من لوحة التحكم، انتقل إلى "هيكل المحتوى" -> "إدارة القنوات". اضغط "إنشاء قناة جديدة"، وادخل اسم القناة، ومجموعة الحقول، ثم "حفظ".
2. إنشاء مشاركة: من "المحتوى" -> "نشر". اختر القناة التي أنشأتها، واملأ الحقول، ثم اضغط "حفظ".

ضبط قائمة التصفح (القوائم)

عادةً تنفذ قوائم التصفح عبر القوالب.

1. إنشاء أو تحرير قالب: من "تصميم" -> "قوالب"، أنشئ أو حرر قالبًا مخصصًا للنافجيشن (مثلاً site:nav).
2. كتابة كود القائمة: استخدم وسوم قوالب ExpressionEngine للحصول على المشاركات أو الصفحات المطلوبة وإنشاء هيكل HTML للقائمة.
3. إدراج القائمة في التصميم: يمكنك تضمين القالب في قوالب الصفحة الرئيسية (مثلاً {% include 'site:nav' %} إذا كنت تستخدم Blade أو عبر الوسوم المتاحة في ExpressionEngine).

تخصيص الويدجت (الأدوات الجانبية)

بنفس منطق القوائم، تنشأ مناطق الأدوات الجانبية عن طريق إنشاء قوالب فرعية.

1. إنشاء قالب ويدجت: من "تصميم" -> "قوالب"، أنشئ قالبًا للأدوات الجانبية (مثلاً site:sidebar).
2. كتابة كود الويدجت: صمم مكونات مثل أحدث المشاركات أو الإعلانات وغيرها.
3. تضمين الأداة في الصفحة: استخدم وسوم القوالب لإظهارها في المكان المناسب داخل التصميم العام.

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

• س: عند الدخول لـ https://servbay-ee.local/ تظهر رسالة خطأ في الصلاحيات، ماذا أفعل؟
  • ج: تحقق من صلاحيات الوصول وملكية الملفات داخل مجلد (/Applications/ServBay/www/servbay-ee-app). تأكد أن المستخدم الذي يعمل به ServBay لديه صلاحية القراءة والكتابة. ربما عليك استخدام chmod أو chown لتعديل المالك/الصلاحيات، مثلاً: sudo chown -R yourusername:yourgroup /Applications/ServBay/www/servbay-ee-app
• س: معالج تثبيت ExpressionEngine يقول أنه لا يمكن الاتصال بقاعدة البيانات؟
  • ج: تأكد من صحة بيانات الاتصال بقاعدة البيانات (localhost، اسم القاعدة، اسم المستخدم، كلمة المرور) ومطابقتها لما أنشأته في phpMyAdmin. تأكد كذلك من تشغيل خدمة MySQL/MariaDB في ServBay.
• س: هل يمكنني استخدام قواعد بيانات أخرى (مثل PostgreSQL) مع ServBay؟
  • ج: يدعم ExpressionEngine بشكل رئيسي MySQL/MariaDB. إذا دعم رسميًا PostgreSQL ووفرت بنفسك التهيئة المطلوبة وتعريف السائق، يمكنك تجربة ذلك باستخدام PostgreSQL الخاص بـ ServBay، لكن ذلك يعتمد كلياً على توافق ExpressionEngine. راجع مستندات ExpressionEngine لمعرفة الدعم الكامل لقواعد البيانات.

الخلاصة

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