CakePHP3でユーザ定義の定数、変数を設定し、読み込む方法解説

2017/11/05 2022/07/16

CakePHP3でユーザ定義の定数、変数を設定し、読み込む

　
CakePHP3でサイトの構築をする際に、プログラム全体で使用する定数や変数を設定し、それを呼び出す方法について解説します。
　
　
小規模なサイトであれば、定数、共通変数は「bootstrap.php」に書いていく方法があります。
ファイルを分ける必要もないため、シンプルな方法です。
その方法が「bootstrap.phpに変数を設定する方法」です。
　
ですが、サイトの規模が大きくなると、設定する定数、共通変数も多くなっていき、「bootstrap.php」が肥大化しますので、定数、共通変数は別のファイルに分けて設定する方法もあります。
その方法が「定数、変数を設定するファイルを別にする方法」です。
　
また、定数、変数を別ファイルにする方法は、もう一つやり方がありまして、それが「定数、変数を設定するファイルを別にする方法・その２」です。
　
　
CakePHP4で定数の設定と呼び出し方法の解説（defineとConfigure）
CakePHP4でユーザ定義の定数を設定する方法は、改めて上記に記事を書いていますので、こちらを参考にしてください。
CakePHP4と CakePHP3の設定方法の違いは、「bootstrap.php」に記述する場合は CakePHP3から変更はありませんが、別ファイルに定数を記述する場合は CakePHP3とは少し異なる部分があります。
　
　
　

bootstrap.phpに変数を設定する方法

「/app/Config/bootstrap.php」に定数、変数を設定

　
「/app/Config/bootstrap.php」に変数、および、定数を設定します。
　

// 定数の定義
define("TEST","定数テスト");

// 変数の定義
Configure::write("text1", "変数のテキスト");

// 配列の定義
Configure::write("array1", ["0"=>"配列０","1"=>"配列１"]);

// 連想配列の定義
Configure::write("array2", ["a"=>"配列ａ","b"=>"配列ｂ"]);

// 定数の定義

define("TEST","定数テスト");

// 変数の定義

Configure::write("text1", "変数のテキスト");

// 配列の定義

Configure::write("array1", ["0"=>"配列０","1"=>"配列１"]);

// 連想配列の定義

Configure::write("array2", ["a"=>"配列ａ","b"=>"配列ｂ"]);

　
定数を定義する「define()」関数は、PHPの標準関数をそのまま利用できます。
　
変数を定義する場合は、「Configure::write()」を利用します。
引数の 1つ目が「変数名」になり、2つ目がその変数に入れる値になります。
　
2つ目の引数に配列、連想配列を設定することで、定義する変数も配列、連想配列にすることができます。
　
配列を設定しているだけですので、下記のような記述の方法も可能です。

Configure::write("array2", array("0"=>"配列０","1"=>"配列１"));

1	Configure::write("array2", array("0"=>"配列０","1"=>"配列１"));

　
　
また、下記の様にまとめて複数の変数の設定をすることもできます。

Configure::write( [
    "array1" => ["0"=>"配列０","1"=>"配列１"],
    "array2" => ["a"=>"配列ａ","b"=>"配列ｂ"],
]);

Configure::write( [

"array1" => ["0"=>"配列０","1"=>"配列１"],

"array2" => ["a"=>"配列ａ","b"=>"配列ｂ"],

]);

定数に配列を指定する（2019.03.16　追記）

　
PHP 5.6以降では定数に配列を設定することができるようになりましたが、「define()」で配列を指定できるのは PHP7以降からです。
　
そのため、PHPのバージョンが 7以降の場合は、CakePHP3でも下記の記述方法で定数として配列を指定することができます。
　

define("TEST_ARRAY", ["配列１","配列２","配列３"]);

