LaravelでAPP_KEYが設定されていない場合の対処方法
- 2026.03.12
Laravelで「APP_KEYが設定されていない」状態になると、アプリケーションの暗号化機能が正常に動かず、起動時や特定処理で例外が発生する。Laravelの暗号化キーは config/app.php の key 設定に対応しており、その値は通常 APP_KEY 環境変数から読み込まれる。Lara […]
LaravelのPolymorphicリレーションシップを活用する方法
- 2026.03.11
Polymorphicリレーションシップは、1つの関連テーブルを複数のモデルで共有したいときに使う仕組み。代表例は「投稿にも商品にもコメントを付けたい」「ユーザーにも記事にも画像を紐付けたい」「複数モデルに対していいねを付けたい」といったケースになる。通常の外部キー設計では、モデルごとに別テーブルや […]
Laravelで.envを使った環境設定を管理する方法：安全・再現性・運用性を高める基本設計
- 2026.03.10
Laravelの .env は、アプリケーションの挙動を環境ごとに切り替えるための中心的な仕組み。開発環境・検証環境・本番環境で同じコードを使いながら、DB接続先、メール設定、キャッシュ、キュー、外部APIキーなどを切り替えられる。一方で、.env の使い方を誤ると「本番だけ動かない」「設定変更が反 […]
Laravel Telescopeで開発中のデバッグとモニタリングを効率化する方法
- 2026.03.09
Laravel Telescopeは、リクエスト、例外、ログ、DBクエリ、ジョブ、メール、通知、キャッシュ操作、スケジュール実行などを一元的に確認できる開発支援ツール。dd() やログ出力だけでは追い切れない「どのリクエストで」「どのSQLが」「どのジョブが」「どの例外で」問題になったのかを、時系列 […]
Laravel Horizonでジョブキュー監視・運用を強化する：導入から本番運用・障害対応まで
- 2026.03.06
Laravel Horizonは、Redisベースのキューを「見える化」し、ワーカーのプロセス管理・スループット監視・失敗ジョブの追跡を一つにまとめる運用基盤。キュー処理が増えるほど、ログだけでは追いづらい「滞留」「再試行の嵐」「特定キューだけ遅い」「ワーカーが落ちている」などが発生しやすい。Hor […]
Laravel『TokenMismatchException』の原因と対処法
- 2026.03.05
TokenMismatchException は、LaravelのCSRF保護（VerifyCsrfTokenミドルウェア）で「送信されたCSRFトークン」と「セッションに保存されているトークン」が一致しないときに発生する。フォーム送信で @csrf を入れ忘れた、AJAXで X-CSRF-TOKE […]
Laravelで複数データベース接続を運用する：接続定義・読み書き分離・テナント分割まで
- 2026.03.04
Laravelは標準で複数DB接続を扱える。単に「接続を増やす」だけでなく、用途（参照専用DB、分析DB、外部システムDB、テナント別DB）ごとに責務を分離し、マイグレーション・トランザクション・キュー・テスト・監視まで含めた運用設計に落とし込むと事故が減る。ここでは config/database […]
Laravelのサービスコンテナを理解して設計を強くする：依存解決・バインド・スコープ運用まで
- 2026.03.02
Laravelのサービスコンテナは「クラス同士の依存関係を組み立てる仕組み」。ControllerやJob、Commandなどが必要とする依存（サービス/リポジトリ/クライアント）を、コンテナが自動で解決して注入する。これにより new の乱立や密結合を減らし、テスト容易性・置換可能性・環境差分（本 […]
Laravel×Dockerで開発環境を最短で安定させる：ローカル統一・再現性・速度を両立する構成
- 2026.02.27
Laravel開発をDocker化すると、PHP/Node/DB/Redisなどの依存関係をチームで統一でき、OS差異や「動く人と動かない人」を減らせる。重要なのは、ただコンテナを立てることではなく、コード編集・依存インストール・DBマイグレーション・キュー/スケジューラ・テスト・本番相当設定までを […]
LaravelでOAuth2認証を導入・管理する：Passportでトークン発行から運用まで固める手順
- 2026.02.26
OAuth2は「クライアント（アプリ）に対して、アクセストークンを発行し、APIアクセスを制御する」ための標準仕様。LaravelでOAuth2を扱う場合は、OAuth2サーバ実装を提供するLaravel Passportを使う構成が定番になる。導入時は“動く”だけでなく、クライアント種別（SPA/ […]