تثبيت وإعداد Contao CMS في بيئة ServBay

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

توفر ServBay بيئة متكاملة تحتوي على PHP، Composer، خدمات قواعد البيانات (مثل MySQL/MariaDB، PostgreSQL)، وخوادم الويب (Caddy، Nginx، Apache)، مما يبسط بنسبة كبيرة عملية إعداد بيئة التطوير المحلية. عبر ServBay تستطيع تلبية جميع متطلبات تشغيل Contao بسهولة.

ما هو Contao؟

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

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

قبل بدء تثبيت Contao، تأكد من تحقق ما يلي:

1. تثبيت وتشغيل ServBay: يجب أن يكون لديك ServBay منصبًا على جهازك بنظام macOS. تأكد من تشغيل ServBay، وتفعيل إصدار PHP المطلوب (تحقق من المتطلبات الرسمية لـ Contao لأحدث الشروط)، بالإضافة إلى تفعيل خدمة قاعدة البيانات (مثل MySQL أو MariaDB) ضمن ServBay.
2. Composer: يأتي Composer مدمجًا بشكل افتراضي مع ServBay، لذا ليس عليك تثبيته بشكل منفصل.
3. الوصول إلى الطرفية (Terminal): ستحتاج لاستخدام الطرفية لتنفيذ أوامر Composer.

خطوات تثبيت Contao

في هذا القسم سنرشدك تفصيليًا لتثبيت وإعداد Contao داخل بيئة ServBay.

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

أولاً، انتقل إلى المجلد الجذري الافتراضي لمواقع ServBay وهو /Applications/ServBay/www، ثم أنشئ مجلدًا فرعيًا جديدًا لمشروعك Contao.

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

سنقوم بتثبيت Contao داخل مجلد servbay-contao-app.

الخطوة 2: إنشاء مشروع Contao عبر Composer

ينصح Contao باستخدام Composer لإدارة التثبيت. بما أن ServBay يتضمن Composer، يمكنك ببساطة تنفيذ الأمر التالي ضمن مجلد مشروعك لإنشاء مشروع Contao:

composer create-project contao/managed-edition .

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

ملاحظة حول Contao Managed Edition: contao/managed-edition هو الإصدار الرسمي المدعوم من Contao ويأتي مع النواة والتبعيات الأساسية بالإضافة إلى هيكلية مشروع قياسية. لاحظ أن جذر الموقع سيكون داخل مجلد فرعي يدعى web ضمن مجلد المشروع.

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

يحتاج Contao إلى قاعدة بيانات لتخزين المحتوى والإعدادات. تتيح لك ServBay أدوات مريحة لإدارة قواعد البيانات مثل phpMyAdmin أو Adminer. سنستعرض هنا خطوات القيام بذلك باستخدام phpMyAdmin:

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

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

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

   لأسباب أمنية يفضل إنشاء مستخدم مخصص لتطبيق Contao.

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

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

   b. أضف حساب مستخدم جديد

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

الخطوة 4: تكوين الموقع في ServBay

الآن عليك إعداد موقع جديد ضمن ServBay يشير مباشرة إلى مجلد مشروعك Contao.

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

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

2. املأ إعدادات الموقع

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

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

   بعد تعبئة كافة البيانات، انقر على زر "حفظ" في الأسفل ليتم تفعيل الإعدادات الجديدة.

الخطوة 5: تشغيل معالج تثبيت Contao عبر المتصفح

بعد تكوين الموقع، أصبح بإمكانك إطلاق معالج تثبيت Contao عبر متصفح الويب.

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

   افتح متصفح الإنترنت واذهب إلى: https://servbay-contao.local/contao/install.

   إذا تمت جميع الإعدادات بشكل صحيح ستظهر لك صفحة التثبيت الخاصة بـ Contao.

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

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

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