1	define("TEST_ARRAY", ["配列１","配列２","配列３"]);

　
この記事では、
　スカラー値（文字列、数値など）「define()」
　配列は「Configure::write()」
のような記述の仕方をしていましたが、PHP7以降は、文字通り
　定数は「define()」
　変数は「Configure::write()」
で指定することになります。
　
　

設定した変数、定数を読み込む方法

　
定数として指定した情報を呼び出す場合は、呼び出すコントローラーの最初に「use」で「Configure」を呼び出します。
（定数だけを読み込む場合は、「use」の設定は必要ありません。）
　

use Cake\Core\Configure;

1	use Cake\Core\Configure;

　
　
各定数、変数を読み込む方法は、以下のようになります。
　

// 定数を読み込む
echo TEST;       //「定数テスト」と表示される

// 定数を読み込む
$getText1   = Configure::read("text1");
echo $getText1;  //「変数のテキスト」と表示される

// 配列を読み込む
$getArray1  = Configure::read("array1");
echo $getArray1[0]  //「配列０」と表示される

// 連想配列を読み込む
$getArray2  = Configure::read("array2");
echo $getArray2["a"]  //「配列ａ」と表示される

// 定数を読み込む

echo TEST; //「定数テスト」と表示される

// 定数を読み込む

$getText1 = Configure::read("text1");

echo $getText1; //「変数のテキスト」と表示される

// 配列を読み込む

$getArray1 = Configure::read("array1");

echo $getArray1[0] //「配列０」と表示される

// 連想配列を読み込む

$getArray2 = Configure::read("array2");

echo $getArray2["a"] //「配列ａ」と表示される

　
　
変数は、view側ではそのままは使えませんが、定数は view側でも直接呼び出して使用することができます。
つまり、定数は、テンプレートファイルに下記の様に記述することで、直接呼び出すことができます。

// 定数を読み込む
echo TEST;       //「定数テスト」と表示される

1 2	// 定数を読み込む echo TEST; //「定数テスト」と表示される

定数、変数を設定するファイルを別にする方法

　
続いて、定数、変数を「bootstrap.php」ファイル以外の別ファイルに設定する方法を解説します。
　

「/app/Config/const.php」ファイルを作成し、定数、変数を設定

　
「/app/Config/」フォルダの中に「const.php」ファイルを新規作成します。
（ファイル名は「const.php」にしていますが、ファイル名の決まりはありませんので、自由なファイル名にしてください。）
　
作成したファイルに下記を記述します。
　

<?php
use Cake\Core\Configure;

return [
    // 定数の定義
    define("TEST","定数テスト"),

    // 変数の定義
    Configure::write("text1", "変数のテキスト"),
];

<?php

use Cake\Core\Configure;

return [

// 定数の定義

define("TEST","定数テスト"),

// 変数の定義

Configure::write("text1", "変数のテキスト"),

];

　
ここで設定する定数、変数は、「return」の引数として配列で指定します。
そのため、定数、変数の指定行は配列の値となりますので、それぞれの行の終わりは、「;」ではなく「,」で区切ります。
　
配列で指定しますので、下記の様に記述しても問題ありません。
　

return array(
    // 定数の定義
    define("TEST","定数テスト"),

    // 変数の定義
    Configure::write("text1", "変数のテキスト"),
);

return array(

// 定数の定義

define("TEST","定数テスト"),

// 変数の定義

Configure::write("text1", "変数のテキスト"),

);

　
ちなみに「return」の記述を忘れた場合は、「Config file "const.php" did not return an array」というエラーが表示されます。
　
　
また、ファイルの最初に「use Cake\Core\Configure;」を記述します。
この記述は忘れがちなので、忘れないようにしましょう。
　
記述を忘れた場合は「Error: Class 'Configure' not found」というエラーメッセージがでますので、記述忘れに気づかないことはありませんが．．．
　
　

「/app/Config/bootstrap.php」に定数ファイルを読み込む設定

　
設定した「const.php」ファイルを、「bootstrap.php」に読み込む設定を記述します。
　
「/app/Config/bootstrap.php」に下記を記述します。
　

