Laravel Mixを使ったフロントエンドビルドプロセス最適化:遅い・重い・壊れるを減らす実務設定
- 2026.02.04
Laravel Mixは「webpackの難しさを隠して、Laravel向けのビルドを素早く組める」構成になっている。一方で、プロジェクトが大きくなるとビルド時間の増加、CSS/JSの肥大、キャッシュが効かない、環境差でエラーが出るなどの問題が目立つ。最適化は、(1) 開発時は速く回す、(2) 本番 […]
Laravel Mixは「webpackの難しさを隠して、Laravel向けのビルドを素早く組める」構成になっている。一方で、プロジェクトが大きくなるとビルド時間の増加、CSS/JSの肥大、キャッシュが効かない、環境差でエラーが出るなどの問題が目立つ。最適化は、(1) 開発時は速く回す、(2) 本番 […]
Eloquentのクエリビルディングは「書きやすい」のが強みだが、何も考えずに書くとN+1、不要なカラム取得、肥大したJOIN、無駄なOR条件、巨大IN、ページングの遅延などが起きやすい。効率化の軸はシンプルで、(1) 取得する行と列を最小化、(2) 関連は eager load と制約で制御、(3 […]
Laravelにおける認証実装は、要件を整理してから方式を選ばないと構成が破綻しやすい。SanctumはSPAや自社クライアント向けの軽量な認証を得意とし、PassportはOAuth2準拠の本格的な認可サーバを必要とするケースに向いている。どちらを採用するかは「誰が」「どこから」「どの粒度の権限で […]
Laravelの「Pivot Table Issues」は、belongsToMany の中間テーブル(pivot)が絡む操作で、想定した関連が取得できない/attach・detach・sync が失敗する/pivotカラムが取れない/重複が増える/外部キー制約で落ちる、といった問題の総称として扱わ […]
Laravel 11の新規インストール(Slim Skeleton)では、これまで「app配下にあった設定ファイル一式」が生成されなくなり、設定の多くが bootstrap/app.php に集約された。結果として「Kernel.phpが消えた」「例外ハンドラが見当たらない」「ミドルウェアはどこで登 […]
Laravelの「Queue Timeout」は、キューワーカーがジョブ実行中にタイムアウト上限へ到達し、ワーカー側またはプロセスマネージャ(Supervisor/systemd)側によりジョブが強制終了される状態を指す。典型的には「TimeoutExceededException」「ジョブが途中で […]
Laravelの「Invalid Blade Directive」は、Bladeテンプレート内で使ったディレクティブ(@xxxx)が未定義、スペルミス、または引数/構文がBladeの期待と合っていないときに発生する。代表例は「@auth/@guest/@can などの書き間違い」「独自ディレクティブ […]
Laravelの「Mailable Class Error」は、メール送信時にMailableクラス(App\Mail…)の読み込み・生成・ビルド・ビュー描画・添付処理・キュー実行のどこかで例外が起きて送信できない状態を指すことが多い。特に多いのは「クラスが見つからない(Class no […]
Laravelの「Storage Link Missing」は、storage/app/public に保存したファイルをブラウザから配信するためのシンボリックリンク(public/storage)が存在しない、壊れている、またはWebサーバ設定によりリンク先へ到達できないときに起きる。典型的には「 […]
Laravelの「Error Logging Issues」は、例外やLog::error()を出しているのにログが増えない、ログファイルが作られない、ログが途中で止まる、スタックトレースが出ない、といった“ログ記録の不具合”全般を指すことが多い。原因は大きく「設定(LOG_CHANNEL/stac […]