مستندات ServBay: إعداد إصدار Node.js مخصص لمشروعك أو سكريبتاتك أو موقعك الإلكتروني

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

ستتعرف في هذا المقال بشكل مفصل على كيفية تعيين إصدار Node.js محدد بسهولة لسكريبتات ومواقع Node.js عبر ServBay، بالإضافة إلى كيفية الاستفادة من إعدادات التهيئة على مستوى المشروع.

تحديد إصدار Node.js وإعدادات المشروع باستخدام ملف .servbay.config

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

يبدو مثال على ملف .servbay.config الذي يحدد إصدار Node.js معين ويضبط مسارات التخزين ومديري الحزم كما يلي:

NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # مثال: استخدام مستودع مخصص
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # مثال: استخدام مستودع مخصص
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # مثال: تحديد مسار التخزين المؤقت
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # مثال: تحديد مسار التخزين المؤقت

توضيحات:

• NODE_VERSION: يُحدد رقم الإصدار الرئيسي لـ Node.js الذي سيُستخدم في هذا المشروع. سيبحث ServBay عن إصدار Node.js المثبت المطابق لهذا الرقم ويستخدمه.
• YARN_CONFIG_REGISTRY, NPM_CONFIG_REGISTRY: يضبط مستودع مديري الحزم npm أو yarn المستخدم في المشروع.
• NPM_CONFIG_CACHE, YARN_CONFIG_CACHE: يحدد مسار التخزين المؤقت لمديري الحزم npm أو yarn. في المثال، تم استخدام دليل الملفات المؤقتة الافتراضي لـ ServBay /Applications/ServBay/tmp/.

من الممارسات الشائعة وضع ملف .servbay.config في جذر مشروعك. لمزيد من التفاصيل حول طرق الإعداد والاستخدام، راجع قسم ملف .servbay.config ضمن مستندات ServBay الرسمية.

تشغيل سكريبت Node.js بإصدار محدد عبر واجهة الأوامر

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

في بيئة الطرفية الخاصة بـ ServBay (يمكنك الوصول إليها من خلال واجهة تطبيق ServBay)، تستطيع بسهولة تعيين إصدار Node.js المستعمل لتنفيذ السكريبتات، باستخدام الأمر node-<version>. يقوم ServBay بإنشاء اسم مستعار بهذا النمط لكل إصدار Node.js مثبت.

فمثلًا، لتشغيل السكريبت script.js باستخدام Node.js 14، يمكنك تنفيذ الأمر التالي:

$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # مثال ناتج الإخراج - قد يختلف رقم الإصدار

$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # مثال ناتج الإخراج - قد يختلف رقم الإصدار

$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # مثال ناتج الإخراج - قد يختلف رقم الإصدار

شرح المثال

• $ node-14 script.js : يُنفذ السكريبت script.js باستخدام إصدار Node.js 14 المثبت في ServBay (الرقم الدقيق يعتمد على إصدارك المثبت).
• $ node-16 script.js : ينفذ السكريبت باستخدام إصدار Node.js 16 المثبت في ServBay.
• $ node-20 script.js : ينفذ السكريبت باستخدام إصدار Node.js 20 المثبت في ServBay.

هذه الطريقة تمنحك مرونة عالية لاختبار وتوافق الكود على عدة إصدارات من Node.js، أو تنفيذ المهام التي تحتاج إصدارًا معينًا بسرعة، دون الحاجة لتغيير إصدار Node.js على مستوى النظام.

تعيين إصدار Node.js لموقع إلكتروني عبر واجهة إدارة ServBay

يتيح لك ServBay تحديد إصدار Node.js الافتراضي لأي موقع تديره مباشرة من خلال واجهة الإدارة. هذا الخيار مفيد بشكل خاص لأي موقع يعتمد على Node.js في عمله الخلفي (كالطبيقات المبنية على Express.js أو Next.js أو NestJS ويكون النظام مثل Caddy أو Nginx هو من يقوم بعكس الطلبات)، أو يحتاج لبيئة Node.js بخصائص معينة.

خطوات الإعداد

1. فتح واجهة إدارة ServBay: شغّل تطبيق ServBay، ثم توجه لمتصفح الإنترنت وادخل إلى واجهة الإدارة (عادة على http://localhost:5200 أو من خلال رابط يظهر في التطبيق الرئيسي).

2. الانتقال إلى إدارة المواقع: في شريط التنقل الجانبي داخل واجهة الإدارة، اختر قسم المواقع (Website).

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

4. تحديد إصدار Node.js: في صفحة إعدادات الموقع، ابحث عن الخيار الخاص بإصدار Node.js (غالبًا قائمة منسدلة). اختر منها الإصدار الذي ترغب بأن يكون الافتراضي لهذا الموقع.

5. حفظ الإعدادات: بعد تحديد الإصدار المطلوب، تأكد من الضغط على زر حفظ أو تطبيق في أسفل الصفحة.

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

ملاحظات هامة

• التأكد من تثبيت إصدار Node.js وتشغيله: الإصدار الذي ستختاره من إعدادات الموقع يجب أن يكون مثبتًا ومفعّلًا في صفحة الحزم (Packages) في ServBay. إذا لم يتم تثبيته أو تشغيله بعد، توجه أولًا إلى صفحة الحزم للقيام بذلك.
• نوع الموقع: هذا الإعداد مفيد بشكل أساسي للمواقع التي تعتمد على Node.js كبيئة تشغيل خلفية (مثل التطبيقات المبنية على Express.js، Next.js، NestJS وغيرهم). بالنسبة للمواقع الساكنة تمامًا أو تلك المعتمدة كليًا على PHP أو Python أو Go، لن يكون لهذا الإعداد تأثير يُذكر.
• اختبار التوافقية: بعد تغيير إصدار Node.js للموقع، اختبر وظائف الموقع بدقة للتأكد من توافق جميع الاعتمادات والخدمات مع الإصدار الجديد دون ظهور مشاكل.
• علاقته بملف .servbay.config: إعداد إصدار Node.js من واجهة الموقع يُعد الإصدار الافتراضي، أما إذا كان هناك ملف .servbay.config ضمن مجلد الموقع ويحدد إصدار NODE_VERSION معيّن، فهذا الإعداد في ملف التهيئة سيتفوق أولوية على ضبط واجهة الموقع، إذ يُستخدم عادة للتحكم الأكثر تفصيلًا على مستوى المشروع.

الخلاصة

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