Configure::load("const");

1	Configure::load("const");

　
記述する場所は分かりやすく「bootstrap.php」ファイルの一番最後などに記述しても OKですが、「bootstrap.php」の 75行目辺りから始まる、他のファイルもロードしている処理に追記する方がより良いでしょう。（下記 5行目、6行目を追加しています。）
　

try {
    Configure::config('default', new PhpConfig());
    Configure::load('app', 'default', false);

    // 定数ファイルを読み込み
    Configure::load("const");

} catch (\Exception $e) {
    exit($e->getMessage() . "\n");
}

try {

Configure::config('default', new PhpConfig());

Configure::load('app', 'default', false);

// 定数ファイルを読み込み

Configure::load("const");

} catch (\Exception $e) {

exit($e->getMessage() . "\n");

}

　
　
「/app/Config/bootstrap.php」には、デフォルトで「use Cake\Core\Configure;」は記載されていますので、改めて追記する必要はありません。
　
　

設定した変数、定数を読み込む方法

　
設定した変数、定数を読み込む方法は、先の「bootstrap.phpに変数を設定する方法」と同じですので、ほぼコピペになりますが以下のようになります。
　
　
定数として指定した情報を呼び出す場合は、呼び出すコントローラーの最初に「use」で「Configure」を呼び出します。
　

use Cake\Core\Configure;

1	use Cake\Core\Configure;

　
　
各定数、変数を読み込む方法は、以下のようになります。
　

// 定数を読み込む
echo TEST;       //「定数テスト」と表示される

// 定数を読み込む
$getText1   = Configure::read("text1");
echo $getText1;  //「変数のテキスト」と表示される

// 定数を読み込む

echo TEST; //「定数テスト」と表示される

// 定数を読み込む

$getText1 = Configure::read("text1");

echo $getText1; //「変数のテキスト」と表示される

定数、変数を設定するファイルを別にする方法・その２

　
定数、変数を「bootstrap.php」ファイル以外の別ファイルに設定する方法のその２を解説します。
この方法は、CakePHP2のころも利用できた方法です。
　
　

「/app/Config/const.php」ファイルを作成し、定数、変数を設定

<?php
// 定数の定義
define("TEST","定数テスト");

// 変数の定義
$config['text1'] = "変数のテキスト";

// 配列の定義
$config['array1'] = array("0"=>"配列０","1"=>"配列１");

// 連想配列の定義
$config['array2'] = array("a"=>"配列ａ","b"=>"配列ｂ");

<?php

// 定数の定義

define("TEST","定数テスト");

// 変数の定義

$config['text1'] = "変数のテキスト";

// 配列の定義

$config['array1'] = array("0"=>"配列０","1"=>"配列１");

// 連想配列の定義

$config['array2'] = array("a"=>"配列ａ","b"=>"配列ｂ");

「/app/Config/bootstrap.php」に定数ファイルを読み込む設定

　
設定した「const.php」ファイルを、「bootstrap.php」に読み込む設定を記述します。
（この設定方法は、「定数、変数を設定するファイルを別にする方法」と同じです。）
　
「/app/Config/bootstrap.php」に下記を記述します。
　

Configure::load("const");

1	Configure::load("const");

　
こちらも「定数、変数を設定するファイルを別にする方法」と同じく、「bootstrap.php」の 75行目辺りから始まる、他のファイルもロードしている処理に追記する方がより良いでしょう。（下記 5行目、6行目を追加しています。）
　

try {
    Configure::config('default', new PhpConfig());
    Configure::load('app', 'default', false);

    // 定数ファイルを読み込み
    Configure::load("const");

} catch (\Exception $e) {
    exit($e->getMessage() . "\n");
}

try {

Configure::config('default', new PhpConfig());

Configure::load('app', 'default', false);

// 定数ファイルを読み込み

Configure::load("const");

} catch (\Exception $e) {

exit($e->getMessage() . "\n");

}

