CakePHP4で「app_local.php」「.env」を利用して環境ごとの定数を振り分ける方法

2022/07/12 2023/12/28

CakePHP4で「app_local.php」「.env」を利用して定数を定義する方法

　
CakePHP4では、
　「app_local.php」ファイル
　「.env」ファイル
にて定数を定義することができるようになっています。
　
この記事では、「app_local.php」「.env」で定数を定義する方法、呼び出す方法の解説をします。
　
　
ちなみに、「app_local.php」「.env」のいずれも、Gitでの管理対象にはしない設定になっています。
　
　
また、「CakePHP4の定数定義ファイルを環境変数によって本番と開発を振り分ける方法解説」では、定数を定義したファイルを「環境変数」を使用して「本番環境」と「開発環境」を振り分ける方法を解説していますので、併せて参考にしてください。
　
　

「app_local.php」を利用して定数を定義する方法

　
CakePHP4では、環境ごとに異なる定数を定義する「/config/app_local.php」と言うファイルが用意されています。
　
「app_local.php」ファイルには
　デバッグモードの設定
　salt
　データベースの接続情報
　SMTPの接続情報
が記載されています。
　
これらの情報は、CakePHP3の頃には「app.php」に記述していましたが、開発環境と本番環境とで異なる情報となりますので、CakePHP4では「app.php」と分けて管理することになっています。
　
（CakePHP3、CakePHP4をインストールし、DB接続情報などの設定する方法の解説などは「CakePHP3、CakePHP4、CakePHP5のバージョンを指定してインストールする詳細な手順を解説」を参照してください。）
　
　
ここでは、その「/config/app_local.php」ファイルに開発者が独自に設定する定数を記載して管理する方法を解説します。
　
　
定数を別ファイルに指定して管理する方法については「CakePHP4で定数の設定と呼び出し方法の解説（defineとConfigure）」に詳しく記載しています。
その内容を理解している前提で話を進めさせていただきます。
　
　

「/config/app_local.php」ファイルに定数を定義する

　
まず、「/config/app_local.php」に記載する内容です。
　

   'EmailTransport' => [
        'default' => [
            'host' => 'localhost',
              ：
              中略
              ：
        ],
    ],

    // 定数を指定する
    "AppLocalTest01" => "aaaaa01",

    // 配列を指定する
    "AppLocalTest02" =>[
        "test01" => "aaaaa0201",
        "test02" => "aaaaa0202",
    ],

    // 定数を「AppLocalConst」にまとめる方法
    "AppLocalConst" =>[
        // users で使用する定数
        "users"  => [
            "test01" => "users01",
            "test02" => "users02",
        ],
        // topics で使用する定数
        "topics"  => [
            "test01" => "topics01",
            "test02" => "topics02",
        ],
    ],

];

