導入 (Deployment)

• Introduction
• サーバー要件
• サーバー構成
  • Nginx
• Optimization
  • オートローダーの最適化
  • キャッシュ構成
  • イベントのキャッシュ
  • キャッシュルート
  • ビューのキャッシュ
• デバッグモード
• Forge / Vapor による簡単な導入

導入 (Introduction)

Laravel アプリケーションを本番環境にデプロイする準備ができたら、アプリケーションが可能な限り効率的に実行されるようにするために実行できる重要なことがいくつかあります。このドキュメントでは、Laravel アプリケーションが適切にデプロイされていることを確認するための優れた出発点をいくつか説明します。

サーバー要件 (Server Requirements)

Laravel フレームワークにはいくつかのシステム要件があります。 Web サーバーに次の最小 PHP バージョンと拡張機能が備わっていることを確認する必要があります。

• PHP >= 8.1
• Ctype PHP 拡張機能
• cURL PHP 拡張機能
• DOM PHP 拡張機能
• ファイル情報 PHP 拡張機能
• PHP 拡張機能のフィルター
• ハッシュ PHP 拡張機能
• Mbstring PHP 拡張機能
• OpenSSL PHP 拡張機能
• PCRE PHP 拡張機能
• PDO PHP 拡張機能
• セッション PHP 拡張機能
• トークナイザー PHP 拡張機能
• XML PHP 拡張機能

サーバー構成 (Server Configuration)

Nginx

Nginx を実行しているサーバーにアプリケーションをデプロイする場合は、Web サーバーを構成する開始点として次の構成ファイルを使用できます。ほとんどの場合、このファイルはサーバーの構成に応じてカスタマイズする必要があります。 サーバー管理のサポートが必要な場合は、Laravel Forge などのファーストパーティの Laravel サーバー管理および展開サービスの使用を検討してください。

以下の構成のように、Web サーバーがすべてのリクエストをアプリケーションの public/index.php ファイルに送信していることを確認してください。プロジェクト ルートからアプリケーションを提供すると、多くの機密設定ファイルがパブリック インターネットに公開されるため、index.php ファイルをプロジェクトのルートに移動しないでください。

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;
    }
}

最適化 (Optimization)

オートローダーの最適化

運用環境にデプロイするときは、Composer が特定のクラスにロードする適切なファイルをすぐに見つけられるように、Composer のクラス オートローダー マップを最適化していることを確認してください。

composer install --optimize-autoloader --no-dev

オートローダーの最適化に加えて、プロジェクトのソース管理リポジトリに composer.lock ファイルを必ず含める必要があります。 composer.lock ファイルが存在すると、プロジェクトの依存関係をより速くインストールできます。

キャッシュ構成

アプリケーションを運用環境にデプロイする場合は、デプロイメント プロセス中に config:cache Artisan コマンドを必ず実行する必要があります。

php artisan config:cache

このコマンドは、Laravel のすべての設定ファイルを単一のキャッシュされたファイルに結合します。これにより、設定値をロードするときにフレームワークがファイルシステムにアクセスする必要がある回数が大幅に削減されます。

デプロイメントプロセス中に config:cache コマンドを実行する場合は、構成ファイル内からのみ env 関数を呼び出していることを確認する必要があります。構成がキャッシュされると、.env ファイルはロードされなくなり、.env 変数に対する env 関数の呼び出しはすべて null を返します。

イベントのキャッシュ

アプリケーションが イベントの発見 を利用している場合は、展開プロセス中にアプリケーションのイベントとリスナのマッピングをキャッシュする必要があります。これは、デプロイメント中に event:cache Artisan コマンドを呼び出すことで実現できます。

php artisan event:cache

キャッシュルート

多くのルートを持つ大規模なアプリケーションを構築している場合は、デプロイメント プロセス中に route:cache Artisan コマンドを実行していることを確認する必要があります。

php artisan route:cache

このコマンドにより、すべてのルート登録がキャッシュされたファイル内の 1 つのメソッド呼び出しに減らされ、数百のルートを登録する場合のルート登録のパフォーマンスが向上します。

ビューのキャッシュ

アプリケーションを運用環境にデプロイする場合は、デプロイメント プロセス中に view:cache Artisan コマンドを必ず実行する必要があります。

php artisan view:cache

このコマンドは、すべての Blade ビューをプリコンパイルするので、オンデマンドでコンパイルされなくなり、ビューを返す各リクエストのパフォーマンスが向上します。

デバッグモード (Debug Mode)

config/app.php 設定ファイルのデバッグ オプションにより、エラーに関する情報が実際にユーザーにどの程度表示されるかが決まります。デフォルトでは、このオプションは、アプリケーションの .env ファイルに保存されている APP_DEBUG 環境変数の値を尊重するように設定されています。

運用環境では、この値は常に false である必要があります。本番環境で APP_DEBUG 変数が true に設定されている場合、機密の構成値がアプリケーションのエンド ユーザーに公開される危険があります。

Forge / Vapor による簡単な導入 (Easy Deployment With Forge / Vapor)

Laravel Forge

独自のサーバー構成を管理する準備がまだ整っていない場合、または堅牢な Laravel アプリケーションを実行するために必要なさまざまなサービスをすべて構成することに慣れていない場合は、Laravel Forge が優れた代替手段となります。

Laravel Forge は、DigitalOcean、Linode、AWS などのさまざまなインフラストラクチャプロバイダ上にサーバーを作成できます。さらに、Forge は、Nginx、MySQL、Redis、Memcached、Beanstalk など、堅牢な Laravel アプリケーションの構築に必要なすべてのツールをインストールして管理します。

Laravel Forge を使用してデプロイするための完全なガイドが必要ですか? Laravelブートキャンプ と Forge Laracasts で利用できるビデオ シリーズ をチェックしてください。

Laravel Vapor

Laravel 用に調整された完全にサーバーレスで自動スケーリングのデプロイメント プラットフォームが必要な場合は、Laravel Vapor をチェックしてください。 Laravel Vapor は、AWS を利用した Laravel のサーバーレス デプロイメント プラットフォームです。 Vapor で Laravel インフラストラクチャを起動し、サーバーレスのスケーラブルなシンプルさに夢中になってください。 Laravel Vapor は、フレームワークとシームレスに連携できるように Laravel の作成者によって微調整されているため、これまでとまったく同じように Laravel アプリケーションを書き続けることができます。