設定した変数、定数を読み込む方法

　
設定した変数、定数を読み込む方法も、「定数、変数を設定するファイルを別にする方法」と同じですので、ほぼコピペになりますが以下のようになります。
　
　
定数として指定した情報を呼び出す場合は、呼び出すコントローラーの最初に「use」で「Configure」を呼び出します。
　

use Cake\Core\Configure;

1	use Cake\Core\Configure;

　
　
各定数、変数を読み込む方法は、以下のようになります。
　

// 定数を読み込む
echo TEST;       //「定数テスト」と表示される

// 定数を読み込む
$getText1   = Configure::read("text1");
echo $getText1;  //「変数のテキスト」と表示される

// 定数を読み込む

echo TEST; //「定数テスト」と表示される

// 定数を読み込む

$getText1 = Configure::read("text1");

echo $getText1; //「変数のテキスト」と表示される

広く知られている方法は「その２」の方である

　
「その２」として紹介した方法が、多くのブログで紹介されている方法です。
ですが、「その２」の方法は、「bootstrap.php」に直接記述しても情報を取得することができず、また、「use Cake\Core\Configure;」を記述していなかったことでうまく動作しませんでした。
　
そのため、エラーを解消するために調べたときに「その１（定数、変数を設定するファイルを別にする方法）」の方法に行きつき、先に「その１」の方の記事を書きました。
　
その後さらに調査した結果、「その２」も上記の手順であれば動作させることもできたため、「その２」の方法も記事に入れることにしました。
　
　
CakePHP3　オフィシャルサイト　環境変数
https://book.cakephp.org/3.0/ja/development/configuration.html#environment-variables
　
ただ、「その１（定数、変数を設定するファイルを別にする方法）」は、上記のオフィシャルサイトに記載されている方法に基づいて書いています。
CakePHP3では新しい仕組みも増えてきていますので、「その１」の方が活用用途は高いかもしれません。
　
　

- CakePHP 3.x 4.x CakePHP3

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

Message コメントをキャンセル

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

: CakePHP3で画像・ファイルのアップロード処理を自作・解説付き・その２

ファイルのアップロード機能の自作サンプルコードとその解説のその２。アップロード機能に関連するファイルの更新や削除の処理や画像、フォルダのパスの指定方法などを含めて解説。

: CakePHP 2.3　Search Pluginで検索処理　その１設置方法

CakePHPの検索プラグイン Search Pluginの設置方法と基本的な検索処理の解説です。

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

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

: CakePHP3で「SQLSTATE[23000]: Integrity constraint violation」「SQLSTATE[42S22]: Column not found」などのエラーが出たときの確認するポイント

CakePHP3の開発で発生する「SQLSTATE[23000]: Integrity constraint violation」「SQLSTATE[42S22]: Column not found」のエラーには特有の原因もあるため、その説明と対処方法の解説。

: CakePHP4でロギングスコープやログレベルを使用してログを出し分ける方法を解説

CakePHPのログ出力方法の解説。app.phpにログ設定をし、スコープやレベルを指定してログ出力を振り分ける方法、CakePHP4で配列出力にはvar_exportが必要なことなどを解説。

: CakePHP3でテーブルにカラム（項目）を追加したときに変更するポイントのまとめ

CakePHP3でシステム開発をする際、途中でカラムを追加した場合に何を変更すればいいかを確認。カラムを追加する前後で Bakeした結果を比較し、変更になった点をリストアップした。

: CakePHP3でPHPExcelを使ってエクセルファイルを生成、出力する方法

CakePHP3でPHPExcelを利用してエクセルを編集、出力するサンプルソース＋解説。PHPExcelのインストール方法の解説からファイル保存とダウンロードの方法なども解説。

: CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合の詳細ページの注意点

