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でデフォルトのソート条件を設定してユーザの選択肢たソート条件を有効にする方法

CakePHP3でデフォルトのソート条件を設定しつつ画面上でユーザがソート条件を選択したときもソート処理を実行させる方法を解説。ソート条件はページネーションの処理として実装。

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

ID以外のカラムでアソシエーション（連携）させるための考え方とサンプルソースを用いての説明を行っています。

: CakePHP3のCakeDC/Users、Authでログインなしでもアクセスを許可する設定

CakePHP3の Authコンポーネントや CakeDC/Usersプラグインなどを利用したユーザ管理・認証システムにおいて、ログインしていなくても見ることができるページの設定方法を解説。

: CakePHP3でデータを保存する save()で発生するエラーを確認する方法を解説

CakePHP3でデータ保存処理のログを取得する方法。save()では true、falseの戻り値しか取得できないが、saveOrFail()と try…catch文を使いエラーログ、エンティティを取得し、不具合の解析を行う。

: CakePHP 2.3　Search Pluginで検索処理　その６ORDER、sortソートの機能

CakePHPの検索プラグイン Search Pluginの検索処理の中で order、ソートについての解説です。

: CakePHP 2.3で確認画面付きのお問い合わせフォームの作り方

CakePHPで確認画面付きのお問い合わせフォーム、メールフォームの作り方をサンプルを提示しながら解説。

: CakePHP3でDocumentRootやwebroot、imgフォルダのURLやドメイン、パスを取得

URLやドメイン、フォルダへのパスの取得は、ビューではUrlHelperを使い、コントローラーではRouterクラスを使います。第2引数の指定でURLを取得することも可能。

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

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

: CakePHP 2.3　Search Pluginで検索処理　その７queryを使って日付の範囲検索

CakePHPの検索プラグイン Search Pluginの検索処理の中で queryを使って日付の範囲検索の方法です。

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

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

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　ID以外のカラムでアソシエーション（連携）をさせる場合

CakePHP3のCakeDC/Users、Authでログインなしでもアクセスを許可する設定

CakePHP3でデータを保存する save()で発生するエラーを確認する方法を解説

CakePHP 2.3　Search Pluginで検索処理　その６ORDER、sortソートの機能

CakePHP 2.3で確認画面付きのお問い合わせフォームの作り方

CakePHP3でDocumentRootやwebroot、imgフォルダのURLやドメイン、パスを取得

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

CakePHP 2.3　Search Pluginで検索処理　その７queryを使って日付の範囲検索

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

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