مواقع وإدارة ملفات إعداد ServBay

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

ملاحظة هامة: لا تقم بتعديل ملفات الإعداد يدويًا

يتم توليد ملفات إعداد ServBay تلقائيًا بواسطة التطبيق بناءً على إعداداتك من خلال واجهة المستخدم الرسومية (UI). يرجى عدم تعديل ملفات الإعداد يدويًا في /Applications/ServBay/etc أو أي مجلد آخر ضمن ServBay.

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

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

نظرة عامة على هيكلية المجلدات

يتم تركيز معظم ملفات إعداد ServBay في مجلدات رئيسية، مصنفة حسب اسم الحزمة وإصدارها:

• /Applications/ServBay/etc: هذا هو المجلد الرئيسي لأغلب ملفات إعداد ServBay، حيث تجد إعدادات معظم خوادم الويب (مثل Nginx وCaddy وApache)، وملفات إعداد بيئات تشغيل اللغات مثل php.ini، وملفات إعداد قواعد البيانات (MySQL, MariaDB)، وخدمات أخرى (مثل Redis, Memcached).
• /Applications/ServBay/db: يُخصص بشكل أساسي لبيانات قواعد البيانات، لكنه قد يحتوي أيضًا على بعض ملفات الإعداد الخاصة بها، مثل ملفات التحكم في الوصول لـ PostgreSQL.
• /Applications/ServBay/package/common: يحتوي على حزم مشتركة مثل OpenSSL، ويوجد ملف إعدادها في هذا المجلد.

تفاصيل مواقع ملفات الإعداد حسب الحزمة

فيما يلي أمثلة لأماكن ملفات إعداد أكثر الحزم شيوعًا في ServBay:

خوادم الويب (Web Servers)

عادةً ما توجد ملفات إعداد خوادم الويب تحت /Applications/ServBay/etc ، مجمعة داخل مجلد فرعي باسم الخادم وبحسب الإصدار.

• Nginx: المجلد الرئيسي للإعداد: /Applications/ServBay/etc/nginx مثال على إصدار 1.25:

  /Applications/ServBay/etc/nginx/1.25/nginx.conf

  ويتم عادة تنظيم بقية الإعدادات (كالتهيئة للمواقع أو الشهادات SSL) ضمن نفس المجلد أو فرعيًا منه.

• Caddy: المجلد الرئيسي للإعداد: /Applications/ServBay/etc/caddy ملف الإعداد الرئيسي:

  /Applications/ServBay/etc/caddy/Caddyfile

• Apache: المجلد الرئيسي للإعداد: /Applications/ServBay/etc/apache مثال على إصدار 2.4:

  /Applications/ServBay/etc/apache/2.4/httpd.conf

  ملفات إعداد المواقع الافتراضية عادةً داخل مجلد فرعي باسم extra.

بيئات تشغيل اللغات البرمجية (Language Runtimes)

عادةً ما تُنظَّم بيئات تشغيل اللغات البرمجية (PHP, Python, Node.js, Go, Java, وغيرها) حسب النوع والإصدار ضمن /Applications/ServBay/etc.

• PHP: المجلد الرئيسي للإعداد: /Applications/ServBay/etc/php مثال على إصدار 8.2 لملف php.ini:

  /Applications/ServBay/etc/php/8.2/php.ini

  وتوجد إعدادات PHP-FPM عادةً بنفس مجلد الإصدار.

• Python: غالبًا تتم إدارة إعدادات Python عبر متغيرات البيئة أو ملفات داخل المشروع. ملفات التشغيل الخاصة ببيئة Python المدمجة في ServBay توجد ضمن /Applications/ServBay/package/python/{version}/bin. إعداداتها العامة نادرًا ما تكون داخل /etc الخاص بـ ServBay.

• Node.js, Go, Java, Ruby, Rust, .NET: كحال Python، تعتمد إعدادات تلك اللغات غالبًا على متغيرات البيئة أو متطلبات المشروع والأدوات المستخدمة. ServBay يوفر فقط البيئة التشغيلية أو SDK ولا يجمع ملفات الإعداد العامة في /Applications/ServBay/etc.

قواعد البيانات (Databases)

تكون ملفات إعداد قواعد البيانات موزعة بين /Applications/ServBay/etc و /Applications/ServBay/db.

• MySQL / MariaDB: المجلد الرئيسي: /Applications/ServBay/etc/mysql (أو /Applications/ServBay/etc/mariadb) مثال لإعداد MySQL 8.0:

  /Applications/ServBay/etc/mysql/8.0/my.cnf

  ويحتوي الملف عادةً على أهم إعدادات قاعدة البيانات.

