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 5.x CakePHP3

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

Message コメントをキャンセル

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

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

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

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

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

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

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

: Google Analytics APIを CakePHP3で動かしてレポートデータを取得する方法の解説

CakePHP3で Google Analytics APIからレポートデータを取得する処理の解説。PHPのサンプルソースをCakePHP3で動くように改造。加えて、ディメンションやメトリックスを条件に設定する方法なども。

: CakePHP3の更新画面でUpload Plugin 3.0を使う方法、viewで使う方法解説・その３

CakePHP3でファイル、画像をアップロードするプラグイン、upload plugin 3を導入する手順を解説した記事。3部作のその3で記事を更新する際のファイルの取り回しなどについてを解説。

: CakePHPで Auto Incrementを外すと Duplicate entry ‘0’ for keyのエラーが出るかも

CakePHPでAuto Incrementの設定を変更したときに「Duplicate entry ‘0’ for key」のエラーが出た。原因はModel内で IDを編集する処理の追加を忘れていたからだった。

: CakePHP2、CakePHP3、CakePHP4、CakePHP5のバージョンを調べる 2つの方法

CakePHPのバージョンの調べ方2点を紹介。CakePHP3～CakePHP5は共通だが CakePHP2はフォルダ構成が異なるためコマンドのパスもオプションも異なる。

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

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

: CakePHP3でkeywords、DescriptionをHTMLヘルパーを使って設定する

CakePHP3のkeywordsとdescriptionを設定する方法の解説。CakePHP3にはmetaタグを編集するHTMLヘルパーが用意されているためそれを利用すればOK！ポイントはブロック化を有効にすること。

: CakePHP5系で認証機能のAuthenticationプラグインをインストール・エラー発生注意

CakePHPのユーザ認証に使用するオフィシャルなプラグインAuthenticationだが、CakePHP5系では Authentication Ver.3系を使う必要があるが、公式ChiffonBookが間違えている。

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

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で画像・ファイルのアップロード処理を自作・解説付き・その２

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

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

Google Analytics APIを CakePHP3で動かしてレポートデータを取得する方法の解説

CakePHP3の更新画面でUpload Plugin 3.0を使う方法、viewで使う方法解説・その３

CakePHPで Auto Incrementを外すと Duplicate entry ‘0’ for keyのエラーが出るかも

CakePHP2、CakePHP3、CakePHP4、CakePHP5のバージョンを調べる 2つの方法

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

CakePHP3でkeywords、DescriptionをHTMLヘルパーを使って設定する

CakePHP5系で認証機能のAuthenticationプラグインをインストール・エラー発生注意

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　追記）