Laravel Horizonでジョブキュー監視・運用を強化する:導入から本番運用・障害対応まで
- 2026.03.06
Laravel Horizonは、Redisベースのキューを「見える化」し、ワーカーのプロセス管理・スループット監視・失敗ジョブの追跡を一つにまとめる運用基盤。キュー処理が増えるほど、ログだけでは追いづらい「滞留」「再試行の嵐」「特定キューだけ遅い」「ワーカーが落ちている」などが発生しやすい。Hor […]
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 […]
概要:Polymorphic(ポリモーフィック)リレーションは、複数の異なるモデルが「同じ関連(コメント・画像・いいね等)」を共有できる仕組みです。テーブル設計をシンプルに保ちながら、関連データの追加・拡張に強い構成を作れます。一方で、参照整合性・パフォーマンス・削除時の扱いなど落とし穴もあるため、 […]
Laravelをバックエンド(API)として、Vue.jsをフロント(SPA)として構築すると、画面遷移の高速化・UIのリッチ化・フロント/バックの責務分離が進めやすい。一方で、ルーティングの衝突、認証(Cookie/トークン)、CORS/CSRF、ビルド成果物の配信、404の扱いを雑にすると、開発 […]