.envファイルとは?
.env(ドットイーエヌブイ)ファイルは、アプリケーションの環境変数を管理するための設定ファイルです。データベース接続情報やAPIキーなど、環境ごとに異なる設定値を「KEY=VALUE」形式で記述します。
基本的な書き方
# コメント(#で始まる行)
DB_HOST=localhost
DB_PORT=3306
DB_USER="root"
APP_NAME="My App"
EMPTY_VALUE=
# 値にスペースを含む場合はクォートで囲む
.env.exampleとは?
.env.exampleは、必要な環境変数のキー一覧を示すテンプレートファイルです。値を空にして.envと同じキーを列挙し、Gitにコミットします。チームメンバーはこれをコピーして自分の値を設定します。
.envはGitにコミットしない(.gitignoreに追加)、.env.exampleはコミットするのが鉄則です。
よくあるミス
- 値にスペース:クォートなしで空白を含むとパースエラーに
- 末尾の空白:見えないが値に含まれてしまう
- キーの重複:後の定義で上書きされ意図しない動作に
- 不正な文字:キーに使えるのは英数字とアンダースコアのみ
- .envのコミット:秘密情報がGit履歴に残る