Heroku スターターガイド (Laravel)

この記事の英語版に更新があります。ご覧の翻訳には含まれていない変更点があるかもしれません。

最終更新日 2023年05月04日(木)

前提条件
Laravel アプリケーションの作成
Heroku にデプロイする
ベストプラクティス
参考情報

このガイドでは、Laravel 5 アプリケーションの設定とデプロイについて順に説明します。Heroku で PHP を使用するための一般的な概要については、『Heroku スターターガイド (PHP)』を参照してください。

前提条件

PHP (および理想的には一部の Laravel) に関する知識。
Heroku ユーザーアカウント。無料ですぐにサインアップできます。
PHP、Composer、および Heroku CLI がコンピューターにインストールされ、『Heroku スターターガイド (PHP)』に精通していること。

Laravel アプリケーションの作成

このチュートリアルのアプリケーションは、『Laravel インストール』ガイドに基づいています。この記事の手順に従う前に一読することをお勧めします。

新しい Laravel プロジェクトのインストール

composer create-project コマンドは、laravel/laravel 標準アプリケーションスケルトンに基づいて新しいプロジェクトを立ち上げられる方法の 1 つです。下のコマンドは、最新版のフレームワークを使用して、hello_laravel_heroku という名前のディレクトリ内にこのプロジェクトを設定します。

多数の依存関係をダウンロードし、いくつかのフックを実行した後、Composer は、指定したディレクトリ内で完全に機能的なプロジェクトを設定するので、そのディレクトリへ cd で移動できます。

$ composer create-project laravel/laravel --prefer-dist hello_laravel_heroku
Installing laravel/laravel (v5.1.11)
  - Installing laravel/laravel (v5.1.11)
    Downloading: 100%

Created project in hello_laravel_heroku
...
...

$ cd hello_laravel_heroku

Git リポジトリの初期化

ここで、Get リポジトリを初期化し、現在の状態をコミットします。

$ git init -b main
Initialized empty Git repository in ~/hello_laravel_heroku/.git/
$ git add .
$ git commit -m "new laravel project"
[main (root-commit) 6ae139d] new laravel project
 76 files changed, 5458 insertions(+)
...

ベストプラクティス

本番用ログ記録先の変更

デフォルトで、Laravel はエラーやメッセージのログをディスク上のディレクトリに記録しますが、これは、Heroku が一時的なファイルシステムを使用し、実行中のすべての dyno にわたるイベントのストリームとしてログを扱うので理想的ではありません。

エラーが発生した場合、エラーが heroku logs に表示されていることを確認するには、すべての関連するチャネルで errorlog ドライバーを使用するように config/logging.php での対応する設定を変更する必要があります。たとえば次のようになります。

<?php
return [
    'default' => env('LOG_CHANNEL', 'stack'),
    'channels' => [
        'stack' => [
            'driver' => 'stack',
            'channels' => ['single'],
        ],
        'single' => [
            'driver' => 'errorlog',
            'level' => 'debug',
        ],
…

必ず次の変更内容を追加、コミット、および適切な場合はプッシュしてください。

$ git add config/logging.php
$ git commit -m "use errorlog"
[main 1b70999] use errorlog
 1 file changed, 1 insertion(+), 1 deletion(-)
$ git push heroku main

上記のコードスニペットで確認できるように、最新の標準的な Laravel インストールではすでに、LOG_CHANNEL 環境変数を優先してデフォルトのログ書き込み先を決定しています。 Laravel のデフォルトのログ記録設定でも errorlog がログ記録チャネルであるため、この環境変数を使用して、コードを変更せずにアプリのログ書き込み先を設定できます。

$ heroku config:set LOG_CHANNEL=errorlog

Heroku の HTTP ルーティングは、とりわけロードバランシングと SSL 接続の終了を担っているリバースプロキシのレイヤーを通過するように各リクエストをルーティングします。これは、dyno が受信したリクエストの REMOTE_ADDR 環境変数には最後のルーターの IP アドレスが含まれ、元のリクエストが HTTPS で送信されるようになっていても、内部リクエストは常に HTTP プロトコルを使用するように強制されるということを意味します。

ほとんどの一般的なロードバランサーまたはリバースプロキシと同様に、Heroku は元のリクエスト情報を X-Forwarded-… ヘッダーで提供します (ここ)を参照)。Laravel は、HTTP リクエストの処理に Symfony フレームワークのコンポーネントを使用します。 Symfony は、簡単に、このようなヘッダーを信頼するように設定できます。

Heroku はすべてのリクエストを最初にロードバランサーを通じてアプリケーションに送信し、そのロードバランサーが常にヘッダーを設定するので (クライアントがそれらの値を偽造することを不可能にします)、信頼されるプロキシとして現在のリモートアドレス (これが Heroku ルーター) を扱うように Laravel を設定できます。

Heroku のルーターは Forwarded および X-Forwarded-Host ヘッダーを設定しないので、Laravel がこれらのヘッダーを信頼できないようにすることも非常に重要ですが、Symfony の Request コンポーネントは信頼されるプロキシが設定された後すぐにそれらを信頼します。

プロキシを信頼するための Laravel のドキュメントに従って、最終的な App\Http\Middleware\TrustProxies ミドルウェアは次のようになります。

<?php
namespace App\Http\Middleware;
use Illuminate\Http\Request;
use Fideloper\Proxy\TrustProxies as Middleware;
class TrustProxies extends Middleware
{
    protected $proxies = '*';
    protected $headers = Request:: HEADER_X_FORWARDED_AWS_ELB;
}

このアプローチでは、アプリケーションを他の環境にデプロイした場合、すべてのトラフィックが信頼されるソースを通じて到着することを、同様に確認するか、アプリケーションが実行している環境として Heroku を検出したときに、信頼されるプロキシだけを条件付きで設定する必要があります。

参考情報

「Heroku PHP サポート」Dev Center の記事を読み、使用可能なバージョン、拡張、機能、および動作について学習します。
Apache、Nginx、および PHP の設定の詳細については、PHP の Web サーバーおよびランタイム設定のカスタマイズに関する手順を確認してください。
その他のリソースについては、「Dev Center での PHP カテゴリ」を参照してください。

Categories

Heroku スターターガイド (Laravel)

Table of Contents

前提条件

Laravel アプリケーションの作成

新しい Laravel プロジェクトのインストール

Git リポジトリの初期化

Heroku にデプロイする

Procfile の作成

Heroku での新しいアプリケーションの作成

Laravel 暗号化鍵の設定

Heroku へのプッシュ

ベストプラクティス

本番用ログ記録先の変更

ロードバランサーを信頼する

参考情報

関連カテゴリー