イントロダクション
Laravelフレームワークの前設定ファイルは、configディレクトリに保存されています。各オプションには詳しいコメントが付いているので、各ファイルを一読し、使用できるオプションを把握しておきましょう。
環境設定
アプリケーションを実行している環境にもとづき、別の設定値に切り替えられると便利です。たとえば、ローカルと実働サーバでは、異なったキャッシュドライバを使いたいことでしょう。
これを簡単にできるようにするために、LaravelではVance
Lucas氏により作成された、DotEnv
PHPライブラリーを使用しています。新たにLaravelをインストールすると、アプリケーションのルートディレクトリには、env.exampleファイルが含まれています。ComposerによりLaravelをインストールした場合は自動的に、このファイルは.envに名前が変更されます。Composerを使わずにインストールした場合は、名前を変更してください。
Tip!!
.env.testingファイルを作成することもできます。このファイルは.envファイルの値をPHPUnitテスト実行時と、Artisanコマンドを--env=testingオプション付きで起動した場合にオーバーライドします。
環境設定の取得
このファイルにリストしている値は、アプリケーションがリクエストを受け取った時点で、$_ENV
PHPスーパーグローバル変数へロードされます。しかし、設定ファイルの変数をenvヘルパを使用して、値を取得できます。実際にLaravelの設定ファイルを見てもらえば、このヘルパで多くのオプションが使われているのに気がつくでしょう。
'debug' => env('APP_DEBUG', false),env関数の第２引数は「デフォルト値」です。この値は指定したキーの環境変数が存在しない場合に返されます。
.envファイルをアプリケーションのソース管理に含めてはいけません。アプリケーションの各開発者／サーバで異なった環境設定が必要になるからです。
チーム開発を行っている場合、.env.exampleファイルをアプリケーションに含めたいと思うでしょう。サンプルの設定ファイルに、プレースホルダーとして値を設定しておけば、チームの他の開発者は、アプリケーションを実行するために必要な環境変数をはっきりと理解できるでしょう。
現在環境の決定
現在のアプリケーション環境は、.envファイルのAPP_ENV変数により決まります。APPファサードのenvironmentメソッドにより、この値へアクセスできます。
$environment = App::environment();指定した値と一致する環境であるかを確認するために、environmentメソッドへ引数を渡すこともできます。必要であれば、複数の値をenvironmentメソッドへ渡せます。値のどれかと一致すれば、メソッドはtrueを返します。
if (App::environment('local')) {
// 環境はlocal
}
if (App::environment('local', 'staging')) {
// 環境はlocalかstaging
}設定値へのアクセス
アプリケーションのどこからでもグローバルのconfigヘルパ関数を使用し、設定値へ簡単にアクセスできます。設定値はファイルとオプションの名前を含む「ドット」記法を使いアクセスします。デフォルト値も指定でき、設定オプションが存在しない場合に、返されます。
$value = config('app.timezone');実行時に設定値をセットするには、configヘルパへ配列で渡してください。
config(['app.timezone' => 'America/Chicago']);設定キャッシュ
アプリケーションをスピードアップさせるために、全設定ファイルを一つのファイルへまとめる、config:cache
Artisanコマンドを使ってください。これによりアプリケーションの全設定ファイルのオプションが、単一のファイルに結合され、素早くロードできるようになります。
通常は開発ルーティンの一環として、php artisan config:cacheコマンドを実行すべきでしょう。アプリケーション開発時は、しばしば設定が変更されるでしょうから、ローカルでの開発中にこのコマンドを実行してはいけません。
Note: 開発期間中に
config:cacheコマンドを実行する場合は、設定ファイルの中では確実にenv関数のみを使用してください。
メンテナンスモード
アプリケーションをメンテナンスモードにすると、アプリケーションに対するリクエストに対し、すべてカスタムビューが表示されるようになります。アプリケーションのアップデート中や、メンテナンス中に、アプリケーションを簡単に「停止」状態にできます。メンテナンスモードのチェックは、アプリケーションのデフォルトミドルウェアスタックに含まれています。アプリケーションがメンテナンスモードの時、ステータスコード503でMaintenanceModeException例外が投げられます。
メンテナンスモードにするには、down
Artisanコマンドを実行するだけです。
php artisan downdownコマンドには、messageとretryオプションを付けることもできます。messageの値はカスタムメッセージを表示、もしくはログするために使用し、retryの値はHTTPヘッダのRetry-Afterとしてセットされます。
php artisan down --message="Upgrading Database" --retry=60メンテナンスモードから抜けるには、upコマンドを使います。
php artisan upメンテナンスモードのレスポンステンプレート
メンテナンスモードレスポンスのデフォルトテンプレートは、resources/views/errors/503.blade.phpです。アプリケーションの必要に合わせ、自由に変更してください。
メンテナンスモードとキュー
アプリケーションがメンテナンスモードの間、キューされたジョブは実行されません。メンテナンスモードから抜け、アプリケーションが通常状態へ戻った時点で、ジョブは続けて処理されます。
メンテナンスモードの代替
メンテナンスモードでは、アプリケーションがその間ダウンタイムになってしまいますので、Laravelでの開発でゼロダウンタイムを実現するEnvoyerのような代替サービスを検討してください。