تثبيت وضبط Drupal في بيئة التطوير المحلية ServBay

نظرة عامة

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

ServBay هو أداة تطوير ويب محلية مصممة خصيصًا لنظام macOS، وتجمع بين خوادم الويب الشائعة (مثل Caddy وNginx)، وبيئات تشغيل برمجية متعددة (مثل PHP، Node.js، Python، Go، Java)، وقواعد بيانات (مثل MySQL، PostgreSQL، MongoDB، Redis)، بالإضافة إلى أدوات المطور مثل Composer وnpm. يتيح تثبيت وتهيئة Drupal في ServBay منصة تطوير محلية مستقرة وسهلة وثرية بالميزات.

ستتعرف في هذا الدليل خطوة بخطوة على كيفية تثبيت وضبط Drupal داخل بيئة ServBay.

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

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

1. تثبيت ServBay وتشغيله: تأكد من أنك قمت بتثبيت ServBay بنجاح على جهاز macOS وأن التطبيق يعمل.
2. معرفة أساسية باستخدام ServBay: يجب أن تعلم كيفية إدارة الحزم، إضافة مواقع، والوصول للأدوات المدمجة مثل phpMyAdmin عبر واجهة ServBay.
3. تثبيت PHP وMySQL/MariaDB: ServBay يأتي مع إصدارات متعددة من PHP وقواعد بيانات MySQL أو MariaDB بشكل افتراضي. تأكد من تفعيل إصدار PHP المطلوب وتشغيل خدمة قاعدة البيانات.
4. تثبيت Composer: Composer مدمج افتراضيًا في ServBay ويُعتبر أداة جوهرية لإدارة اعتمادات مشاريع PHP الحديثة. سيستخدم هذا الدليل Composer لإنشاء مشروع Drupal.

خطوات تثبيت Drupal

فيما يلي الخطوات التفصيلية لتثبيت وضبط Drupal في بيئة ServBay:

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

ابدأ بإنشاء مجلد مخصص لمشروع Drupal داخل مسار الجذر لمواقع ServBay: /Applications/ServBay/www.

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

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

ستُنشئ هذه الأوامر مجلدًا جديدًا باسم servbay-drupal-app داخل دليل /Applications/ServBay/www وستنتقل إليه.

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

يأتي Composer مدمجًا مع ServBay، ولا داعي لتثبيته يدويًا. يوصى دائمًا باستخدام Composer لإنشاء وتحميل اعتمادات مشروع Drupal.

داخل مجلد servbay-drupal-app الذي أنشأته، شغّل الأمر التالي:

composer create-project drupal/recommended-project .

يستخدم هذا الأمر القالب drupal/recommended-project لإنشاء مشروع Drupal جديد في المسار الحالي (.). سيقوم Composer بتنزيل ملفات Drupal الأساسية والاعتمادات تلقائيًا. قد يستغرق ذلك بعض الوقت حسب سرعة الإنترنت لديك.

هيكلية مشروع Drupal الحديثة تضع الملفات العامة (مثل index.php وملفات CSS وJavaScript) داخل مجلد فرعي باسم web، مما يعزز الأمان ويوضح تنظيم المشروع.

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

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

1. الوصول إلى phpMyAdmin في ServBay

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

   servbay.host هو نطاق مخصص داخل ServBay لتسهيل إدارة بيئة التطوير المحلية.

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

   من الأفضل لأسباب الأمان والصلاحيات أن تنشئ مستخدمًا خاصًا بمشروع Drupal.

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

الآن أصبح لديك قاعدة بيانات جديدة باسم drupal_user، ومستخدم drupal_user يمتلك كامل الصلاحيات عليها.

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

الآن عليك إضافة إعداد موقع جديد في ServBay وتوجيه نطاق محلي إلى مجلد web الخاص بمشروع Drupal.

1. افتح واجهة ServBay: شغل واجهة البرنامج الرئيسية.
2. أضف موقعًا جديدًا: من الشريط الجانبي، اختر "المواقع".
3. انقر زر الإضافة: اضغط على زر "+" أو زر الإضافة في أسفل قائمة المواقع.
4. املأ بيانات الموقع:
   • الاسم: أدخل اسمًا تعريفيًا للموقع، مثل My Drupal Site.
   • النطاق: اختر نطاقًا محليًا مثل servbay-drupal.local (يدعم ServBay نطاقات .local دون الحاجة لتعديل ملف hosts).
   • نوع الموقع: اختر PHP.
   • إصدار PHP: اختر إصدار PHP المناسب. تحقق من التوافق مع إصدار Drupal الذي ستثبته.
   • جذر الموقع: يجب تحديد الدليل الفرعي الذي يحتوي على ملف index.php، بناءً على الهيكل الذي تم إنشاؤه في الخطوة 2. سيكون في: /Applications/ServBay/www/servbay-drupal-app/web
5. حفظ الإعدادات: بعد ملء جميع المعلومات، اضغط "حفظ" ليتم تفعيل الموقع الجديد. سيقوم ServBay بتحديث إعدادات خوادم الويب تلقائيًا.

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

الآن يمكنك بدء تثبيت Drupal عبر متصفحك باستخدام نطاقك المحلي.

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

   من متصفحك، انتقل إلى: https://servbay-drupal.local/core/install.php.

   سيفتح لك ذلك معالج تثبيت Drupal.

2. اختيار اللغة

   اختر اللغة المرغوبة للموقع ثم اضغط "حفظ ومتابعة".