'EmailTransport' => [

'default' => [

'host' => 'localhost',

：

中略

：

// 定数を指定する

"AppLocalTest01" => "aaaaa01",

// 配列を指定する

"AppLocalTest02" =>[

"test01" => "aaaaa0201",

"test02" => "aaaaa0202",

// 定数を「AppLocalConst」にまとめる方法

"AppLocalConst" =>[

// users で使用する定数

"users" => [

"test01" => "users01",

"test02" => "users02",

// topics で使用する定数

"topics" => [

"test01" => "topics01",

"test02" => "topics02",

];

　
上記の 10行目～31行目が追加した記述になります。
　
それぞれ、定数を指定する方法、配列を指定する方法、定数を「AppLocalConst」というひとまとめの定数で指定する方法などがあります。
　
　

「/config/app_local.php」に定義した定数を呼び出す

　
続けて、「/config/app_local.php」に記述した定数を呼び出す方法です。
　
「/config/app_local.php」に記載した定数を取得する場合は「Configure::read()」を使用します。
　
下記は、定数を使用する Controllerに「initialize()」を追加してそこで呼び出す記述をしています。
　
Controller全体ではなく、特定の Actionのみで使用する場合は、Actionの中に同様の記述をしてください。
　

    public function initialize(): void
    {

      // 定数「AppLocalTest01」を呼び出す
      $appLocalTest01 = Configure::read("AppLocalTest01");

      // 「AppLocalTest02」を配列として呼び出す
      $appLocalTest02 = Configure::read("AppLocalTest02");

      // 配列「AppLocalTest02」内の「test01」を呼び出す
      $appLocalTest02test01 = Configure::read("AppLocalTest02.test01");

      // 配列「AppLocalTest02」内の「test01」を呼び出す・その２
      $appLocalTest02test01x = Configure::read("AppLocalTest02")["test01"];

      // 配列「AppLocalConst」内の「topics」内の「test01」を呼び出す
      $topicsTest011 = Configure::read("AppLocalConst.topics.test01");

      $this->set(compact(
        'appLocalTest01',
        'appLocalTest02',
        "appLocalTest02test01",
        "appLocalTest02test01x",
        "topicsTest011"
      ));

    }

public function initialize(): void

{

// 定数「AppLocalTest01」を呼び出す

$appLocalTest01 = Configure::read("AppLocalTest01");

// 「AppLocalTest02」を配列として呼び出す

$appLocalTest02 = Configure::read("AppLocalTest02");

// 配列「AppLocalTest02」内の「test01」を呼び出す

$appLocalTest02test01 = Configure::read("AppLocalTest02.test01");

// 配列「AppLocalTest02」内の「test01」を呼び出す・その２

$appLocalTest02test01x = Configure::read("AppLocalTest02")["test01"];

// 配列「AppLocalConst」内の「topics」内の「test01」を呼び出す

$topicsTest011 = Configure::read("AppLocalConst.topics.test01");

$this->set(compact(

'appLocalTest01',

'appLocalTest02',

"appLocalTest02test01",

"appLocalTest02test01x",

"topicsTest011"

));

}

　
ちなみに、『配列「AppLocalTest02」内の「test01」を呼び出す』の「その２」の記述方法はむりやり感がありますが、「Configure::read("AppLocalTest02")」の部分で配列を取得していますので、こんな記述方法も可能ではあります。
　
　

「.env」を利用して定数を定義する方法

　
「/config/.env」ファイルを使用して定数を指定する方法を解説します。
　
　

「.env」ファイルの使用できるようにする

　
デフォルトの設定では「.env」の内容を読み込める様になっていませんので、「.env」ファイルを使用できるようにします。
　
/config/bootstrap.php
の 63～69行目の下記の部分のコメント処理を外します。
　

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

if (!env('APP_NAME') && file_exists(CONFIG . '.env')) {

$dotenv = new \josegonzalez\Dotenv\Loader([CONFIG . '.env']);

$dotenv->parse()

->putenv()

->toEnv()

->toServer();

}

「.env」ファイルの生成する

　
続けて「.env」ファイルを生成します。
　
CakePHP4では「/config/.env」ファイルはデフォルトでは用意されていませんので、「/config/.env.example」をコピペして「.env」ファイルを作成します。
　
また、「/config/.env」ファイルの 16～21行目の設定は不要ですので、コメントにしておきます。
「.env」ファイルでコメントにする場合は、行頭に「#」を記述します。
　
　
「.env」ファイルに定数を定義する場合は、下記の様に「export」に続けて定義を記述します
　

export ENV_STR01="enviroment_string01"
export ENV_STR02="enviroment_string02"
export ENV_ARRAY="enviroment_array01,enviroment_array02,enviroment_array03"

export ENV_STR01="enviroment_string01"

export ENV_STR02="enviroment_string02"

export ENV_ARRAY="enviroment_array01,enviroment_array02,enviroment_array03"

　
ちなみに、「.env」ファイルで設定できる定数は「文字列のみ」です。
そのため、配列を指定したい場合は、擬似的な対応となります。
　
　

「/config/.env」に定義した定数を呼び出す

　
「.env」ファイルに設定した定数を呼び出す場合は「env()」関数を使用します。
「env()」関数で呼び出す方法は、Controllerでも View（テンプレートファイル内）でも同じ記述で使用できます。
　

$env_str01 = env("ENV_STR01");
$env_str02 = env("ENV_STR02");
$env_array = explode(",",env("ENV_ARRAY"));

$env_str01 = env("ENV_STR01");

$env_str02 = env("ENV_STR02");

$env_array = explode(",",env("ENV_ARRAY"));

　
また、「.env」ファイルに擬似的な配列を指定した場合は、上記のように「explode()」関数にて文字列を配列に分割して使用します。
（文字列の中に「,」がある場合は、「,」以外の区切り文字を使うといいでしょう。）
　
　
また、「.env」ファイルで定義した定数を、「env()」を使わずに定数として呼び出したい場合は、「/config/bootstrap.php」ファイルに下記の様に改めて定数として定義し直す方法があります。
　

define("ENV_STR01",env("ENV_STR01"));
define("ENV_STR02",env("ENV_STR02"));
define("ENV_ARRAY",explode(",",env("ENV_ARRAY")));

define("ENV_STR01",env("ENV_STR01"));

define("ENV_STR02",env("ENV_STR02"));

define("ENV_ARRAY",explode(",",env("ENV_ARRAY")));

　
また、定数を別ファイルで定義する方法については「CakePHP4で定数の設定と呼び出し方法の解説（defineとConfigure）」に記事を書いていますので参考にしてください。
　
　

CakePHP4では「app_local.php」と「.env」のどちらを使う方がいい？

　
CakePHP4で定数を管理する場合
　「/config/app_local.php」
　「.env」
のどちらで定数を定義する方がいいか？
についてですが、「/config/app_local.php」の方がいいのであろうと思います。
　
そもそも、CakePHP4のデフォルトでは「.env」は用意されていませんし（「.env.example」は用意されていますが）、必要な処理はコメントアウトされており使用できるようになっていません。
　
CakePHP4の「.env」は、CakePHP3や他のフレームワークで「.env」ファイルを使用していた方に対して、CakePHP4でも同じ様な使用感で定数を定義するためのオプションなのだと考えています。
　
また、「.env」では配列を定義することができないために使い勝手がいいとは言えず、その点も含めて、「.env」より「app_local.php」を使う方がいいのだろうと思います。
　
ただ、「.env」は「.」で始まるファイルのため、セキュリティの点でちょっとだけ有利なのかも知れません。
　
　
ちなみに、「app_local.php」と「.env」は、基本的に Gitでは管理しないファイルとなっています。
理由は、データベースの接続情報やメールサーバへの接続情報などの機密情報を記載するファイルとなるためです。
　
そのため、この記事では「app_local.php」や「.env」で定数を管理する方法を紹介してはいるものの、開発者が独自に定義する定数は「app_local.php」「.env」には記載しない方がいいのだろうと思います。
　
環境ごとで変わる定数を管理する方法としては、「CakePHP4の定数定義ファイルを環境変数によって本番と開発を振り分ける方法解説」に書いている「環境変数」で定数を振り分ける方法をオススメします。
　
　

- CakePHP 3.x 4.x 5.x CakePHP4

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP 2.3　Search Pluginで検索処理　その２表示件数を動的に変える方法

CakePHPの検索プラグイン Search Pluginの検索処理の中で動的に表示件数を変える方法です。

: CakePHP3のUpload Plugin 3.0をバリデーションなど実運用向けのカスタマイズ方法解説・その２

CakePHP3でファイル、画像をアップロードするプラグイン、upload plugin 3を導入する手順を解説した記事。3部作のその2でバリデーションなどの実用的なカスタマイズ方法を解説。

: CakePHP3で静的ページの作成は webrootか pagesを使う。トップページを参考に解説

CakePHP3で静的なページを設置する場合の方法（webrootとpagesとを活用する方法）を解説。pagesの解説はデフォルトのトップページがどう表示されているかを参考に解説。ルーティングの機能も。

: CakePHP5でヘルパーから他のヘルパーを読み込む方法・CakePHP4からの変更点

CakePHP5のヘルパーで他のヘルパーを読み込む方法を解説。公式の日本語CookbookはCakePHP4のソースのままで間違っているため注意が必要。CakePHP4からの移行の際も同じ点に注意が必要。

: VirtualBoxにCakePHP3を設置。必要なCentOS、Apache、PHP、MySQL、Composerをインストールし設定する

VirtualBoxにCentOS、Apache、MySQL、PHPをインストールするところから初めてCakePHP3の開発環境を構築する手順を詳細解説。この記事1つで全ての設定が完了する。

: CakePHP4のCakeDC/Usersの画面、メール本文テンプレートのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。ユーザ新規登録の流れを紹介しつつ、テンプレートファイル、設定情報ファイルの場所とそれらをカスタマイズする方法を説明します。

: CakePHP3でCookieを保存、呼び出し、削除の操作・CakePHP3.7対応

CakePHP3.7でCookieを保存、取り出し、削除する方法を解説。CakePHP3でのCookieの取り扱いはバージョンごとに変更されるため、環境に合わせた方法を探す必要がある。

: CakePHP3で生の SQLの実行はConnectionManagerを使う

CakePHP3で生の SQL文を実行する方法を解説。クリエビルダーを使う場合は TableRegistryを利用するが、SQLを実行する場合は ConnectionManagerを使う。プリペアードステートメントの使用方法も解説。

: CakePHP3でPHP Simple HTML DOM Parserを使ってスクレイピングする方法

CakePHP3でPHP Simple HTML DOM Parserを使ってスクレイピングをする方法を解説。インストール方法、読み込み方法。および、具体的なスクレイピングを実行するサンプルソースも。

: CakePHP3のインストールでURL rewriting……のエラーが！その解決方法解説

CakePHP3をインストールしたら URL rewriting is not properly configured.のエラーが。原因は.htaccessが有効になっていないこと。httpd.confに設定を追加すればOK。

PREV: CakePHP4の定数定義ファイルを環境変数によって本番と開発を振り分ける方法解説
NEXT: CakePHP4でcontrollerで実行したバリデーションエラーをmodelのにマージする方法

日	月	火	水	木	金	土
			1	2	3	4
5	6	7	8	9	10	11
12	13	14	15	16	17	18
19	20	21	22	23	24	25
26	27	28	29	30

CakePHP4で「app_local.php」「.env」を利用して環境ごとの定数を振り分ける方法

CakePHP4で「app_local.php」「.env」を利用して定数を定義する方法

「app_local.php」を利用して定数を定義する方法

「/config/app_local.php」ファイルに定数を定義する

「/config/app_local.php」に定義した定数を呼び出す

「.env」を利用して定数を定義する方法

「.env」ファイルの使用できるようにする

「.env」ファイルの生成する

「/config/.env」に定義した定数を呼び出す

CakePHP4では「app_local.php」と「.env」のどちらを使う方がいい？

CakePHP4の関連記事

GoogleAdwords

GoogleAdwords

Message コメントをキャンセル

関連記事

CakePHP 2.3　Search Pluginで検索処理　その２表示件数を動的に変える方法

CakePHP3のUpload Plugin 3.0をバリデーションなど実運用向けのカスタマイズ方法解説・その２

CakePHP3で静的ページの作成は webrootか pagesを使う。トップページを参考に解説

CakePHP5でヘルパーから他のヘルパーを読み込む方法・CakePHP4からの変更点

VirtualBoxにCakePHP3を設置。必要なCentOS、Apache、PHP、MySQL、Composerをインストールし設定する

CakePHP4のCakeDC/Usersの画面、メール本文テンプレートのカスタマイズ方法解説

CakePHP3でCookieを保存、呼び出し、削除の操作・CakePHP3.7対応

CakePHP3で生の SQLの実行はConnectionManagerを使う

CakePHP3でPHP Simple HTML DOM Parserを使ってスクレイピングする方法

CakePHP3のインストールでURL rewriting……のエラーが！その解決方法解説

WordPress投稿にPHPを記述するショートコードの使い方add_shortcode

コピーコンテンツ対策.htaccessで直リンク禁止しリダイレクトで対応

評価点投票プラグイン10個を比較！WordPressで口コミサイトを構築

BackWPupでバックアップ・リストア（復元）の具体的手順

コンパクトキーボード・KEK-EA9AU・FKB1420の魅力