Laravelで.envを使った環境設定を管理する方法:安全・再現性・運用性を高める基本設計
- 2026.03.10
Laravelの .env は、アプリケーションの挙動を環境ごとに切り替えるための中心的な仕組み。開発環境・検証環境・本番環境で同じコードを使いながら、DB接続先、メール設定、キャッシュ、キュー、外部APIキーなどを切り替えられる。一方で、.env の使い方を誤ると「本番だけ動かない」「設定変更が反 […]
Laravelの .env は、アプリケーションの挙動を環境ごとに切り替えるための中心的な仕組み。開発環境・検証環境・本番環境で同じコードを使いながら、DB接続先、メール設定、キャッシュ、キュー、外部APIキーなどを切り替えられる。一方で、.env の使い方を誤ると「本番だけ動かない」「設定変更が反 […]
Laravel Telescopeは、リクエスト、例外、ログ、DBクエリ、ジョブ、メール、通知、キャッシュ操作、スケジュール実行などを一元的に確認できる開発支援ツール。dd() やログ出力だけでは追い切れない「どのリクエストで」「どのSQLが」「どのジョブが」「どの例外で」問題になったのかを、時系列 […]
Laravel Horizonは、Redisベースのキューを「見える化」し、ワーカーのプロセス管理・スループット監視・失敗ジョブの追跡を一つにまとめる運用基盤。キュー処理が増えるほど、ログだけでは追いづらい「滞留」「再試行の嵐」「特定キューだけ遅い」「ワーカーが落ちている」などが発生しやすい。Hor […]
TokenMismatchException は、LaravelのCSRF保護(VerifyCsrfTokenミドルウェア)で「送信されたCSRFトークン」と「セッションに保存されているトークン」が一致しないときに発生する。フォーム送信で @csrf を入れ忘れた、AJAXで X-CSRF-TOKE […]
Laravelは標準で複数DB接続を扱える。単に「接続を増やす」だけでなく、用途(参照専用DB、分析DB、外部システムDB、テナント別DB)ごとに責務を分離し、マイグレーション・トランザクション・キュー・テスト・監視まで含めた運用設計に落とし込むと事故が減る。ここでは config/database […]
Laravelのサービスコンテナは「クラス同士の依存関係を組み立てる仕組み」。ControllerやJob、Commandなどが必要とする依存(サービス/リポジトリ/クライアント)を、コンテナが自動で解決して注入する。これにより new の乱立や密結合を減らし、テスト容易性・置換可能性・環境差分(本 […]
Laravel開発をDocker化すると、PHP/Node/DB/Redisなどの依存関係をチームで統一でき、OS差異や「動く人と動かない人」を減らせる。重要なのは、ただコンテナを立てることではなく、コード編集・依存インストール・DBマイグレーション・キュー/スケジューラ・テスト・本番相当設定までを […]
OAuth2は「クライアント(アプリ)に対して、アクセストークンを発行し、APIアクセスを制御する」ための標準仕様。LaravelでOAuth2を扱う場合は、OAuth2サーバ実装を提供するLaravel Passportを使う構成が定番になる。導入時は“動く”だけでなく、クライアント種別(SPA/ […]
Laravelのバリデーションは標準ルールだけでも強力だが、業務では「DBの状態を加味」「複数項目を横断」「外部APIで検証」「独自フォーマット」など、標準だけでは表現しきれないチェックが出てくる。カスタムルールに切り出すと、コントローラやFormRequestが肥大化せず、テストもしやすくなり、同 […]
概要:WebSocketで「ページを再読み込みせずに更新される体験」をLaravelで組み立てる手順を、イベント設計・認可・購読・キュー運用・本番デプロイまで含めてまとめます。Reverb(Laravel公式系のWebSocketサーバ)を軸に、Broadcastingとフロント購読(Laravel […]