今すぐ始める

Laravelアプリケーション。

Laravelプロジェクトに最初から用意されているもの:APP_KEYと本番環境向けの設定、データベースを追加するまでのSQLite、リリースコマンドとしてのマイグレーション、キューワーカーとスケジューラー。

1 分で読めます

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_ENVproduction
APP_DEBUGfalse
APP_URLアプリケーションのアドレス
LOG_CHANNELstderr(ログタブに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=redis

REDIS_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ディスクでオブジェクトストレージをご利用ください。

解決しませんか?

チャットでご相談ください。AIがすぐに回答し、必要なときはエンジニアが加わります。時間帯は問いません。

サポートに問い合わせる