過去バージョン

.env とは

.env は環境固有の設定値（DB パスワード、API キー、メールサーバ等）を、コードリポジトリに含めずに保存するためのファイルです。本番・ステージング・ローカルで値を切り替える際に使用します。

# .env の典型例
APP_NAME=MyApp
APP_ENV=production
APP_DEBUG=false
APP_URL=https://example.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=myapp
DB_USERNAME=app_user
DB_PASSWORD=s3cret-passw0rd

MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587

Laravel: env() と config() の使い分け（重要）

Laravel で 最も多い事故がここです:

// ❌ アンチパターン: コード中で env() を直接使う
class UserController extends Controller {
    public function index() {
        $appName = env('APP_NAME');     // 本番で null になる！
        return view('user.index', compact('appName'));
    }
}

// ✅ 正解: config() ヘルパーで取得
class UserController extends Controller {
    public function index() {
        $appName = config('app.name');  // config:cache 後も動く
        return view('user.index', compact('appName'));
    }
}

理由: 本番で php artisan config:cache を実行すると、Laravel は config/*.php 配下を bootstrap/cache/config.php に 1 ファイル化します。このとき $_ENV はロードされなくなり、env() は null を返すようになります。一方 config() はキャッシュされた値を読むので問題なく動きます。

Laravel の正しいフロー

.env → config/*.php → config() で取得 の三段構成にします:

// 1) .env
STRIPE_SECRET_KEY=sk_live_xxxxx
STRIPE_WEBHOOK_SECRET=whsec_xxxxx

// 2) config/services.php
return [
    'stripe' => [
        'secret' => env('STRIPE_SECRET_KEY'),       // ← config/ 内なら env() OK
        'webhook' => env('STRIPE_WEBHOOK_SECRET'),
    ],
];

// 3) コード（Controller / Service / Job）
$secret = config('services.stripe.secret');         // ← ここは config() で
$webhookSecret = config('services.stripe.webhook');

env() ヘルパーの仕様

// 基本
env('APP_NAME');                          // string|null

// デフォルト値
env('APP_DEBUG', false);                  // 未定義なら false

// 型変換（文字列リテラル）
env('APP_DEBUG');     // .env に APP_DEBUG=true → (bool) true
env('FOO');           // .env に FOO=null     → (null) null
env('BAR');           // .env に BAR=empty    → (string) ''
env('BAZ');           // .env に BAZ=(true)   → (bool) true

// 値にスペース / 特殊文字を含めるならクォート
// .env
APP_NAME="My Cool App"
PASSWORD='p@ss"word'

本番デプロイの正しい手順

# 1) コード更新
git pull origin main
composer install --no-dev --optimize-autoloader

# 2) .env が正しいか確認
php artisan tinker
> config('database.connections.mysql.host')
# 値が表示されれば OK

# 3) 設定キャッシュを再生成（高速化）
php artisan config:cache
php artisan route:cache
php artisan view:cache

# .env を更新したら必ず
php artisan config:clear && php artisan config:cache

Node.js: dotenv パッケージ

npm install dotenv

// app.js の先頭で 1 回だけ呼ぶ
require('dotenv').config();

// 以降は process.env で取得
console.log(process.env.DB_HOST);
console.log(process.env.STRIPE_SECRET_KEY);

// デフォルト値
const port = process.env.PORT || 3000;

// 型変換は自分でやる
const debug = process.env.DEBUG === 'true';   // 文字列 'true' → bool
const maxConn = parseInt(process.env.MAX_CONN || '10', 10);

// ES Modules 版
import 'dotenv/config';
import dotenv from 'dotenv';
dotenv.config({ path: '.env.production' });

PHP 単体: vlucas/phpdotenv

composer require vlucas/phpdotenv

load();

// 取得（3 通り）
echo $_ENV['DB_HOST'];
echo $_SERVER['DB_HOST'];
echo getenv('DB_HOST');

// 必須キーの存在チェック
$dotenv->required(['DB_HOST', 'DB_USER', 'DB_PASS']);

// 型チェック
$dotenv->required('PORT')->isInteger();
$dotenv->required('APP_ENV')->allowedValues(['local', 'staging', 'production']);

Python: python-dotenv

pip install python-dotenv

import os
from dotenv import load_dotenv

load_dotenv()                          # カレントの .env を読む

db_host = os.getenv('DB_HOST')
db_port = int(os.getenv('DB_PORT', '5432'))
debug = os.getenv('DEBUG', 'False').lower() == 'true'

# Django なら settings.py で
# load_dotenv()
# SECRET_KEY = os.environ['SECRET_KEY']

.env を Git に含めないルール

# .gitignore
.env
.env.local
.env.*.local

# サンプルだけ共有
!.env.example

.env.example をリポジトリに置き、各開発者がコピーして使う運用が標準です:

cp .env.example .env
php artisan key:generate     # Laravel: APP_KEY を生成

よくあるトラブル

FAQ

Q: なぜ env() を直接使ってはいけないのか
A: config:cache 後の本番で null を返すから。「ローカルで動いて本番で死ぬ」最頻バグです。

Q: .env を暗号化したい
A: Laravel 9+ は php artisan env:encrypt / env:decrypt でファイル単位の暗号化に対応しています。

Q: 環境別に値を分けたい
A: .env.local / .env.staging / .env.production を作り、デプロイ時にコピー or シンボリックリンクで切り替えるのが一般的です。