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

2019/08/04 2019/08/05

Apacheに環境変数を設定し本番環境と開発環境を振り分ける処理

定数の設定ファイルを本番環境用と開発環境用とで分ける

　
「CakePHP3でユーザ定義の定数、変数を設定し、読み込む方法解説」で、定数、変数を別ファイルで管理する方法を解説しました。
　
PHP7以降は、配列も「define()」で定数として指定できるようになりましたので、配列も含めて定数として保持しておきたい情報を管理することが楽になりました。
　
　
今回は、その定数などを設定しておく設定ファイルを、開発環境と本番環境とで自動的に切り替える方法を解説します。
　
　
例えば、下記のような URLなどの開発環境と本番環境で値が違う場合を想定しています。
　

// 開発環境
define("SITE_URL","http://localhost");

// 本番環境
define("SITE_URL","http://example.com");

// 開発環境

define("SITE_URL","http://localhost");

// 本番環境

define("SITE_URL","http://example.com");

　
本番環境では本番環境のものを、開発環境では開発環境のものが取得されるようにすることで、本番環境にアップする際に設定情報を変更することなく、そのままアップすればいい、という仕組みを構築することができるようになります。
　
　
対応の詳細は次項以降で解説しますが、開発環境の方に「環境変数」を設定しておき、それが取得できた場合は開発環境と判定して開発環境の定数ファイルを読み込む、という仕組みです。
（「環境変数」が取得できない場合は、本番環境と判定します。）
　
　

定数ファイルを作成

　
まずは、「CakePHP3でユーザ定義の定数、変数を設定し、読み込む方法解説」の記事に沿って設定ファイルを作成します。
　
開発環境用
/config/const_develop.php
　
本番環境用
/config/const_production.php
　
　
開発環境用の「const_develop.php」には下記を設定します。
　

<?php
use Cake\Core\Configure;
return [
    // サイトの URL
    define("SITE_URL", "http://localhost"),
];

<?php

use Cake\Core\Configure;

return [

// サイトの URL

define("SITE_URL", "http://localhost"),

];

　
　
本番環境用の「const_production.php」には下記を設定します。
　

<?php
use Cake\Core\Configure;
return [
    // サイトの URL
    define("SITE_URL", "http://example.com"),
];

<?php

use Cake\Core\Configure;

return [

// サイトの URL

define("SITE_URL", "http://example.com"),

];

定数ファイルを取得する bootstrap.phpに分岐処理を記述

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

    // 定数ファイルを読み込み
    if (isset($_SERVER["CAKE_ENV"]) && $_SERVER["CAKE_ENV"] == "develop"){
        Configure::load("const_develop");
    } else {
        Configure::load("const_production");
    }

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

try {

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

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

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

if (isset($_SERVER["CAKE_ENV"]) && $_SERVER["CAKE_ENV"] == "develop"){

Configure::load("const_develop");

} else {

Configure::load("const_production");

}

} catch (\Exception $e) {

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

}

　
上記の 6行目のように環境変数によって処理を振り分ける処理を記述します。
　
　
環境変数は、「getenv("CAKE_ENV")」でも取得することができます。
CakePHP3の場合は、「env("CAKE_ENV")」でも取得することができます。
　
また、私の環境ではうまく取ることができませんでしたが、「$_ENV["CAKE_ENV"]」でも取得できるようです。
　
　

環境変数をApacheの設定ファイル「httpd.conf」に設定

　
最後に、振り分け処理で利用する「環境変数」を設定します。
環境変数は、開発環境にのみ指定します。
（ある程度自由に設定情報を変更することができる開発環境にのみ設定する、というところもポイントです。）
　
　
設定場所は、Apacheの設定ファイル「/etc/httpd/conf/httpd.conf」です。
（「httpd.conf」のパスは CentOSを想定しています）。
　
「httpd.conf」ファイルを開いて、ファイルの一番最後などに書きの記述を追加します。
　

SetEnv CAKE_ENV develop

1	SetEnv CAKE_ENV develop

　
「CAKE_ENV」が環境変数の変数名で、「develop」がその値になります。
複数設定することもできます。
　
設定後は Apacheを再起動して環境変数を反映させます。
　
　
また、環境変数が正しく反映されたことの確認には、「phpinfo()」を実行する方法があります。正しく設定されている場合は画面に表示されます。
　
　
これで、設定した環境変数が取得できれば、開発環境の設定ファイルが読み込まれるようになります。
　
　

Shellを実行する場合はコマンド内に環境変数を指定する

　
CakePHP3の Shellでバッチ処理を作成して、コマンドラインから Shellを起動して実行する場合は、下記のようにコマンド内に環境変数を指定します。
　

// コマンドラインからシェルを実行する
$ bin/cake SampleTests getList

// コマンドの前に環境変数を指定する
$ CAKE_ENV=develop bin/cake SampleTests getList

// コマンドラインからシェルを実行する

$ bin/cake SampleTests getList

// コマンドの前に環境変数を指定する

$ CAKE_ENV=develop bin/cake SampleTests getList

　
Shellを実行する場合、Apacheを経由せずにプログラムが実行されるため、Apacheの設定ファイル「/etc/httpd/conf/httpd.conf」に環境変数を記述していてもそれは読み込まれません。
　
そのため、実行するコマンドの中に環境変数を直接記述しておく必要があるのです。
　
　

- CakePHP 3.x 4.x CakePHP3

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

Message コメントをキャンセル

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

: MySQL、CakePHP 2.3で「tinyint(1)」の Boolean型の動作を再確認

MySQL＋CakePHPの環境で「tinyint(1)」を利用する際の動作を検証。「tinyint(1)」の Boolean型について CakePHPでは自動処理が実施されていることを確認しました。

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

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

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

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

: CakePHP3でDocumentRootやtmp、webroot、logsなどのフォルダへのパスの定数

CakePHP3で特定フォルダのパスの定数を解説。root、DocumentRoot、app、config、webroot、tests、tmp、cache、vendor、コア、コアの srcが設定済み。realpath()関数を使うと柔軟なパス指定が可能。

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

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

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

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

: CakePHP 2.3　Search Pluginで検索処理　その４前方一致検索、後方一致検索、不等号による検索、between句による範囲検索

CakePHPの検索プラグイン Search Pluginの検索処理の中で前方一致検索、後方一致検索、不等号による検索、between句による範囲検索の解説です。

: CakePHP3、CakePHP4のキャッシュをクリアする方法「bin/cake cache clear_all」を使う

CakePHP3、CakePHP4では処理を高速化する手法の一つとしてキャッシュを利用している。しかし、その情報は元の情報を更新しても反映されない場合がある。そんなときはキャッシュを削除する必要がある。

: CakePHP3のルーティング（routes.php）の変更が反映されない時はキャッシュのクリアを

CakePHP3でルーティングの設定変更をしたけど反映されない！そんなときは慌てず騒がずキャッシュをクリアしよう！ルーティングの設定もキャッシュされることがあるらしい。

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

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