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

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

تنبيه هام: لا تعدّل ملفات الإعداد يدويًا

تُنشِئ تطبيق ServBay ملفات الإعداد بشكل تلقائي بناءً على خياراتك من خلال واجهة المستخدم الرسومية. لا تقم بتعديل ملفات الإعداد الموجودة في مجلد إعدادات ServBay يدويًا مباشرة.

• macOS: /Applications/ServBay/etc
• Windows: C:\ServBay\etc

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

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

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

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

المجلد الرئيسي للإعدادات:

• macOS: /Applications/ServBay/etc
• Windows: C:\ServBay\etc

هذا هو المجلد الرئيسي لملفات الإعداد، ويضم معظم إعدادات خوادم الويب (Nginx، كادي، Apache)، وبيئة تشغيل لغات البرمجة (مثل ملف php.ini الخاص بـ PHP)، وقواعد البيانات (MySQL، MariaDB)، بالإضافة إلى خدمات أخرى مثل Redis وMemcached.

مجلد قواعد البيانات:

• macOS: /Applications/ServBay/db
• Windows: C:\ServBay\db

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

مجلد الحزم المشتركة:

• macOS: /Applications/ServBay/package/common
• Windows: C:\ServBay\package\common

هنا تُخزّن الحزم الشائعة مثل OpenSSL وملفات إعدادها.

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

فيما يلي أمثلة عن مواقع ملفات إعداد بعض الحزم الشائعة في ServBay:

خوادم الويب

عادةً ما تتواجد ملفات إعداد خوادم الويب ضمن المجلد الرئيسي، مرتبة حسب اسم ونسخة الخادم.

• Nginx: المجلد الرئيسي:

  • macOS: /Applications/ServBay/etc/nginx
  • Windows: C:\ServBay\etc\nginx

  مثال:

  • macOS: /Applications/ServBay/etc/nginx/1.25/nginx.conf
  • Windows: C:\ServBay\etc\nginx\1.25\nginx.conf

  تشمل هذه المجلدات أيضًا ملفات إعداد المواقع وSSL وغير ذلك.

• كادي (Caddy): المجلد الرئيسي:

  • macOS: /Applications/ServBay/etc/caddy
  • Windows: C:\ServBay\etc\caddy

  ملف الإعداد الرئيسي:

  • macOS: /Applications/ServBay/etc/caddy/Caddyfile
  • Windows: C:\ServBay\etc\caddy\Caddyfile

• أباتشي (Apache): المجلد الرئيسي:

  • macOS: /Applications/ServBay/etc/apache
  • Windows: C:\ServBay\etc\apache

  مثال:

  • macOS: /Applications/ServBay/etc/apache/2.4/httpd.conf
  • Windows: C:\ServBay\etc\apache\2.4\httpd.conf

  أما إعدادات الاستضافة الافتراضية وما شابه عادةً فتوجد في مجلد extra الفرعي.

بيئة التشغيل للغات البرمجة

تخزَّن ملفات إعداد لغات البرمجة المختلفة في المجلد الرئيسي، مرتبة حسب اسم اللغة والإصدار.

• PHP: المجلد الرئيسي:

  • macOS: /Applications/ServBay/etc/php
  • Windows: C:\ServBay\etc\php

  مثال:

  • macOS: /Applications/ServBay/etc/php/8.2/php.ini
  • Windows: C:\ServBay\etc\php\8.2\php.ini

  وتوجد ملفات إعداد PHP-FPM في نفس المكان حسب الإصدار أيضًا.

• Python: غالبًا ما تُدار إعدادات Python عبر متغيرات البيئة أو داخل مجلدات المشروع مباشرة، أما التطبيق المرفق مع ServBay فملفه التنفيذي يكون في:

  • macOS: /Applications/ServBay/package/python/{version}/bin
  • Windows: C:\ServBay\package\python\{version}\bin

  إعدادات Python لا تُخزّن غالبًا في مجلد الإعدادات الرئيسي لـ ServBay.

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

قواعد البيانات

توزَّع ملفات إعداد قواعد البيانات بين المجلد الرئيسي ومجلد البيانات.

• MySQL / MariaDB: المجلد الرئيسي:

  • macOS: /Applications/ServBay/etc/mysql (أو /Applications/ServBay/etc/mariadb)
  • Windows: C:\ServBay\etc\mysql (أو C:\ServBay\etc\mariadb)

  مثال:

  • macOS: /Applications/ServBay/etc/mysql/8.0/my.cnf
  • Windows: C:\ServBay\etc\mysql\8.0\my.cnf

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

• PostgreSQL: ملفات إعداد PostgreSQL الرئيسية حسب الإصدار:

  • macOS: /Applications/ServBay/etc/postgresql
  • Windows: C:\ServBay\etc\postgresql

  مثال:

  • macOS: /Applications/ServBay/etc/postgresql/16/postgresql.conf
  • Windows: C:\ServBay\etc\postgresql\16\postgresql.conf

  أما ملفات التحكم في الوصول مثل pg_hba.conf وpg_ident.conf فتوجد في مجلد البيانات:

  • macOS: /Applications/ServBay/db/postgresql/16/pg_hba.conf
  • macOS: /Applications/ServBay/db/postgresql/16/pg_ident.conf
  • Windows: C:\ServBay\db\postgresql\16\pg_hba.conf
  • Windows: C:\ServBay\db\postgresql\16\pg_ident.conf