3. اختيار نوع التثبيت

   عادة يكفي اختيار تثبيت "قياسي" للحصول على موقع بإعدادات افتراضية شائعة. تابع بالضغط على "حفظ ومتابعة".

4. ضبط إعدادات قاعدة البيانات

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

   • نوع قاعدة البيانات: اختر MySQL, MariaDB, Percona Server, or equivalent.
   • اسم قاعدة البيانات: drupal_user
   • اسم المستخدم: drupal_user
   • كلمة المرور: كلمة المرور التي أنشأتها في الخطوة السابقة.
   • الخادم: localhost
   • خيارات متقدمة: عادة لا حاجة لتغييرها إلا إذا كنت تستخدم منفذًا خاصًا أو إعدادات إضافية.

   اضغط "حفظ ومتابعة" ليتصل Drupal بقاعدة البيانات ويستورد البيانات الأساسية.

5. ملء معلومات الموقع

   عند نجاح الاتصال بقاعدة البيانات، سيُطلب منك إدخال المعلومات التالية:

   • اسم الموقع: عنوان موقعك.
   • البريد الإلكتروني للموقع: البريد المعتمد للإشعارات وما شابه.
   • اسم المستخدم الإداري: الحساب الأساسي لإدارة Drupal.
   • كلمة مرور المدير: اختر كلمة سر آمنة للحساب الأداري.
   • الدولة/المنطقة: اختر بلدك.
   • المنطقة الزمنية: اختر التوقيت المناسب.

   تابع بالضغط على "حفظ ومتابعة" لإكمال تثبيت الموقع.

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

   بعد انتهاء التثبيت بنجاح، سيتم إعادة توجيهك إلى الصفحة الرئيسية لموقعك الجديد على Drupal. تهانينا! أصبح Drupal جاهزًا للاستخدام في بيئة ServBay.

الخطوة 6: تثبيت الوحدات والثيمات (للتعرف المبدئي)

قوة Drupal تكمن في نظام الوحدات (الموديولات) والثيمات (القوالب). بعد إكمال التثبيت يمكنك البدء بتوسيع موقعك funcionalidades حسب الحاجة.

1. تسجيل الدخول إلى لوحة إدارة Drupal: انتقل إلى https://servbay-drupal.local/user أو https://servbay-drupal.local/admin باستخدام اسم المستخدم وكلمة المرور اللذان قمت بتعيينهما.
2. تثبيت وحدات: بعد تسجيل الدخول، توجه إلى قائمة "الامتدادات" (Extend) لتصفح وتثبيت وحدات جديدة تضيف مزايا للموقع.
3. تثبيت ثيمات: من قسم "المظهر" (Appearance)، يمكنك تثبيت قوالب جديدة وتغيير شكل الموقع.

الخطوات التالية بعد التثبيت

بعد الانتهاء من التثبيت، يمكنك البدء ببناء محتوى موقعك والاستفادة من إمكانيات Drupal.

إنشاء أنواع المحتوى وإدارته

أنواع المحتوى تمثل العمود الفقري لهيكلة Drupal.

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

إعداد قوائم التنقل

القوائم تساعد في تنظيم روابط موقعك للزوار.

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

تخصيص توزيع الكتل (Blocks)

الكتل عناصر محتوى يمكن عرضها في مناطق محددة بالموقع (مثل الشريط الجانبي، التذييل).

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

ملاحظات وأجوبة عن الأسئلة الشائعة (FAQ)

• كيف يمكن تعديل إعدادات PHP؟ إذا احتجت لتفعيل إضافات PHP محددة أو رفع قيمة memory_limit، اذهب إلى تبويب "الحزم" في واجهة ServBay واختر إصدار PHP المطلوب، ثم انقر "تكوين" لتحرير ملف php.ini. أعد تشغيل خدمة PHP بعد التحديث (غالبًا يقوم ServBay بذلك تلقائيًا).
• ماذا أفعل إذا لم يعمل موقعي؟
  • تحقق أن ServBay يعمل.
  • تأكد من صحة إعدادات الموقع، خاصة اسم النطاق ومسار الجذر (يجب أن يشير لـ .../servbay-drupal-app/web).
  • تحقق من تشغيل خادم الويب (Caddy أو Nginx).
  • تأكد أنك تزور العنوان https://servbay-drupal.local والمسار المناسب (أثناء التثبيت: https://servbay-drupal.local/core/install.php).
• مشكلة في الاتصال بقاعدة البيانات؟
  • تحقق من صحة اسم قاعدة البيانات واسم المستخدم وكلمة المرور مقارنة بما أدخلته في phpMyAdmin.
  • تأكد من أن المضيف هو localhost.
  • تحقق أن قاعدة بيانات MySQL/MariaDB تعمل ضمن ServBay.
• ظهور أخطاء أثناء تثبيت اعتمادات Composer؟ افحص اتصال الإنترنت، تأكد أن Composer يصل إلى packagist.org. أحيانًا يفيد تنظيف ذاكرة Composer المؤقتة أو تحديثه (يقوم ServBay بتحديث Composer تلقائيًا).
• مشكلات في صلاحيات الملفات؟ يحتاج Drupal للكتابة على بعض المجلدات مثل web/sites/default/files وweb/sites/default/settings.php. غالبًا لن تواجه مشاكل في ServBay لأنه يعمل باسم المستخدم الحالي، لكن تحقق من الصلاحيات إذا صادفت أي مشاكل.

الخلاصة

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