3. بيانات مسؤول النظام

   اتبع التعليمات وأدخل اسم المستخدم، كلمة السر، البريد الإلكتروني لمسؤول الإدارة. احرص على اختيار كلمة سر قوية.

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

   أكمل بقية خطوات المعالج والتي تشمل غالبًا إنشاء هيكل جداول قاعدة البيانات عبر النقر على زر "تثبيت" أو "إكمال".

الخطوة 6: التحقق من التثبيت وتسجيل الدخول للوحة الإدارة

بعد اكتمال التثبيت يمكنك الآن فحص نجاح العمل والدخول للوحة تحكم Contao:

1. زيارة واجهة الموقع

   توجه عبر المتصفح إلى: https://servbay-contao.local/. يجب أن ترى صفحة الترحيب الافتراضية لـ Contao أو صفحة فارغة بحسب الإعدادات الافتراضية. يدل ذلك على أن الإعدادات صحيحة وأن الواجهة الأمامية تعمل.

2. زيارة لوحة تحكم Contao

   أدخل إلى لوحة الإدارة عبر: https://servbay-contao.local/contao.

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

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

س: تظهر لي أخطاء عند زيارة https://servbay-contao.local/ أو https://servbay-contao.local/contao/install فما الحل؟

ج:

• تأكد من تشغيل ServBay: تحقق أن التطبيق يعمل وأن خدمات PHP وخادم الويب (Caddy أو Nginx) نشطة.
• تأكد من إعداد الموقع بشكل صحيح: راجع إعدادات الموقع التي أنشأتها ضمن ServBay – خاصة النطاق، نوع الموقع، إصدار PHP، وخصوصًا المجلد الجذري النهائي (ضرورة توجيهه إلى مجلد web ضمن مشروعك).
• تأكد من حل النطاق بشكل محلي: بحكم أن ServBay يتعامل تلقائيًا مع نطاقات .local فلا حاجة لإضافات يدوية عادة. إذا حصلت مشكلة أعد تشغيل ServBay أو تحقق من ملف hosts للنظام.
• راجع سجلات خادم الويب: استعرض سجلات Caddy أو Nginx المتوفرة ضمن ServBay لمزيد من التفاصيل حول الخطأ.

س: فشل الاتصال بقاعدة البيانات، ما السبب؟

ج:

• تأكد من تشغيل خدمة قاعدة البيانات: تحقق من MySQL/MariaDB أو PostgreSQL داخل ServBay.
• راجع بيانات الاتصال: تأكد من أن البيانات التي أدخلتها في معالج تثبيت Contao (مضيف القاعدة، اسم القاعدة، المستخدم، كلمة السر) متطابقة مع ما أنشأته باستخدام phpMyAdmin.
• تحقق من الأذونات الممنوحة للمستخدم: يجب أن يمتلك المستخدم الذي أنشأته جميع الأذونات الضرورية على قاعدة بيانات Contao.

س: واجهت أخطاء أذونات (Permissions) أثناء التثبيت، ماذا أفعل؟

ج: يحتاج معالج تثبيت Contao لأذونات كتابة على بعض المجلدات. إعداد ServBay الافتراضي يفي بالغالب بذلك، لكن إذا لم يكن، يمكنك ضبط الأذونات يدويًا من الطرفية:

cd /Applications/ServBay/www/servbay-contao-app
sudo chown -R your_username:staff . # استبدل your_username باسم مستخدم macOS الخاص بك
sudo chmod -R 755 .
sudo chmod -R 777 var/ cache/ system/config/ # قد يحتاج Contao لإذونات الكتابة على هذه المجلدات

كن حذرًا باستخدام chmod 777 – فهو مضر أمنيًا في بيئة الإنتاج، ولكنه مقبول مؤقتًا في بيئة تطوير محلية لحل مشاكل الأذونات.

الخلاصة

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

للمزيد من التعمق والاطلاع على مزايا وخصائص Contao، راجع الوثائق الرسمية لـ Contao.