Laravel 5.3 学習ノートの構成

1. はじめに

Laravel のすべての設定ファイルは config ディレクトリに保存されており、各設定項目にはコメントが付いているため、設定ファイルの設定項目を参照するときに、設定項目の機能と使用方法を直感的に理解できます。

2. 設定値にアクセスする

設定値は、ファイル名 + "." の形式でアクセスできます。構成項目が構成されていません 次の場合はデフォルト値に戻ります:

$value = config('app.timezone');

実行時に構成値を設定したい場合は、配列パラメーターを config メソッドに渡すだけです。

config(['app.timezone ' => 'America/Chicago']);

3. 環境構成

アプリケーションが実行されている環境に基づいて異なる構成値を設定すると、優れた効果が得られます。たとえば、通常はローカルを使用します。このメカニズムは、オンライン環境とは異なるキャッシュドライバーを構成することで Laravel に簡単に実装できます。

Laravel は、Vance Lucas によって開発された PHP ライブラリ DotEnv を使用してこのメ​​カニズムを実装します。Laravel が Composer を通じてインストールされている場合、ファイルはルート ディレクトリに .env.example ファイルがあります。 .env という名前を付けます。それ以外の場合は、ファイルの名前を手動で変更する必要があります。

環境変数の設定値を取得する

アプリケーションがリクエストを受け入れるたびに、.env にリストされているすべての設定とその値が PHP スーパーグローバル変数 $_ENV にロードされ、アプリケーションで補助関数を使用できるようになります。これらの設定値を取得するには関数 env を使用します。実際、Laravel の設定ファイルを見ると、この補助関数がすでに多くの場所で使用されていることがわかります:

'debug' => env('APP_DEBUG', false),

が env 関数に渡されます。 2 番目のパラメータはデフォルト値で、環境変数が設定されていない場合はデフォルト値になります。

アプリケーションを使用する各開発者/サーバーは異なる環境構成を必要とする可能性があるため、.env ファイルをソース管理 (svn や git など) に送信しないでください。

チームで開発している場合は、アプリケーションと一緒に .env.example ファイルをソース管理に送信する必要があります。いくつかの構成値を .env.example ファイル内のプレースホルダーの形式で配置します。これにより、他の開発者は、アプリケーションを実行するためにどの環境変数を構成する必要があるかを正確に知ることができます。

現在のアプリケーション環境を決定する

現在のアプリケーション環境は、.env ファイルの APP_ENV 変数によって決定されます。その値には、アプリ ファサードの環境メソッド

$environment = App::environment() を使用してアクセスできます。 ;

環境メソッドにパラメータを渡して、現在の環境が指定された値と一致するかどうかを判断することもできます。必要に応じて複数の値を渡すこともできます。現在の環境が指定された値と一致する場合、このメソッドは true を返します:

if (App::environment('local')) {
  // The environment is local
}
 
if (App::environment('local', 'staging')) {
  // The environment is either local OR staging...
}

アプリケーション インスタンスには、ヘルパー関数 app を通じてアクセスすることもできます:

$environment = app()->environment();

4. 構成キャッシュ

アプリケーションを高速化するために、Artisan コマンド config:cache を使用して、すべての構成ファイルの構成を 1 つのファイルにキャッシュできます。これにより、すべての構成オプションが 1 つのファイルにマージされます。フレームワークによって迅速にロードできます。

アプリケーションがオンラインになったら、phpArtisan config:cache を一度実行する必要があります。ただし、ローカルで開発する場合は、設定値を変更する必要があることが多いため、このコマンドを頻繁に実行する必要はありません。

5. メンテナンス モード

アプリがメンテナンス モードの場合、アプリへのすべてのリクエストは同じカスタム ビューを返します。このメカニズムにより、アプリケーションのアップグレードまたはメンテナンス時にサイトを簡単に「シャットダウン」できます。メンテナンスモード判定コードはアプリケーションのデフォルトミドルウェアスタックにあり、アプリケーションがメンテナンスモードの場合はステータスコード503のMaintenanceModeExceptionがスローされます。

メンテナンス モードをオンにするには、Artisan コマンド down を実行するだけです:

phpArtisan Down

メンテナンス モードをオフにするには、対応する Artisan コマンド up:

phpArtisan up

メンテナンス モードの応答template

デフォルトのメンテナンス モードの応答ビュー テンプレートは、resources/views/errors/503.blade.php です

メンテナンス モードとキュー

サイトがメンテナンス モードの場合、アプリケーションの終了時にすべてのキュー タスクは実行されません。メンテナンス モードでのみ、これらのタスクは通常どおり処理され続けます。

メンテナンス モードの代替手段

メンテナンス モードのコマンドの実行には数秒かかるため、代替手段として Envoyer を使用してオフラインで 0 秒を実現することを検討することもできます。

Laravel 5.3 の学習ノートや設定関連の記事をさらに詳しく知りたい場合は、PHP 中国語 Web サイトに注目してください。