.env ファイル #.env

PHPでの .env 参考サイト

公式のREAD ME.md 日本語訳

概要

dotenv(.env) というライブラリを使い、アプリケーション内で使用する環境変数を読み込む。

dotenvはファイルから環境変数を読み込み、$_SERVERやgetenv()を使用して設定した環境変数を読み込むことができる。

データベースの接続情報やAPIの鍵といったGitなどの バージョン管理に含めることができない 設定値をアプリケーションで利用するために.envファイルを作成する。

しかし、バージョン管理外にすると、何を.envファイルに記述すればよいか分からなくなってしまうため、.envの設定値をダミーデータにして.env.exampleのようなファイルをバージョン管理下に指定する。

使い方　

PHP アプリケーションを作成するディレクトリ(index.php がある階層)に vlucas/phpdotenv をインストールする。

composer require vlucas/phpdotenv

.env ファイルの作成

.env

DB_HOST=localhost
DB_USER=user
DB_PASS=password
DB_NAME=database

PHPファイルで環境変数を呼び出す

#vendorファイルを読み込む
require_once __DIR__ . '/vendor/autoload.php';

#dotenvを使用する
$dotenv = new Dotenv\Dotenv(__DIR__); // .envファイルがあるディレクトリを指定
$dotenv->load();                      // .envファイルから環境変数を読み込み

通常の環境変数を呼び出すのと同じようにgetenv()、$_SERVER、$_ENVと複数の方法で環境変数を呼び出すことができる。

<?php
require_once __DIR__ . '/vendor/autoload.php';

$dotenv = new Dotenv\Dotenv(__DIR__); // .envファイルがあるディレクトリを指定
$dotenv->load();                      // .envファイルから環境変数を読み込み

// 通常の環境変数を同じように下記のどの方法でも環境変数を呼び出せます
$host = getenv('DB_HOST');
$user = $_SERVER['DB_USER'];
$password = $_ENV['DB_PASS'];

$dsn = "mysql:host={$host};charset=utf8;";
$options = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
];

$this->pdo = new PDO($dsn, $user, $password, $options);

docker-compose での .env　参考サイト

公式

環境変数の与え方

　1. ホスト側で環境変数を設定する
　2. .envファイルをdocker-compose.ymlと同じ階層に置いておく
　3. docker-compose時に--env_fileオプションを付けて.envの代わりにファイルを指定する
　

利用される環境変数の優先順位

ホストで設定した環境変数
.envファイル

注意すること

.envファイルの内容はすべて テキスト として扱われるので、数値やbool値として環境変数を使用することはできない。
.envファイルを守る
.htaccess で.envファイルへの アクセス拒否設定 をしたり、.envファイルの パーミッション(400) を見直す。
.envファイルを 公開領域外 へ

.env ファイル