پرش به محتوای اصلی

راهنمای ابزار ‎.env و INI

زمان مطالعه: ۲ دقیقه

این ابزار چیست؟

فایل ‎.env تنظیم‌های یک برنامه را نگه می‌دارد: نشانی پایگاه داده، کلید سرویس‌ها، حالت اجرا. وقتی برنامه روی سرور کار نمی‌کند، اغلب دلیلش یک کلید جاافتاده، یک نقل‌قول نابسته یا مقداری است که در محیط دیگر فرق دارد. این ابزار فایل ‎.env یا INI را می‌خواند، هر کلید و مقدار را با شماره‌ی سطر نشان می‌دهد، ارجاع‌هایی مثل ${DB_HOST} را پیدا می‌کند، کلیدهای تکراری و سطرهای نامعتبر را گزارش می‌دهد و خروجی JSON می‌سازد.

در حالت مقایسه، دو فایل مثلاً ‎.env.example و ‎.env کنار هم سنجیده می‌شوند تا ببینید کدام کلید کم یا زیاد است. مقدارها به‌طور پیش‌فرض پوشیده نمایش داده می‌شوند، همه‌چیز در مرورگر شما پردازش می‌شود و این ابزار هیچ ورودی‌ای را در تاریخچه ذخیره نمی‌کند.

گام‌به‌گام

  1. حالت را انتخاب کنید

    «فایل ‎.env»، «فایل INI» یا مقایسه‌ی دو فایل را بردارید.

  2. فایل را بچسبانید

    محتوای فایل را در کادر بگذارید. کلیدها، نوع نقل‌قول، ارجاع‌ها و تکراری‌ها در جدول نمایش داده می‌شوند و سطرهای نامعتبر با شماره‌ی سطر گزارش می‌شوند.

  3. مقدارها را در صورت نیاز ببینید

    مقدارها پوشیده‌اند تا روی صفحه‌ی اشتراکی دیده نشوند. با «نمایش مقدارها» آن‌ها و پیش‌نمایش ارجاع‌های جایگزین‌شده را ببینید.

  4. دو فایل را مقایسه کنید

    در حالت مقایسه فایل اول و دوم را بدهید؛ هر کلید برچسب «فقط در اولی»، «فقط در دومی»، «تغییر‌کرده» یا «یکسان» می‌گیرد.

نمونه‌های کاربردی

  • فایل با ارجاع و سطر نادرست

    DB_URL به دو کلید دیگر ارجاع می‌دهد و سطر آخر شکل KEY=VALUE ندارد.

    DB_HOST=localhost
    DB_PORT=5432
    DB_URL="postgres://${DB_HOST}:${DB_PORT}/app"
    # comment
    BAD LINE

    نتیجه: ۳ کلید؛ DB_URL به DB_HOST و DB_PORT ارجاع می‌دهد · خط ۵: خط به‌شکل KEY=VALUE نیست.

  • مقایسه‌ی دو محیط

    مقدار B عوض شده و کلید C فقط در فایل دوم هست.

    A=1
    B=2

    نتیجه: A یکسان · B تغییر‌کرده · C فقط در دومی

اشتباه‌های رایج

  • کامیت کردن ‎.env در مخزن: این فایل رمزها را دارد. ‎.env.example بدون مقدار واقعی را کامیت کنید و خود ‎.env را در ‎.gitignore بگذارید.
  • فاصله دو طرف علامت مساوی یا نقل‌قول نابسته: برخی بارگذارها KEY = value را نمی‌فهمند و نقل‌قول بازمانده بقیه‌ی فایل را خراب می‌کند. سطرهای نامعتبر را در گزارش ببینید.
  • انتظار جایگزینی ارجاع در همه‌ی ابزارها: ${VAR} را همه‌ی کتابخانه‌ها جایگزین نمی‌کنند. پیش‌نمایش این ابزار فقط نمایشی است؛ رفتار کتابخانه‌ی خودتان را بررسی کنید.
  • تکرار یک کلید: وقتی کلیدی دو بار آمده، معمولاً یکی بی‌صدا دیگری را بازنویسی می‌کند. تکراری‌ها را حذف کنید.

‎.env و INI چه فرقی دارند؟

‎.env فهرستی تخت از KEY=VALUE است که برنامه هنگام اجرا در متغیرهای محیطی می‌گذارد؛ سطرهای # توضیح‌اند و مقدار می‌تواند در نقل‌قول تکی یا دوتایی باشد. نقل‌قول دوتایی معمولاً ارجاع ${VAR} و نویسه‌هایی مثل \n را می‌پذیرد و نقل‌قول تکی متن را همان‌طور نگه می‌دارد.

INI همین ایده را با بخش‌های [نام] گروه‌بندی می‌کند و در فایل‌های پیکربندی ویندوز، PHP و بسیاری از برنامه‌ها به کار می‌رود.

پرسش‌های متداول

مقدارها کجا ارسال می‌شوند؟
هیچ‌جا. همه‌چیز در مرورگر پردازش می‌شود و مقدارها به‌طور پیش‌فرض پنهان نمایش داده می‌شوند تا هنگام اشتراک صفحه فاش نشوند.
ارجاع ${VAR} جایگزین می‌شود؟
خیر. ارجاع‌ها فقط نمایش داده می‌شوند و در خروجی JSON متن اصلی می‌ماند؛ برای هر ارجاع، مقدار پیش‌نمایش از همین فایل نشان داده می‌شود.
کلید تکراری چه می‌شود؟
مثل اغلب کتابخانه‌های dotenv آخرین مقدار معتبر است و کلید تکراری با برچسب هشدار نشان داده می‌شود.

ابزارهای مرتبط