• PostgreSQL: ملفات إعداد PostgreSQL الرئيسية ضمن /Applications/ServBay/etc/postgresql بالإصدار المناسب. مثال لإصدار 16:

  /Applications/ServBay/etc/postgresql/16/postgresql.conf

  أما إعدادات التوثيق (pg_hba.conf وpg_ident.conf) فهي ضمن /Applications/ServBay/db/postgresql وبحسب الإصدار:

  /Applications/ServBay/db/postgresql/16/pg_hba.conf
  /Applications/ServBay/db/postgresql/16/pg_ident.conf

• MongoDB, Redis: ملفات إعداد هذه القواعد غالبًا تجدها تحت /Applications/ServBay/etc حسب الاسم والإصدار. مثال على Redis:

  /Applications/ServBay/etc/redis/redis.conf

خدمات أخرى وحزم مشتركة

• OpenSSL: ملف إعداد OpenSSL يوجد في /Applications/ServBay/package/common/openssl بحسب الإصدار. مثال لإصدار 3.2:

  /Applications/ServBay/package/common/openssl/3.2/openssl.cnf

• ACME (للحصول على شهادات SSL تلقائيًا): توجد إعدادات ACME وبيانات الشهادات عادةً في /Applications/ServBay/etc/acme أو /Applications/ServBay/db/acme.

كيفية البحث والاطلاع على محتوى ملفات الإعداد

رغم أنه لا يُنصح بتعديل الملفات يدويًا، إلا أنك كمطور قد تريد الاطلاع على محتواها لفهم الإعدادات أو لأغراض التشخيص. اتبع الخطوات التالية:

1. الانتقال إلى مجلد الإعدادات: استخدم أدوات سطر الأوامر مثل (Terminal أو iTerm2) للانتقال. مثال لإعدادات Nginx:

   cd /Applications/ServBay/etc/nginx/

   للاطلاع على ملفات pg_hba.conf الخاصة بـ PostgreSQL 16:

   cd /Applications/ServBay/db/postgresql/16

2. عرض الملفات: استخدم الأمر ls لاستعراض المحتويات:

   ls

3. الاطلاع على محتوى الملفات: استخدم أدوات العرض مثل cat, less, more أو محررات نصوص كنظرة فقط (مثل vim, nano — لا تحفظ أي تعديل!) لعرض محتوى الملف. مثال لاستعراض nginx.conf:

   cat nginx.conf
   # أو للعرض بشكل صفحات
   less nginx.conf

   أو استعراض php.ini لـ PHP 8.2:

   less /Applications/ServBay/etc/php/8.2/php.ini

4. إعادة تشغيل الخدمة (في حال عدّلت خلال واجهة ServBay): عند إجراء تعديلات عبر واجهة ServBay غالبًا يحتاج الأمر لإعادة تشغيل الخدمة ذات الصلة. يُمكنك ذلك عبر الواجهة أو عبر أداة الأوامر servbayctl:

   servbayctl restart nginx -all

   إعادة تشغيل خدمة PHP 8.2:

   servbayctl restart php 8.2

   أو إعادة تشغيل كل الخدمات دفعة واحدة:

   servbayctl restart all

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

• س: هل يمكن تعديل ملفات الإعداد يدويًا لاختبار إعدادات متقدمة؟

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

• س: كيف يدير ServBay ملفات إعداد حزم البرامج المتعددة الإصدارات؟

  ج: كما هو موضح أعلاه، ينشئ ServBay مجلدًا مخصصًا لكل إصدار من كل حزمة في /Applications/ServBay/etc أو /Applications/ServBay/db، ليضمن فصل الإعدادات وعدم تداخل الإصدارات.

• س: ماذا أفعل إذا حذفت أو أفسدت ملف إعداد بالخطأ؟

  ج: يمكن لServBay عادةً توليد الملف تلقائيًا وفق قوالبه وإعداداتك، وذلك بإجراء تعديل ولو بسيط عبر الواجهة على الحزمة ذات الصلة. في الحالات القصوى جمّد الإعدادات أو تواصل مع دعم ServBay.

الخلاصة

يعتمد ServBay أسلوبًا مركزيًا ومنظمًا في إدارة ملفات إعداد الحزم، حيث يجمعها أساسًا في /Applications/ServBay/etc، مع مجلدات مساعدة مثل /Applications/ServBay/db و /Applications/ServBay/package/common. ويُسهل هذا الهيكل إدارة ServBay التلقائية وسرعة وصول المطورين للمعلومات.

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