تثبيت وإعداد Joomla CMS في بيئة ServBay على نظام macOS

نظرة عامة

يشرح لك هذا الدليل بالتفصيل كيفية تثبيت وإعداد نظام إدارة المحتوى Joomla في بيئة تطوير الويب المحلية القوية ServBay. توفر ServBay بيئة متكاملة وسهلة الاستخدام لتقنيات مثل PHP وMySQL، ما يجعلها ممتازة لبناء واختبار مواقع Joomla. تمنحك ServBay مرونة وكفاءة عالية في إدارة إصدارات PHP المختلفة، وقواعد البيانات، وخوادم الويب (Caddy أو Nginx)، لتطوير Joomla بسهولة ويسر.

ما هو Joomla؟

Joomla هو نظام إدارة محتوى مفتوح المصدر واسع الانتشار، مكتوب بلغة PHP ويستخدم غالبًا قاعدة بيانات MySQL. يتميز بمرونته وقابليته العالية للتوسع، حيث يتيح لك بناء مختلف أنواع المواقع، بدايةً من المدونات الشخصية ومواقع الشركات الصغيرة إلى البوابات الإلكترونية الضخمة ومنصات التجارة الإلكترونية. يتمتع Joomla بدعم مجتمعي كبير ويوفر كمًا هائلًا من الإضافات والقوالب لتسهيل إنشاء وإدارة وصيانة المواقع الاحترافية.

حالات الاستخدام

• تطوير واختبار وتصحيح مواقع Joomla ضمن بيئة ServBay محليًا.
• تعلّم واستكشاف ميزات Joomla وتطوير الإضافات الخاصة به.
• العمل على مشاريع Joomla في وضع عدم الاتصال بالإنترنت.
• تحضير إعدادات Joomla تمهيدًا لنشر الموقع على بيئة الإنتاج في المستقبل.

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

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

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

خطوات تثبيت Joomla

اتبع الخطوات التالية لإتمام تثبيت وإعداد Joomla في بيئة ServBay.

الخطوة 1: تنزيل Joomla

أولًا، انتقل إلى المسار الافتراضي الذي توصي به ServBay لمشاريع المواقع /Applications/ServBay/www. في هذا المجلد، أنشئ مجلدًا جديدًا لمشروع Joomla القادم، ومن ثم قم بتنزيل حزمة التثبيت الخاصة بـ Joomla.

# الانتقال إلى مجلد الجذر لمواقع ServBay
cd /Applications/ServBay/www

# إنشاء مجلد جديد لمشروع Joomla (مثال: servbay-joomla-app)
mkdir servbay-joomla-app

# دخول المجلد الذي أنشأته
cd servbay-joomla-app

# تحميل حزمة Joomla
# ملاحظة: الرابط التالي غالبًا يشير لإصدار Joomla 3.
# يفضل زيارة موقع Joomla الرسمي (https://downloads.joomla.org/) للحصول على رابط أحدث إصدار مستقر.
curl -L https://downloads.joomla.org/cms/joomla3/latest-stable -o joomla.zip

ملاحظة: قد يشير الأمر curl -L https://downloads.joomla.org/cms/joomla3/latest-stable -o joomla.zip إلى آخر إصدار مستقر من Joomla 3 وقت كتابة الدليل. لأن Joomla تقوم بإصدار إصدارات أحدث (مثل Joomla 4 أو 5)، ننصح بشدة بزيارة صفحة التحميل الرسمية لـ Joomla ونسخ الرابط المباشر لأحدث إصدار مستقر واستبداله في الأمر أعلاه.

الخطوة 2: فك ضغط حزمة Joomla

استخرج محتويات ملف Joomla المضغوط بداخل مجلد servbay-joomla-app ثم احذف الملف المضغوط لتنظيف المجلد.

# فك الضغط عن حزمة Joomla
unzip joomla.zip

# حذف ملف الحزمة المضغوط
rm joomla.zip

بعد فك الضغط، ستجد جميع ملفات تثبيت Joomla داخل مجلد المشروع الخاص بك.

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

يحتاج Joomla إلى قاعدة بيانات لتخزين المحتوى والإعدادات وبيانات المستخدمين. سنستخدم أداة phpMyAdmin التي تأتي ضمن ServBay لإنشاء قاعدة بيانات ومستخدم لها.

1. الوصول إلى لوحة تحكم ServBay

   افتح متصفح الإنترنت وادخل إلى لوحة تحكم ServBay المحلية:
   https://servbay.host/

   من هنا يمكنك الوصول إلى الأدوات مثل phpMyAdmin وphpinfo.