ID以外のカラムでアソシエーション（連携）させて詳細ページを表示させる際の考え方と注意点をサンプルソースを用いて解説しています。

: CakePHP3の検索プラグイン「friendsofcake/search」の様々な検索の仕方の実装方法

CakePHP3で検索をするプラグイン「friendsofcake/search」の検索条件のカスタマイズ方法の解説。検索項目を増やしたり、以上、以下での検索や、チェックボックスによる検索の方法などを解説。

: CakePHP3でモデルなしフォームからCSVをアップロードしレコードを更新する方法解説

CakePHP3でCSVファイルをアップロードしレコードを追加、更新する処理の作成方法の解説。モデルとは直接関連しないフォームからCSVファイルをアップロードするため汎用的に使用可能。

PREV: CakePHP3、CakePHP4、CakePHP5のバージョンを指定してインストールする詳細な手順を解説
NEXT: CakePHP3の画像、ファイルアップロードプラグインUpload Plugin 3.0の設置解説・その１

日	月	火	水	木	金	土
	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	31

CakePHP3でユーザ定義の定数、変数を設定し、読み込む方法解説

CakePHP3でユーザ定義の定数、変数を設定し、読み込む

bootstrap.phpに変数を設定する方法

「/app/Config/bootstrap.php」に定数、変数を設定

定数に配列を指定する（2019.03.16　追記）

設定した変数、定数を読み込む方法

定数、変数を設定するファイルを別にする方法

「/app/Config/const.php」ファイルを作成し、定数、変数を設定

「/app/Config/bootstrap.php」に定数ファイルを読み込む設定

設定した変数、定数を読み込む方法

定数、変数を設定するファイルを別にする方法・その２

「/app/Config/const.php」ファイルを作成し、定数、変数を設定

「/app/Config/bootstrap.php」に定数ファイルを読み込む設定

設定した変数、定数を読み込む方法

広く知られている方法は「その２」の方である

CakePHP3の関連記事

GoogleAdwords

GoogleAdwords

Message コメントをキャンセル

関連記事

CakePHP3で画像・ファイルのアップロード処理を自作・解説付き・その２

CakePHP 2.3　Search Pluginで検索処理　その１設置方法

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

CakePHP3で「SQLSTATE[23000]: Integrity constraint violation」「SQLSTATE[42S22]: Column not found」などのエラーが出たときの確認するポイント

CakePHP4でロギングスコープやログレベルを使用してログを出し分ける方法を解説

CakePHP3でテーブルにカラム（項目）を追加したときに変更するポイントのまとめ

CakePHP3でPHPExcelを使ってエクセルファイルを生成、出力する方法

CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合の詳細ページの注意点

CakePHP3の検索プラグイン「friendsofcake/search」の様々な検索の仕方の実装方法

CakePHP3でモデルなしフォームからCSVをアップロードしレコードを更新する方法解説

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

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

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

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

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

CakePHP3でユーザ定義の定数、変数を設定し、読み込む方法解説

CakePHP3でユーザ定義の定数、変数を設定し、読み込む

bootstrap.phpに変数を設定する方法

「/app/Config/bootstrap.php」に定数、変数を設定

定数に配列を指定する（2019.03.16 追記）

設定した変数、定数を読み込む方法

定数、変数を設定するファイルを別にする方法

「/app/Config/const.php」ファイルを作成し、定数、変数を設定

「/app/Config/bootstrap.php」に定数ファイルを読み込む設定

設定した変数、定数を読み込む方法

定数、変数を設定するファイルを別にする方法・その２

「/app/Config/const.php」ファイルを作成し、定数、変数を設定

「/app/Config/bootstrap.php」に定数ファイルを読み込む設定

設定した変数、定数を読み込む方法

広く知られている方法は「その２」の方である

CakePHP3の関連記事

GoogleAdwords

GoogleAdwords

Message コメントをキャンセル

関連記事

定数に配列を指定する（2019.03.16　追記）