MENU

Laravel 12から13へ上げる前に確認すること|PHP・依存関係・回帰テスト

Laravel 12から13へ上げるときは、PHP、依存パッケージ、アプリ固有の動作を順に確認します。Composerで依存関係を解決できることと、業務の処理が以前どおり動くことは、別の確認です。

Laravel 13の最低PHPは8.3です。開発PCだけでなく、Web、キューワーカー、スケジューラー、CIなど、PHPを動かす場所ごとに条件を照合してください。この記事では12.xから13.xへのメジャー更新を対象とし、11以前からの更新は各版の公式ガイドを追加で確認する前提にします。S1

目次

最初に「今、動いている組み合わせ」を残す

調べ始める前に、現在のリリースを再現できるコード、composer.json、composer.lock、環境設定の管理方法を確認します。依存パッケージの版は、composer.json の許容範囲だけでなく、ロックファイルと実行環境も見ます。

開発用コピーで、たとえば次の情報を確認できます。アプリ固有のComposerプラグインやスクリプトを不用意に動かさないため、例では無効化するオプションを付けています。これらのコマンドの結果にも、非公開パッケージ名などが含まれ得るので、出力をそのまま外へ送らないでください。S3

php -v
composer --version
composer --no-plugins --no-scripts show --locked laravel/framework
composer --no-plugins --no-scripts validate --strict

show --locked はロックファイル側の情報です。配置先が同じ状態とは限らないため、配置先で動く版とも照合します。validate で構成の問題が見つかっても、即座にすべて更新するのではなく、更新作業前からの問題かを記録します。

実行する場所 確認するもの
WebのPHP PHPの版、拡張、設定、実際に配置された依存関係
キューワーカー PHPの起動パス、プロセス管理、再起動方法
スケジューラー 実行ユーザー、PHPのパス、定期処理の入口
テスト・CI PHP、DB、拡張、テスト用設定
ビルド環境 Composer、フロント側のビルド手順と成果物

Webの画面が動いても、古いPHPで起動するワーカーだけが失敗する構成は考えられます。確認を一つのターミナルの php -v で終えないことが大切です。

13への依存更新と、止めているパッケージを確認する

公式アップグレードガイドでは、laravel/framework を ^13.0 にするほか、Tinkerやテスト用パッケージなどの更新条件が示されています。使っているものだけを照合し、例に出てくるパッケージをすべて新規導入する必要はありません。S2

更新を妨げる依存関係を調べるときは、Composerの why-not が使えます。次の 13.0.0 は、13系への制約を調べるための代表例で、採用すべき最新の修正版を指定するものではありません。最終的な目標版でも照合します。S3

composer --no-plugins --no-scripts why-not laravel/framework 13.0.0 --tree

阻害しているものが見つかったら、対応版があるか、置き換えるか、その機能を維持する必要があるかを調べます。制約を書き換えて無理に通す前に、各パッケージの対応状況を確認してください。

特に --ignore-platform-reqs を付けてインストールできたことは、PHPや拡張の条件を満たした証拠になりません。更新後の環境では次も確認できます。check-platform-reqs は、config.platform の指定ではなく実際のPHP・拡張と依存条件を照合します。ただし、アプリの機能テストではありません。S3

composer --no-plugins --no-scripts check-platform-reqs

依存更新そのものは、戻せる開発用ブランチ・コピーで行います。ロックファイルの差分で、想定外のパッケージまで変わっていないか確認し、変更理由を残します。本番サーバーで、まず無条件の一括更新を実行する進め方は避けます。

公式の変更点を「このアプリで使うか」に変換する

ガイドの影響度は、すべてのアプリで同じではありません。自分のアプリが該当する機能を使うかを調べ、確認する操作に落とし込みます。12→13で確認したい例は次のとおりです。S2

変更点の例 調べる対象 確認する動作の例
CSRFに関するリクエスト保護 フォーム、Ajax、APIとの境界、ミドルウェア 正規の操作が通り、不正な要求を拒否する
キャッシュのオブジェクト復元設定 オブジェクトを保存するキャッシュ処理 復元後のデータを使って画面やジョブが動く
キャッシュ等の既定接頭辞 接頭辞を明示していない構成 既存キーやセッションへの影響を把握する
独自の拡張・契約の実装 フレームワークの型や契約に依存するコード 起動時だけでなく、該当機能を呼び出せる

