استخدام ملف ‎.servbay.config‎ لإعداد بيئة المشروع منفصلة

نظرة عامة

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

عبر ملف ‎.servbay.config‎ يمكنك تحديد إصدار PHP أو Node.js أو Python أو Go أو Java المطلوب لمشروع معين بسهولة. كما يتيح لك إعداد مستودعات مديري الحزم (NPM وYarn) ومسار تخزين الكاش وغير ذلك. هذه الدقة في التحكم على مستوى المشروع ترفع كفاءة التطوير وسهولة العمل، حيث تضمن تشغيل كل مشروع في بيئته الخاصة، وتمنع تعارض الإصدارات.

كيف يعمل ملف ‎.servbay.config‎؟

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

يوفر لك هذا النظام انتقالًا سلسًا بين المشاريع المختلفة، لأن كل مشروع يحمل إعداداته البيئية الخاصة معه.

كيفية إنشاء وإعداد ‎.servbay.config‎

إنشاء ملف ‎.servbay.config‎ وضبطه سهل جدًا.

مكان الملف

أنشئ ملفًا باسم ‎.servbay.config‎ في المجلد الجذري لمشروعك. غالبًا ما يكون جذر المشروع ضمن مسار مواقع ServBay، مثل:
/Applications/ServBay/www/اسم-مشروعك/

صياغة الإعدادات

يستخدم ملف ‎.servbay.config‎ تنسيقًا بسيطًا على شكل ‎KEY=VALUE‎ لكل إعداد، أي إعداد في سطر منفصل. يمكنك أيضًا إضافة تعليقات عبر الرمز ‎#‎ لزيادة وضوح الملف.

مثال على إعدادات الملف

إليك مثال توضيحي لملف ‎.servbay.config‎ يوضح كيف يمكنك ضبط إصدارات لغات البرمجة ومديري الحزم:

# ملف ‎.servbay.config‎ كمثال

# تحديد إصدار PHP الذي سيعمل به المشروع. تأكد من تثبيت هذا الإصدار في ServBay.
PHP_VERSION=8.5

# تحديد إصدار Node.js المطلوب. تأكد من أن الإصدار متوفر في ServBay.
NODE_VERSION=20

# إعداد عنوان مستودع Yarn لتسريع تحميل الاعتمادات.
YARN_CONFIG_REGISTRY=https://npmreg.proxy.ustclug.org/

# إعداد عنوان مستودع NPM لتسريع تحميل الاعتمادات.
NPM_CONFIG_REGISTRY=https://npmreg.proxy.ustclug.org/

# تحديد مسار كاش NPM المحلي (ملاحظة: هذا المسار بالنسبة لمجلد تثبيت ServBay).
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache

# تحديد مسار كاش Yarn المحلي (ملاحظة: هذا المسار بالنسبة لمجلد تثبيت ServBay).
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache

# تحديد إصدار Ruby لتشغيل المشروع. تأكد من تثبيته في ServBay.
RUBY_VERSION=2.7

# تحديد إصدار Java (OpenJDK) لتشغيل المشروع. تأكد من تثبيته في ServBay.
JAVA_VERSION=21

# تحديد إصدار Python للمشروع. تأكد من تثبيته في ServBay.
PYTHON_VERSION=3.11

# تحديد إصدار ‎.NET‎ . تأكد من تثبيته في ServBay.
DOTNET_VERSION=5.0

# تحديد إصدار Go . تأكد من تثبيته في ServBay.
GO_VERSION=1.12

# إعداد وكيل وحدات Go لتسريع تحميل الحزم.
GOPROXY=https://goproxy.cn,direct

ملاحظة: أرقام الإصدارات في المثال (PHP_VERSION=8.5, NODE_VERSION=20، وغيرها) هي للعرض فقط. عند الاستخدام فعليًا، عليك إدخال الإصدارات التي تناسب مشروعك والتي سبق تثبيتها في ServBay ودعمه لها. إذا أدخلت إصدارًا غير مثبت، قد يعود ServBay لاستخدام الإصدار الافتراضي أو يصدر رسالة خطأ.

أنواع الإعدادات المدعومة

وفق المثال أعلاه، يدعم ملف ‎.servbay.config‎ الأنواع التالية من الإعدادات:

