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/ […]

Laravelでカスタムバリデーションルールを作る:複雑な入力チェックを再利用可能にする実務設計

  • 2026.02.25

Laravelのバリデーションは標準ルールだけでも強力だが、業務では「DBの状態を加味」「複数項目を横断」「外部APIで検証」「独自フォーマット」など、標準だけでは表現しきれないチェックが出てくる。カスタムルールに切り出すと、コントローラやFormRequestが肥大化せず、テストもしやすくなり、同 […]

1 1,013