Laravelアプリケーション。
Laravelプロジェクトに最初から用意されているもの:APP_KEYと本番環境向けの設定、データベースを追加するまでのSQLite、リリースコマンドとしてのマイグレーション、キューワーカーとスケジューラー。
Laravelはcomposer.json内のlaravel/frameworkで判別されます。そのままデプロイでき、サーバーの設定やリポジトリへの追加ファイルは必要ありません。
ビルドと実行の仕組み
- PHP:8.2、8.3、8.4のうち、
composer.jsonのphpの要件を満たす最も低いバージョン(指定がない場合は8.3)。 - Composer:
composer install --no-dev --optimize-autoloader。 - フロントエンドのアセット:
package.jsonにbuildスクリプト(Vite)があれば実行され、public/buildが含まれます。 - 起動時:
storage:linkを実行し、続いて設定、ルート、ビューのキャッシュを作成します。 - HTTPS:アプリケーションはHTTPSリクエストを安全な接続として認識するため、プロキシの信頼設定をご自身で行わなくても、
url()、asset()、リダイレクトでhttps://が使われます。
自動で設定される変数
| 変数 | 値 |
|---|---|
APP_KEY | 初回デプロイ時に一度だけ生成され、変数とともに保存されます |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | アプリケーションのアドレス |
LOG_CHANNEL | stderr(ログタブにLaravelのログが表示されます) |
SESSION_DRIVER, CACHE_STORE | アプリケーションにValkeyがあればredis、なければfile |
いずれも同じ名前の変数を独自に設定すれば置き換えられます(例:SESSION_DRIVER=database)。詳しくは環境変数をご覧ください。
データベース:まずはSQLiteで
データベースのない新しいLaravelアプリケーションは、Laravel標準のSQLiteを使い、アプリケーションのディスク上のstorage/app/database.sqliteにデータを保存します。このファイルはデプロイ後も残り、アプリケーションの毎日のバックアップにも含まれます。まず公開して、データベースは後から決めることができます。
プロジェクトにPostgreSQLまたはMySQLを追加すると(概要 → サービス → サービスを追加)、次回のデプロイでアプリケーションはそちらに切り替わり、マイグレーションもそこで実行されます。SQLiteファイル内のデータは移行されません。必要な場合は事前にエクスポートし、データベースのデータタブでインポートしてください。詳しくはデータベースをご覧ください。
マイグレーション:リリースコマンド
推奨のリリースコマンドはphp artisan migrate --forceです。デプロイのたびに、新しいバージョンが訪問者を受け付ける前に1回実行されます。マイグレーションが失敗した場合は、現在のバージョンが動作を続けます。プロセスタブで変更できます。詳しくはデプロイをご覧ください。
キューワーカーとスケジューラー
初期状態で、プロセスタブでは次のものが動作します。
| 内容 | コマンド |
|---|---|
| バックグラウンドワーカー「queue」 | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| スケジュールコマンド(毎分) | php artisan schedule:run |
これらはアプリケーションのリソースを共有し、デプロイのたびに再起動します。プロセスタブで変更や削除ができます。たとえばValkeyとHorizonを使う場合は、ワーカーをphp artisan horizonに置き換えます。
負荷の大きいキューは、独自のリソースを持つ別のバックグラウンドワーカーサービスとしてワーカーを動かし、プロセスからは削除してください。詳しくはプロジェクトのサービスをご覧ください。
キャッシュ、セッション、キューにValkeyを
プロジェクトにValkeyを追加すると、セッションとキャッシュは自動的にValkeyに移ります(次回のデプロイ時。訪問者は一度ログインし直すことになります)。キューなどその他の項目は、変数タブで設定します。例:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST、REDIS_PASSWORD、REDIS_PORT、REDIS_CLIENT=phpredisは自動で設定されます。
WebSocket(Laravel Reverb)
Reverbは、このプロジェクトのコードからWebサービスとして、コマンドphp artisan reverb:start --host=0.0.0.0 --port=$PORTで実行します。専用のアドレスが割り当てられます。
ファイルとアップロード
storage/app内のファイル(Laravelのlocalディスクとpublicディスク)は、デプロイ後もアプリケーションのディスクに残り、毎日バックアップされます。プロジェクトフォルダー内のそれ以外のファイルは、デプロイのたびにリポジトリから新しく取得されます。ファイルが多い場合や大きい場合は、Laravelのs3ディスクでオブジェクトストレージをご利用ください。