Skip to content

كيفية قراءة متغيرات البيئة من Node.js

يوفر وحدة النواة process في Node.js خاصية env التي تستضيف جميع متغيرات البيئة التي تم تعيينها في لحظة بدء العملية.

الرمز أدناه يقوم بتشغيل app.js ويُعيّن USER_ID و USER_KEY.

bash
USER_ID=239482 USER_KEY=foobar node app.js

سيتم تمرير USER_ID للمستخدم كـ 239482 و USER_KEY كـ foobar. هذا مناسب للاختبار، ومع ذلك، بالنسبة للإنتاج، ستقوم على الأرجح بتكوين بعض نصوص bash لتصدير المتغيرات.

ملاحظة

لا يتطلب process استخدام "require"، فهو متوفر تلقائيًا.

فيما يلي مثال على الوصول إلى متغيرات البيئة USER_ID و USER_KEY، التي قمنا بتعيينها في الرمز أعلاه.

javascript
process.env.USER_ID // "239482
process.env.USER_KEY // "foobar

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

الآن، يمكنك استخدام علامة --env-file لتحديد ملف بيئة عند تشغيل تطبيق Node.js الخاص بك. إليك مثال على ملف .env وكيفية الوصول إلى متغيراته باستخدام process.env.

bash
ملف .env
PORT=3000

في ملف js الخاص بك

javascript
process.env.PORT // 3000

قم بتشغيل ملف app.js مع متغيرات البيئة المُعيّنة في ملف .env.

js
node --env-file=.env app.js

يقوم هذا الأمر بتحميل جميع متغيرات البيئة من ملف .env، مما يجعلها متاحة للتطبيق على process.env. أيضًا، يمكنك تمرير عدة وِسائط --env-file. تقوم الملفات اللاحقة بالاستعاضة عن المتغيرات الموجودة مسبقًا المُعرّفة في الملفات السابقة.

bash
node --env-file=.env --env-file=.development.env app.js

ملاحظة

إذا تم تعريف نفس المتغير في البيئة وفي الملف، فإن القيمة من البيئة لها الأولوية.