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 コメントをキャンセル

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

: CakePHPで同一テーブル内の値を比較する条件でレコードを取得する方法

CakePHPの同一テーブルにある項目の値を比較し条件に合致するレコードを取得する方法を解説。［”項目名”=>”値”]ではなく[”項目名 = 項目名”］と書くところがポイント。

: CakePHP3で環境変数を設定して本番環境と開発環境を分けて処理をする場合

CakePHP3で開発環境と本番環境とで違う設定ファイルを読み込ませて環境ごとに定数を切り替える方法を解説。Apacheのhttpd.confに環境変数を設定し、それを読み込み判別する。

: CakePHP4、5で$_SERVERと同じようにURIを取得する「getUri()」の紹介

PHPでサーバ情報、環境情報を取得する際は「$_SERVER」を利用するが、似たような情報をCakePHPの関数で取得する際は「getUri()」を使用する。取得出来る値は一致するものもあるが、違うものもあり便利な使い方もある。

: CakePHPのバリデーションを入力値・項目の条件によって変える方法を解説

入力された値によってバリデーション（入力チェック）の内容を切り替える。その処理をCakePHPで実装する方法を解説。条件ごとに unset関数を使ってバリデーションを削除する、という方法を採る。

: CakePHP4 のコマンドプログラムからコンポーネントを読み込む方法解説

CakePHP4でコマンドプログラムからコンポーネントを呼び出す方法を解説。コントローラーから呼び出すときと大差はないが、use句でコンポーネントを指定する事がポイント。

: CakePHP3のcontroller内でテンプレート、レイアウトを変更する際の指定方法

CakePHP3でテンプレートファイルやレイアウトファイルをデフォルトのものから別のものに変更したい場合の指定方法を解説。

: CakePHP3にOGPをfetch、asignを利用してテンプレートごとに指定する方法を解説

CakePHP3でOGPを設定する方法を解説。fetch、assignを使用しレイアウトファイルに編集した変数にテンプレートファイルから値を指定する。これを利用してOGPを編集する。

: CakePHP3のCakeDC/Usersのログイン後のリダイレクトとユーザ権限管理の設定解説

CakeDC謹製Usersプラグインの紹介。ログイン認証後にリダイレクトする先の設定方法についての解説と実運用するために必要なコツを解説。便利な仕組みも仕様の理解があって初めてうまく使いこなせる。

: CakePHP3の画像、ファイルアップロードプラグインUpload Plugin 3.0の設置解説・その１

CakePHP3でファイル、画像をアップロードするプラグイン、upload plugin 3を導入する手順を解説した記事。3部作のその1で基本的な導入方法の解説で読みながら簡単に導入が可能。

: CakePHP3でレコードを保存（追加、更新、Insert、Update）する複数の方法を紹介

CakePHP3でレコードを追加、更新（Insert、Update）する記述方法を解説。1件ずつ処理、全件をまとめて処理、条件に該当する複数件のレコードを処理方法をサンプルコードを用いて解説。

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 コメントをキャンセル

関連記事

CakePHPで同一テーブル内の値を比較する条件でレコードを取得する方法

CakePHP3で環境変数を設定して本番環境と開発環境を分けて処理をする場合

CakePHP4、5で$_SERVERと同じようにURIを取得する「getUri()」の紹介

CakePHPのバリデーションを入力値・項目の条件によって変える方法を解説

CakePHP4 のコマンドプログラムからコンポーネントを読み込む方法解説

CakePHP3のcontroller内でテンプレート、レイアウトを変更する際の指定方法

CakePHP3にOGPをfetch、asignを利用してテンプレートごとに指定する方法を解説

CakePHP3のCakeDC/Usersのログイン後のリダイレクトとユーザ権限管理の設定解説

CakePHP3の画像、ファイルアップロードプラグインUpload Plugin 3.0の設置解説・その１

CakePHP3でレコードを保存（追加、更新、Insert、Update）する複数の方法を紹介

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