これは公式変更点の全一覧ではなく、調査の入口です。該当しない項目を機械的に修正せず、実装と設定を見て判断します。特に認証や保護機構は、「エラーが消えた」だけで正しいとせず、拒否するべき要求も試してください。

設定の既定値が変わっていても、アプリ側の明示設定によって影響しない場合があります。新規プロジェクトの設定を既存アプリへ丸ごと移すと、別の差分まで持ち込むため、必要な変更を個別に確認します。

更新前の振る舞いを、回帰テストとして残す

更新前に、重要な処理について期待結果を記録します。テストがない場合も、すべてを作り直すのではなく、失敗すると困る処理から最小限の確認を用意します。更新による不具合と、もともとの仕様を分けるためです。

Laravelの公式資料では、テスト用の環境設定や php artisan test などの実行方法が説明されています。実行前には、テスト用DB、メール、ストレージ、外部APIが本番につながらないことを確認してください。テストコードによってはデータが削除・変更されます。S4

検証の組み合わせは、次のように決められます。

  • ログイン、認可:ログイン済み・未ログイン・権限不足で期待する結果になる。
  • 入力検証:正常値、空値、境界値で保存するか拒否するかが変わらない。
  • 一覧と検索:並び順、絞り込み、ページ移動で必要なデータが返る。
  • DB更新:正常終了、失敗時のロールバックで整合性を保つ。
  • キュー:テスト環境で投入・処理・失敗時の扱いを確認する。
  • 帳票や通知:内容、文字コード、宛先をテスト用の出力で確認する。

同じテストを更新前後で比較し、失敗件数だけでなく内容を見ます。成功させるために期待値を一括で変えると、守るべき仕様の変更を見逃す可能性があります。画面の見た目や外部サービスの動作など、自動テストで確認できていない部分も別に残してください。

配置する手順と戻す手順まで用意する

検証が済んだら、決めたロックファイルに従って配置する手順、キャッシュの扱い、ワーカーの再起動、切り替え後の確認を並べます。長く動き続けるプロセスに、古いコードが残らないようにする必要があります。

DB変更を含める場合は、コードだけを元へ戻せばよいのかを別に考えます。変更後に書き込まれたデータやキューに残ったジョブを、旧コードで処理できるかも判断してください。検証環境で戻す操作を確かめ、復旧できない変更を無計画に同時投入しないようにします。

AIを調査に使うなら、変更点と参照した公式資料、修正候補、未確認の影響を分けて説明してもらいます。検証を通らないまま生成コードを採用せず、AIを使った既存コード改修の進め方と同じく、差分と実行結果で判断します。

テストやComposerの読み方が更新の障害になっている場合は、PHP経験者の学び直し方法から必要な分野を選べます。更新と同時に新機能の学習まで広げず、今回は何を維持するかを先に決めると、確認範囲を抑えられます。

公式資料の確認日:2026年11月17日。対象はLaravel 12.x→13.x、Composer 2系、PHP 8.3以上を前提とする更新計画です。コマンドは公式仕様と照合した例であり、特定アプリの更新・テスト・復旧を実行した記録ではありません。MacとWindowsでも、実際にコマンドを動かすPHP環境を確認します。

出典

  1. https://laravel.com/docs/13.x/releases Laravel「Release Notes」(確認日: 2026-11-17) ↩1
  2. https://laravel.com/docs/13.x/upgrade Laravel「Upgrade Guide」(確認日: 2026-11-17) ↩1 ↩2
  3. https://getcomposer.org/doc/03-cli.md Composer「Command-line interface / Commands」(確認日: 2026-11-17) ↩1 ↩2 ↩3
  4. https://laravel.com/docs/13.x/testing Laravel「Testing: Getting Started」(確認日: 2026-11-17) ↩1
よかったらシェアしてね!
  • URLをコピーしました!
目次