2. الدخول إلى phpMyAdmin

   من واجهة لوحة التحكم، انقر على رابط "phpMyAdmin" للدخول إلى أداة إدارة قواعد البيانات.

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

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

   1. الانتقال إلى إدارة الحسابات

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

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

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

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

   3. إتمام العملية

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

الخطوة 4: إعداد خادم الويب (إضافة الموقع)

الآن، حان وقت إخبار ServBay بكيفية الوصول إلى ملفات Joomla عبر دومين محلي جديد، وذلك بإضافة "موقع" جديد من خلال إعدادات ServBay.

1. فتح تطبيق ServBay

   شغّل تطبيق ServBay أو انتقل إلى واجهته.

2. الذهاب إلى إدارة المواقع

   من الشريط الجانبي الأيسر، اختر قسم "المواقع".

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

   اضغط زر "إضافة" في أعلى الواجهة.

   • الاسم (Name): أدخل اسمًا تمييزيًا لهذا الموقع، مثل "My ServBay Joomla Site".
   • الدومين (Domain): أدخل الدومين المحلي الذي تريد استخدامه (مثال: servbay-joomla.local). سيضبط ServBay تلقائيًا DNS المحلي لهذا الدومين.
   • نوع الموقع (Site Type): اختر PHP.
   • إصدار PHP (PHP Version): انتقِ إصدار PHP المناسب لـ Joomla الذي حملته. راجع متطلبات Joomla الرسمية لاختيار الإصدار الأنسب.
   • جذر الموقع (Site Root): اضغط على أيقونة المجلد وحدد مسار مجلد المشروع
     /Applications/ServBay/www/servbay-joomla-app.

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

   بعد ملء جميع البيانات، انقر "حفظ". سيقوم ServBay عندها بتطبيق إعدادات الموقع الجديد وقد يحتاج لإعادة تشغيل بعض الخدمات (مثل Caddy أو Nginx).

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

