laravelの基本チュートリアル -- 設定

Laravel 基本チュートリアル - 設定

すべての設定ファイルは config ディレクトリに保存され、各設定ファイル内の設定項目は文書化されます。

設定値へのアクセス

config グローバル ヘルパー メソッドは、vendor/laravel/framework/src/Illuminate/Foundation/helpers.php ファイルで提供されており、この関数を使用して設定項目の値を取得できます。ファイル内。

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

config 関数のデフォルト値として 2 番目のパラメータを渡し、構成アイテムが見つからない場合にデフォルト値を返すこともできます。

$value = config('app.timezone', 'Asia/Shanghai');

構成アイテムの値を設定します。

config(['app.timezone' => 'Asia/Shanghai']);

環境構成

開発環境と本番環境で異なる構成を使用したい場合がよくあります。たとえば、ローカル開発環境で異なるキャッシュドライバーを使用する場合、Laravel の環境ベースの構成により、これが非常に簡単になります。

Laravel は、環境ベースの構成を構築するために DotEnv クラス ライブラリを使用します。デフォルトの環境ベースの構成情報は、コンポーザーを介して laravel をインストールすると、env.example ファイルが自動的にコピーされます。名前を .env に変更します。これが当てはまらない場合は、手動で行う必要があります。環境ベースの構成項目を毎回追加する場合は、同じ構成項目を .env.example に追加して、複数人での共同作業で他の人が .env.example に基づいて構成情報を理解できるようにすることをお勧めします。プログラムがリクエストを受信すると、アプリケーションは自動的に .env ファイルをロードし、構成情報をグローバル変数 $_ENV にカプセル化します。 もちろん、グローバル補助関数 env() を通じて環境構成項目情報を取得することもできます。実際、他の設定ファイルでは、laravel はいくつかの設定ファイルでこのように設定されています。

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

env関数の第二パラメータは、環境設定ファイル.envに設定項目が存在しない場合は、自動的にデフォルト値が使用されます。

さらに、他のサーバー環境や開発者環境では異なる環境構成を導入する必要がある可能性があるため、.env 構成環境をバージョン コントローラーに送信しないでください。たとえば、運用環境ではデバッグを有効にするべきではなく、開発者ごとにローカル データベース構成情報が異なる可能性があります。

チームで開発している場合は、.env.example ファイルに追加した環境構成情報を紹介し、他の開発者に送信して、開発した構成情報の部分を使用するために何を導入する必要があるかを理解できるようにする必要があります。

現在の環境を決定する

現在の環境は、.env ファイルの APP_ENV 変数で定義されています。アプリ

facade

の環境関数を通じて取得できます。

$environment = App::environment();

もちろん、グローバルメソッド env または app :

$environment = env('APP_ENV');# or$environment = app()->environment();

現在の環境がどのような環境であるかを具体的に識別し、異なる環境に応じて異なるビジネスロジックを実行する必要がある場合、このとき、環境関数を使用して一致を判断する必要があります。もちろん、1 つまたは複数の環境パラメータを渡すことができ、それらのいずれか 1 つが一致する限り、true が返されます:

if (App::environment('local')) {  // if env('APP_ENV') === 'local'}if (App::environment('local', 'staging')) {  // env('APP_ENV') === 'local' || env('APP_ENV') === 'staging'}

設定情報をキャッシュします

config ディレクトリには多数の設定ファイルがあり、異なる設定がありますプログラムをより速く起動するために、この構成情報を開発環境の構成ファイルに集中させて、プログラムがアクセスされるたびに N ファイルをロードすることがなくなります。職人の config:cache コマンドを使用します。すべての設定ファイルは 1 つのファイルに結合され、プログラムによって自動的にロードされます。

もちろん、これは開発環境では推奨されません。開発環境では設定情報を頻繁に変更する可能性があるため、設定情報をタイムリーに有効にするために、phpArtisan config を頻繁に実行する必要があります。 :cache コマンドを実行するのを忘れることがあります。本番環境ではキャッシュ設定ファイルを標準とし、バージョンリリース時にキャッシュ設定ファイルコマンドを実行してキャッシュ設定情報を再生成する必要があります。これは自動公開の一環として行う必要があります。

メンテナンスモード

Laravel はメンテナンスモードを提供します。メンテナンスモードがオンになると、すべてのアクセスリクエストはカスタマイズ可能な特定のビューに返されます。メンテナンス モードがオンの場合、すべてのリクエストは 503 ステータス コードを返します。メンテナンス モードをオンにする方法:

php artisan down

メンテナンス モードをオフにする方法:

php artisan up

メンテナンス モードの応答テンプレート

メンテナンス モードの応答ビュー テンプレートは、resources/views/errors/503.blade.php に保存されており、変更できます。それは自由です。

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

メンテナンス モードがオンになると、キューの作業は一時停止されます。メンテナンス モードがオフになると、キューは作業を継続します。

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

メンテナンス モードをオンにするには、アプリケーションを一定期間シャットダウンする必要があるため、アプリケーションをシャットダウンする必要のない Envoyer のような継続的統合サービスを検討することをお勧めします。