CakePHP 4.x: .env ファイルを有効化する (留意点あり)

留意点をメモ

ドキュメント

• https://book.cakephp.org/4/en/development/configuration.html#environment-variables

有効化方法

• ① config/bootstrap.php の以下をアンコメントアウト

// if (!env('APP_NAME') && file_exists(CONFIG . '.env')) {
//     $dotenv = new \josegonzalez\Dotenv\Loader([CONFIG . '.env']);
//     $dotenv->parse()
//         ->putenv()
//         ->toEnv()
//         ->toServer();
// }

• ② config/.env を設置
  • 例: https://github.com/josegonzalez/php-dotenv/blob/master/tests/josegonzalez/fixtures/.env

FOO=bar
BAR=baz

• ③ config/app.php 内で env('FOO') のように環境変数を取得して利用する

    'Hoge' => [
        'foo' => env('FOO', null), 
    ],

留意点

• josegonzalez/dotenv を require に含めるようにする必要がある
  • デフォルトでは、josegonzalez/dotenv は require-dev に含まれているので、require に含めるようにする必要がある
    • https://github.com/cakephp/app/blob/4.x/composer.json#L18

$ composer remove josegonzalez/dotenv
$ composer require josegonzalez/dotenv:^3.2