1. تحديد إصدارات البيئة:

   • PHP_VERSION: تحديد إصدار PHP.
   • NODE_VERSION: تحديد إصدار Node.js.
   • RUBY_VERSION: تحديد إصدار Ruby.
   • JAVA_VERSION: تحديد إصدار Java (OpenJDK).
   • PYTHON_VERSION: تحديد إصدار Python.
   • DOTNET_VERSION: تحديد إصدار ‎.NET‎.
   • GO_VERSION: تحديد إصدار Go.
   • (رجاءً راجع مستندات ServBay أو واجهة التطبيق لمزيد من الإصدارات والمتغيرات المدعومة.)

2. إعدادات مديري الحزم (Node.js):

   • YARN_CONFIG_REGISTRY: عنوان مستودع Yarn.
   • NPM_CONFIG_REGISTRY: عنوان مستودع NPM.
   • NPM_CONFIG_CACHE: مسار كاش NPM.
   • YARN_CONFIG_CACHE: مسار كاش Yarn.

3. إعداد وكيل وحدات Go:

   • GOPROXY: عنوان وكيل وحدات Go.

هذه المتغيرات تمنحك إمكانية إعداد بيئة منفصلة لكل مشروع، دون أي تعارض مع باقي المشاريع.

التطبيق العملي والتحقق من الإعداد

بعد ضبط ملف ‎.servbay.config‎، تأكد أن مشروعك ظهر في قائمة “المواقع” لتطبيق ServBay. يقوم ServBay بقراءة هذا الملف عند تحميل أو إعادة تحميل الموقع.

للتحقق من تطبيق الإعدادات، يمكنك اتباع الطرق التالية:

1. فحص واجهة التطبيق: قد تعرض واجهة التفاصيل في ServBay الإصدارات البيئية الحالية المطبقة على مشروعك.

2. التحقق عبر الطرفية (Terminal): افتح طرفية ServBay وتأكد من أنك داخل مجلد جذر مشروعك. ثم نفذ أوامر فحص الإصدارات، مثل:

   • فحص إصدار PHP: php -v
   • فحص إصدار Node.js: node -v
   • فحص إصدار Yarn: yarn -v
   • فحص إصدار NPM: npm -v
   • فحص إصدار Python: ‎python -V‎ أو ‎python3 -V‎
   • فحص إصدار Go: go version
   • فحص إصدار Java: java -version
   • فحص إصدار ‎.NET‎: dotnet --version
   • فحص إصدار Ruby: ruby -v تحقق أن المخرجات تطابق ما ضبطته في ملف ‎.servbay.config‎.

3. التحقق عبر صفحة الويب (خاص بـ PHP): أنشئ ملف PHP بسيط في جذر مشروعك (مثلاً ‎info.php‎) يحتوي على <?php phpinfo(); ?>، ثم زر الملف في المتصفح عبر العنوان ‎http://your-project.servbay.demo/info.php‎، وابحث عن إصدار PHP في النتائج للتيقن بأنه المعتمد.

الصورة التالية قد توضح مثالاً على تفعيل الإعداد من داخل تطبيق ServBay:

(يرجى العودة إلى تطبيق ServBay فعليًا لملاحظة سلوك التطبيق حسب حالة إعدادات مشروعك.)

تنبيهات مهمة

• يجب تسمية الملف بالضبط ‎.servbay.config‎، دون أي خطأ أو تعديل بالإملاء.
• ضع الملف مباشرة في جذر المشروع.
• أكد أن الإصدارات المختارة مثبتة ومدعومة في ServBay.
• افصل كل إعداد في سطر مستقل بصيغة ‎KEY=VALUE‎.
• الأخطاء النحوية قد تؤدي إلى تجاهل الملف كله أو بعض الإعدادات.
• إعدادات ‎.servbay.config‎ تغطي على الإعدادات العامة وتعمل فقط على المشروع الحالي.

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

س: ماذا يحدث إذا لم أُضف ملف ‎.servbay.config‎ في مجلد المشروع؟

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

س: ماذا إن وضعت في ‎.servbay.config‎ إصدارًا غير مثبت في ServBay؟

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

س: هل أحتاج لإعادة تشغيل ServBay بعد تعديل ‎.servbay.config‎؟

ج: غالبًا لا تحتاج لإغلاق وإعادة تشغيل ServBay كليًا؛ يكفي إعادة تحميل أو إيقاف وتشغيل الموقع من واجهة التطبيق.

س: هل تؤثر إعدادات ‎.servbay.config‎ على باقي المشروعات؟

ج: إطلاقًا، هذه الإعدادات خاصة فقط بمجلد المشروع المحدد ولن تؤثر على أية مشاريع أخرى.

خلاصة

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