Env Fileملف البيئة
ما هو Env File؟
ملف جانبي يحفظ مفاتيحك السرّية بعيدًا عن الكود الذي يراه الجميع.
ما معنى Env File بالعربي؟
الاسم المعتمد الآن هو «ملف البيئة». ولأن كثيرًا من المصطلحات لم يستقرّ لها اسم عربي واحد، يكتب هذا القاموس قرّاؤه: صوّت للاسم الذي تراه أوضح، أو اقترح اسمًا أفضل. نراجع الأصوات في كل جولة ونعتمد ما يختاره الناس.
-
ملف البيئة الاسم المعتمد اسم القاموس
-
ملف المتغيرات البيئية الاسم الوصفي الكامل
-
ملف دوت إنف نطق اسم الملف بين المطورين
صوت واحد لكل قارئ في كل مصطلح، وتستطيع نقله إلى اسم آخر. حين يتجاوز اسمٌ الاسمَ المعتمد ويصل إلى 5 أصوات على الأقل، نعرضه للاعتماد في الجولة التالية.
اقترح اسمًا عربيًا أفضل
هل الشرح غير واضح أو فيه خطأ؟
على المكتب دفتر مفتوح فيه الوصفة كاملة، يقرؤه من يمرّ ولا بأس. وبجواره، منفصلًا، صندوق حديدي صغير مقفل، فيه المفتاح الحقيقي. الدفتر لا يحتوي المفتاح؛ يحتوي جملة واحدة: «خذ المفتاح من الصندوق». من يأخذ الدفتر يعرف الطريقة، ومن لا يملك الصندوق لا يستطيع أن يفعل بها شيئًا.
الدفتر هو الكود، والصندوق هو ملف البيئة، واسمه «.env» (يُقرأ «دوت إنف»، اختصار Environment). الكود يحتاج أشياء حسّاسة ليعمل: مفاتيح API، كلمات سر، بيانات الدخول إلى قاعدة البيانات. لكن الكود كثيرًا ما ينتهي عامًّا على GitHub يقرؤه الإنترنت كله. فإن كتبت كلمة السر داخل الكود، فقد لصقت مفتاح بيتك على الباب ونشرت العنوان. لذلك لا تدخل الأسرار في الكود؛ تذهب إلى ملف .env الذي لا يُشارك أبدًا، ويكتفي الكود بالإشارة: «اقرأ المفتاح من هناك».
وفي هذا الفصل فائدة أذكى من مجرّد الأمان: ما دامت الأسرار خارج الكود، فالكود نفسه يعمل في كل مكان، وتبدّل فقط ما في الصندوق. على جهازك مفاتيح التجربة، وعلى جهاز زميلك مفاتيحه، وعلى الخادم الحيّ مفاتيح الإنتاج الحقيقية. الوصفة واحدة، والصندوق يختلف.
القاعدة التي يتعثّر بها الناس: ملف .env لا يُسجَّل في Git ولا يُرفع إلى GitHub أبدًا. تسريب مفتاح هو خطأ المبتدئ الكلاسيكي، وهو مكلف. والخبر الجيد أن الأدوات تساعدك: ملف اسمه «.gitignore» تكتب فيه «.env» مرّة واحدة، فيرفض Git بعدها أن يحفظ الصندوق أو يرفعه.
تنبيه صغير: النقطة في أول الاسم تجعله ملفًا مخفيًا لا تراه في المجلّدات. على Mac اضغط Cmd + Shift + . داخل Finder، وعلى Windows فعّل «العناصر المخفية» من قائمة العرض.
ولست مضطرًا لصنع هذا بيدك. حين يجهّز الوكيل مشروعًا، ينشئ .env و.gitignore عادةً من تلقاء نفسه ويضع المفاتيح في مكانها. معرفتك بهما تعني أنك ستفهم ما يقصده حين يقول: «سأضع المفتاح في ملف البيئة».
تخيّل أنك تسلّم كود متجرك لمطوّر جديد فيسأل: «أين ملف الـ .env؟». الإجابة الصحيحة: ترسله له بقناة خاصة، لا في البريد ولا مع الكود.
لماذا يهمك Env File؟
ستعرف أين توجد مفاتيح عملك الحقيقية وكيف تُنقل بأمان عند تغيير المطوّر. ولن ترفع كود مشروعك إلى أي مكان قبل أن تسأل: هل ملف .env خارج المستودع؟
متى ستسمع كلمة Env File؟
يقول الوكيل: «أضف مفتاح الـ API إلى ملف .env ولا تضعه في الكود».