• MongoDB، Redis: ملفات إعداد تلك الأنظمة غالبًا في المجلد الرئيسي، تحت اسم النظام والإصدار:

  • macOS: /Applications/ServBay/etc
  • Windows: C:\ServBay\etc

  مثال:

  • macOS: /Applications/ServBay/etc/redis/redis.conf
  • Windows: C:\ServBay\etc\redis\redis.conf

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

• OpenSSL: ملفات إعداد OpenSSL في مجلد الحزم المشتركة وتُرتب حسب الإصدار:

  • macOS: /Applications/ServBay/package/common/openssl
  • Windows: C:\ServBay\package\common\openssl

  مثال:

  • macOS: /Applications/ServBay/package/common/openssl/3.2/openssl.cnf
  • Windows: C:\ServBay\package\common\openssl\3.2\openssl.cnf

• ACME (لإدارة شهادات SSL أوتوماتيكياً): إعدادات ACME وتخزين الشهادات في:

  • macOS: /Applications/ServBay/etc/acme أو /Applications/ServBay/db/acme
  • Windows: C:\ServBay\etc\acme أو C:\ServBay\db\acme

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

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

1. الانتقال إلى مجلد الإعدادات: استخدم سطر الأوامر للانتقال إلى المجلد المناسب.

   macOS (مثال Terminal أو iTerm2):

   # عرض محتويات إعداد Nginx
   cd /Applications/ServBay/etc/nginx/
   
   # عرض مجلد pg_hba.conf لـ PostgreSQL 16
   cd /Applications/ServBay/db/postgresql/16

   Windows (مثال PowerShell أو Command Prompt):

   # الدخول لمجلد إعدادات Nginx
   cd C:\ServBay\etc\nginx\
   
   # الدخول لمجلد pg_hba.conf لـ PostgreSQL 16
   cd C:\ServBay\db\postgresql\16

2. عرض قائمة الملفات:

   macOS:

   ls

   Windows:

   # PowerShell
   Get-ChildItem
   # أو اختصار
   ls
   
   # Command Prompt
   dir

3. استعراض محتوى الملفات: يمكنك فتح الملفات لقراءتها فقط– دون تعديل أو حفظ!

   macOS:

   # استعراض ملف nginx.conf الخاص بـNginx
   cat nginx.conf
   # أو معاينة مقسمة
   less nginx.conf
   
   # استعراض ملف php.ini لـ PHP 8.2
   less /Applications/ServBay/etc/php/8.2/php.ini

   Windows:

   # PowerShell - استعراض ملف nginx.conf
   Get-Content nginx.conf
   # أو عرض مقسّم
   more nginx.conf
   
   # استعراض ملف php.ini لـ PHP 8.2
   Get-Content C:\ServBay\etc\php\8.2\php.ini | more
   
   # Command Prompt
   type nginx.conf
   more nginx.conf

4. إعادة تشغيل الخدمة (في حال تعديل الإعداد عبر واجهة ServBay): إذا قمت بتغيير أي إعداد عبر واجهة ServBay، غالبًا ستحتاج إلى إعادة تشغيل الخدمة المعنية كي يتم تطبيق التغيير. استخدم الواجهة الإدارية أو أداة servbayctl.

   macOS:

   # إعادة تشغيل خدمة Nginx
   servbayctl restart nginx -all
   
   # إعادة تشغيل خدمة PHP 8.2
   servbayctl restart php 8.2
   
   # إعادة تشغيل جميع الخدمات
   servbayctl restart all

   Windows:

   # إعادة تشغيل خدمة Nginx
   servbayctl.exe restart nginx -all
   
   # إعادة تشغيل خدمة PHP 8.2
   servbayctl.exe restart php 8.2
   
   # إعادة تشغيل جميع الخدمات
   servbayctl.exe restart all

الأسئلة الشائعة

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

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

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

  ج: كما ذُكر في الملف، يقوم ServBay بإنشاء مجلدات فرعية لكل إصدار من كل حزمة تحت مجلدات الإعداد الرئيسية (/Applications/ServBay/etc أو /Applications/ServBay/db في macOS، وC:\ServBay\etc أو C:\ServBay\db في Windows)، مما يمنع التداخل بين الإعدادات عند استخدام أكثر من إصدار.

• س: ماذا يحدث إن حذفت أو أفسدت ملف إعداد عن طريق الخطأ؟

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

الخلاصة

يعتمد ServBay أسلوبًا مركزيًا ومنظمًا لإدارة ملفات إعداد الحزم، ويستخدم نفس الهيكلية بغض النظر عن نظام التشغيل:

• macOS: شاملة المجلد /Applications/ServBay/etc بالإضافة إلى /Applications/ServBay/db و/Applications/ServBay/package/common
• Windows: شاملة المجلد C:\ServBay\etc بالإضافة إلى C:\ServBay\db وC:\ServBay\package\common

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

فهم مواقع الملفات مهم لاستكشاف بيئة ServBay والاطلاع على طريقة عملها. تأكد دائمًا من أن أي تعديل في الإعداد يتم عبر الواجهة الرسمية أو الأدوات المعتمدة؛ ولا تقم بالتعديل اليدوي للحفاظ على استقرار بيئتك في ServBay.