الآن أصبح بإمكانك الوصول إلى واجهة تثبيت Joomla عبر الدومين الذي أعددته.

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

   افتح المتصفح وتوجه إلى الدومين الذي ضبطته (مثال: https://servbay-joomla.local/). سيقوم خادم الويب المحلي الذي أعده ServBay بتوجيه الطلب إلى مجلد الجذر الخاص بمشروعك. عادةً، يستشعر Joomla هذه الزيارة الأولى فيعيد التوجيه تلقائيًا إلى معالج التثبيت (/installation/index.php). إذا لم يحصل ذلك، يمكنك الانتقال يدويًا عبر
   https://servbay-joomla.local/installation/index.php.

2. اتباع خطوات معالج التثبيت

   ستظهر أمامك واجهة رسومية لتركيب Joomla. اتبع التعليمات خطوة بخطوة:

   • الإعدادات الأساسية (Configuration): أدخل بيانات الموقع (الاسم، الوصف، حساب المدير - اسم المستخدم، كلمة المرور، البريد الإلكتروني).
     تأكد من اختيار اسم مستخدم وكلمة مرور قوية للمدير.
   • إعداد قاعدة البيانات (Database):
     أدخل معلومات قاعدة البيانات التي أنشأتها في الخطوة السابقة:
     • نوع قاعدة البيانات (Database Type): غالبًا اختر MySQLi.
     • اسم المضيف (Host Name): أدخل localhost.
     • اسم المستخدم (Username): الاسم الذي أنشأته مثل servbay_joomla_user.
     • كلمة المرور (Password): كلمة مرور المستخدم مثل password123.
     • اسم قاعدة البيانات (Database Name): نفس اسم قاعدة البيانات (مثلًا: servbay_joomla_user).
     • بادئة الجداول (Table Prefix): يمكنك استخدام القيمة الافتراضية أو تخصيصها مثل jos_.
     • الإجراء على قاعدة بيانات موجودة (Action on Old Database): إذا كانت القاعدة جديدة، لا يؤثر الخيار كثيرًا. اختر "نسخ احتياطي" أو "حذف".
   • المراجعة وإنهاء التثبيت (Finalisation): تحقق من صحة جميع الإعدادات. سيجري Joomla بعض اختبارات التوافق في بيئة ServBay. إذا كان كل شيء على ما يرام، انقر "تثبيت".

3. إنهاء التثبيت وحذف مجلد التثبيت

   قد يستغرق التثبيت بعض الدقائق. بعد نجاح العملية ستصلك رسالة تؤكد ذلك.
   أهم خطوة لأمان موقعك هي حذف مجلد installation نهائيًا لمنع إعادة ضبط التثبيت بواسطة أي شخص آخر. عادة يوفر Joomla زرًا في الواجهة لفعل ذلك مباشرة، أو يمكنك تنفيذ ما يلي عبر الطرفية:

   # الذهاب إلى مجلد مشروع Joomla
   cd /Applications/ServBay/www/servbay-joomla-app
   
   # حذف مجلد installation
   rm -rf installation

   بعد حذف المجلد، يصبح موقعك جاهزًا للعمل ويمكنك استعراض الواجهة الأمامية (الموقع) أو الواجهة الخلفية (الإدارة).

الخطوة 6: استكشاف لوحة الإدارة في Joomla

انتقل إلى مسار /administrator على الدومين المحلي لموقعك، كمثال:
https://servbay-joomla.local/administrator

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

بناء موقع باستخدام Joomla (ملخص سريع)

بعد النجاح في تثبيت Joomla، يمكنك البدء ببناء موقعك بسهولة اعتمادًا على وظائف Joomla المتقدمة. فيما يلي ملخص لبعض العمليات الأساسية:

• إضافة المقالات والأقسام: من قائمة "المحتوى" أنشئ وحرّر المقالات والأقسام.
• إدارة القوائم: أنشئ وحرّر قوائم تنقل الموقع من قائمة "القوائم".
• ضبط الوحدات (Modules): من "الإضافات" -> "الوحدات"، يمكنك إدارة الوحدات الخاصة بالجانبين/الفوتر...الخ.
• تغيير وتخصيص القالب: من "الإضافات" -> "القوالب"، اختر وغير تصميم موقعك وخصص الإستايل كما تشاء.
• تثبيت الإضافات: من "الإضافات" -> "إدارة"، يمكنك تحميل وتثبيت إضافات أو قوالب جديدة توسع من وظائف Joomla.

نصائح هامة

• الأمان: احرص على تعيين كلمات مرور قوية لحساب المدير وحساب قاعدة البيانات، وقم بحذف مجلد installation فورًا بعد التثبيت.
• توافق إصدار PHP: تأكد أن إصدار PHP المختار لـ Joomla متوافق مع متطلبات الإصدار الذي تثبته. راجع مستندات Joomla الرسمية.
• بيانات الاتصال بقاعدة البيانات: أدخل اسم المضيف (localhost)، واسم المستخدم، وكلمة المرور، واسم القاعدة بشكل دقيق عند تركيب Joomla.
• تحديث ServBay: حافظ على تحديث ServBay دائمًا لأحدث إصدار للاستفادة من التحديثات الأمنية وتحسينات الأداء.
• النسخ الاحتياطي: يدعم ServBay النسخ الاحتياطي اليدوي والآلي للملفات، القواعد، الشهادات، وإعدادات التطبيق. واظب على أخذ نسخ احتياطية قبل أي تغييرات كبيرة لضمان سلامة البيانات.

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

• س: عند زيارة الدومين المحلي تظهر لي رسالة تعذر الوصول أو خطأ 404 – ماذا أفعل؟
  ج: تحقق من الآتي:

  1. هل ServBay يعمل فعليًا؟
  2. هل الموقع الذي أنشأته لـ Joomla مفعل ضمن قائمة "المواقع" في ServBay؟
  3. هل جذر الموقع مضبوط على /Applications/ServBay/www/servbay-joomla-app بشكل صحيح؟
  4. هل الدومين الذي تزوره (servbay-joomla.local) مطابق لما ضبطته في إعدادات ServBay؟

• س: أثناء تثبيت Joomla تظهر لي رسالة خطأ في الاتصال بقاعدة البيانات – ما السبب؟
  ج: يعود السبب غالبًا لخطأ في بيانات الدخول. تأكد أن:

  1. اسم المضيف في إعداد Joomla هو localhost.
  2. اسم المستخدم (servbay_joomla_user) وكلمة المرور (password123) مطابقان لما أنشأته في phpMyAdmin.
  3. اسم قاعدة البيانات يطابق ما تم إنشاؤه.
  4. خدمة قاعدة البيانات (MySQL/MariaDB) مفعلة في ServBay.

• س: نسيت كلمة مرور root لقاعدة MySQL في ServBay – ماذا أفعل؟
  ج: يوفر ServBay خيارًا لإعادة تعيين كلمة مرور root لـ MySQL أو MariaDB بسهولة من داخل التطبيق.

• س: بعد انتهاء التثبيت أجد أخطاء أو صفحة بيضاء عند زيارة الموقع – ما الحل؟
  ج: تأكد من أنك حذفت مجلد installation. تحقق من سجلات أخطاء Joomla (إن وجدت) أو سجل أخطاء PHP (من خلال إعدادات ServBay أو ضبط متغيرات error_reporting وdisplay_errors) لمعرفة تفاصيل الخطأ. وراجع توافق إصدار PHP مع متطلبات Joomla.

الخلاصة

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