Deployment

Introduction

あなたが Laravel application を production にデプロイする準備ができたとき、 application ができる限り効率的に動作するようにするためにできる重要なことがいくつかあります。このドキュメントでは、 Laravel application が適切にデプロイされることを確認するための素晴らしいスタートポイントをいくつか紹介します。

Server Requirements

Laravel フレームワークにはいくつかの system requirements があります。あなたの web サーバーが以下の最低の PHP バージョンと extensions を持っていることを確認する必要があります:

Server Configuration

Nginx

あなたが Nginx を実行するサーバーに application をデプロイする場合、次の設定ファイルを web サーバーの設定の出発点として使用することができます。おそらく、このファイルはサーバーの設定に応じてカスタマイズする必要があるでしょう。 サーバーの管理において支援が必要な場合、Laravel Forge のような第一級の Laravel サーバー管理および deployment service の使用を検討してみてください。

以下のような設定になっていることを確認してください。あなたの web サーバは、すべてのリクエストをあなたのアプリケーションのpublic/index.phpファイルに向けるようにしてください。あなたは、index.phpファイルをあなたのプロジェクトの root に移動することを attempt べきではありません。なぜなら、 application を project root から提供すると、多くの機密設定ファイルが public インターネットに晒されるからです。

server {
    listen 80;
    listen [::]:80;
    server_name example.com;
    root /srv/example.com/public;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";

    index index.php;

    charset utf-8;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    error_page 404 /index.php;

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

FrankenPHP

FrankenPHP は、あなたの Laravel アプリケーションの提供にも使用できます。FrankenPHP は Go で記述された現代的な PHP の application server です。FrankenPHP を用いて Laravel PHP の application を提供するためには、そのphp-server command を単純に呼び出すだけです。

frankenphp php-server -r public/

FrankenPHP がサポートする、より強力な features 、例えばLaravel Octaneの統合や、HTTP/3、現代的な圧縮、または Laravel アプリケーションをスタンドアローンのバイナリとしてパッケージ化する能力を最大限に活用するには、FrankenPHP のLaravel documentation を参照してください。

Optimization

あなたの application を production にデプロイする際、cache すべきさまざまなファイルがあります。それには、設定、events、routes、および views が含まれます。 Laravel はこれらすべてのファイルを cache するための便利な optimize Artisan command を提供しています。この command は通常、あなたの application の deployment process の一部として呼び出されるべきです。

php artisan optimize

optimize:clearの method を使用すると、optimizeの command で生成されたすべての cache ファイルを削除できます。

php artisan optimize:clear

次の文書では、optimize command によって実行される粒状最適化コマンドのそれぞれについて説明します。

キャッシュ設定

あなたの application を production にデプロイする際は、config:cache Artisan command を deployment process 中に実行することを確認してください。

php artisan config:cache

この command は、Laravel のすべての設定ファイルを single 、キャッシュされたファイルにまとめ、フレームワークが設定 values をロードする際のファイルシステムへのアクセス回数を大幅に削減します。

WARNING

あなたがconfig:cacheの command を deployment process の間に実行する場合、設定ファイルからだけenv関数を呼び出していることを確認してください。設定が cache された後、.env ファイルはロードされず、.envvariables のenv関数へのすべての呼び出しはnullを返します。

キャッシュ Events

あなたは、デプロイメント process の間に、application の自動検出された event から listener マッピングまでを cache する必要があります。これは、デプロイメント中にevent:cache Artisan command を呼び出すことで達成できます。

php artisan event:cache

キャッシング Routes

あなたが多くの routes を持つ大規模な application を構築している場合、route:cacheの Artisan command があなたの deployment process 中に実行されていることを確認するべきです:

php artisan route:cache

この command は、すべての route 登録をキャッシュされたファイル内の single method 呼び出しに減らすことで、数百の routes を登録する際の route 登録のパフォーマンスを向上させます。

Views のキャッシング

あなたの application を production にデプロイする際には、view:cacheの Artisan command を deployment process の間に実行することを確認してください。

php artisan view:cache

この command はすべての Blade views を事前にコンパイルするため、要求時にコンパイルされることはありません。これにより、 view を返す各 request のパフォーマンスが向上します。

Debug Mode

config/app.php設定ファイルの debug option は、 error に関する情報のうち、実際に user に表示される情報の量を決定します。 default では、この option はAPP_DEBUG environment variables の value を尊重するように設定されており、これはあなたの application の.envファイルに保存されています。

WARNING

ご自身の production environment において、この value は常にfalseであるべきです。 APP_DEBUG変数が production でtrueに設定されていると、あなたのアプリケーションの最終 users に対して敏感な設定の values を晒すリスクがあります。

The Health Route

Laravel は、ビルトインのヘルスチェックの route を持っており、これを使って application の status を監視することができます。 production では、この route は、アップタイムモニター、ロードバランサー、または Kubernetes のようなオーケストレーションシステムに対して、 application の status を報告するために使用することができます。

default では、ヘルスチェックの route は /up で提供され、 exceptions が例外なしに起動した場合は 200 の HTTP response を返します。それ以外の場合は、500 の HTTP response が返されます。この route の URI は、bootstrap/app ファイル内の application で設定することができます。

->withRouting(
    web: __DIR__.'/../routes/web.php',
    commands: __DIR__.'/../routes/console.php',
    health: '/up', // [tl! remove]
    health: '/status', // [tl! add]
)

HTTP requests がこの route に対して行われると、 Laravel はIlluminate\Foundation\Events\DiagnosingHealth event も dispatch します。これにより、あなたの application に関連する追加の健康チェックを行うことができます。この event のlistener内で、アプリケーションの database や cache status をチェックすることができます。 application に問題を検出した場合は、リスナーから単純に throw することで例外を投げることができます。

Easy Deployment With Forge / Vapor

Laravel Forge

まだ自分自身でサーバー設定を管理する準備が整っていなかったり、堅牢な Laravel application を運用するために必要な様々な services の設定に慣れていない場合、Laravel Forge は素晴らしい代替手段です。

Laravel Forge は、DigitalOcean、Linode、AWS などのさまざまなインフラストラクチャ providers で servers を作成することができます。さらに、Forge は Nginx、 MySQL 、 Redis 、 Memcached 、Beanstalk など、堅牢な Laravel application を build するために必要なすべてのツールをインストールおよび管理します。

NOTE

Laravel Forge を使用したデプロイの完全なガイドが欲しいですか？ Laravel Bootcamp と、Laracasts で利用可能な Forge のビデオシリーズ をご覧ください。

Laravel Vapor

もし完全に servers レスで、自動スケーリングされた deployment プラットフォームを希望し、それが Laravel に最適化されている場合は、Laravel Vapor をご覧ください。 Laravel Vapor は、AWS によって支えられている Laravel のための servers レスな deployment プラットフォームです。Vapor 上で Laravel のインフラを立ち上げ、servers レスのスケーラブルなシンプルさに惹かれてみてください。Laravel Vapor は、あなたが慣れている通りに Laravelapplications を書き続けることができるよう、Laravel のクリエイターによってフレームワークとシームレスに連携するように微調整されています。