Contents
Laravel 10から11への移行の重要性と目的
Laravel 10から11への移行は、システムの安定性向上と最新技術の活用に直結します。特に、PHP8.1以降の互換性強化やセキュリティパッチの適用が求められる背景には、開発環境のグローバルな標準化があります。Laravel 11では新機能が導入され、より高品質なコードの実装が可能になります。
事前準備: 依存関係確認とバックアップ作成
移行前の環境チェックは、失敗時のロールバックを可能にするための最重要ステップです。特に、composer showによる依存関係の確認やデータベース・ファイルのバックアップが不可欠です。
composer showによる依存関係チェック
Laravel 10プロジェクトの依存関係を確認するには、以下のコマンドを実行します。
|
1 2 |
composer show |
この出力結果から、laravel/frameworkのバージョンや他のパッケージがLaravel11でサポートされているかを確認してください。
具体的な注意点
- Composer の安定性設定：
"minimum-stability": "stable"が.envに設定されている場合、Laravel11への更新は失敗する可能性があります。事前に変更を検討しましょう。 - PHPバージョン：Laravel11ではPHP8.1以上が必須です。現在の環境でPHP8.0を使用している場合は、アップグレードが必要です。
データベース・ファイルの完全バックアップ手順
移行前のデータ損失リスクを最小限に抑えるためには、以下のようにバックアップを作成しましょう。
-
データベースダンプ
php artisan db:dump
またはMySQL CLIを使用してダンプを取得してください。 -
ファイルシステムのコピー
storageやpublicディレクトリ内にある画像・アップロードファイルを別サーバーに保存します。
バックアップは移行前の「必須ステップ」です。失敗した場合でも、迅速な復旧が可能になります。
composer.jsonのバージョン更新手順
Laravel11への移行では、composer.jsonの編集が基本的手順です。以下の手順に従ってください。
Laravel 10→11のバージョン指定方法
laravel/frameworkのバージョンを^11.0に変更し、コマンドで更新します。
|
1 2 |
composer require laravel/framework:^11.0 |
この操作により、Laravelのカーネルクラスや一部のコンポーネントが自動的に置き換えられます。ただし、依存パッケージと衝突する場合があります。
依存パッケージの互換性確認
composer.jsonで指定されているlaravel/sanctumやlaravel/uiなどは、Laravel11対応のバージョンに更新が必要です。以下のコマンドで一括検出が可能です。
|
1 2 |
composer outdated |
| パッケージ名 | 推奨バージョン | 補足 |
|---|---|---|
| laravel/framework | ^11.0 | 基本パッケージ |
| laravel/sanctum | ^3.2 | Laravel11対応 |
| laravel/ui | ^4.2 | デフォルトビューの更新が必要 |
データベースマイグレーションと Seeder の対応
Laravel11への移行では、データベースの互換性テストが不可欠です。特にトランザクション制御やSeederクラスのPHP8型ヒンティングに注意が必要です。
マイグレーションファイルの互換性テスト
マイグレーションファイルを実行する前に、以下のように環境をリセットします。
|
1 2 |
php artisan migrate:refresh --seed |
このコマンドで、既存データベースを初期化し、Laravel11に対応したマイグレーションが正常に動作するか確認してください。
SeederクラスのPHP8対応処理
PHP8では型ヒンティングの厳格化が行われています。Seederクラスのrun()メソッドで、以下のような変更が必要です。
|
1 2 3 4 5 6 7 8 9 10 |
use Illuminate\Database\Seeder; use App\Models\User; class UserSeeder extends Seeder { public function run(): void { User::create(['name' => 'Admin', 'email' => '[メールアドレス削除]']); } } |
変更点：run()メソッドにvoid戻り値の指定を追加しました。
Laravel 11特有の設定変更点
Laravel11では、一部の設定ファイルが刷新されています。主に、config/app.phpや.envファイルの項目に注意が必要です。
app.phpでの新パラメータ設定
config/app.phpで以下の変更が必須です。
log_level：以前は'debug'のみだったが、Laravel11ではinfo,notice,warning,errorなど複数のレベルを指定可能に。default_cache_driver：デフォルト値がfileからdatabaseに変更されている場合があります。
.envファイルの更新項目
.envで以下のように設定を変更してください。
| 設定項目 | 値例 | 補足 |
|---|---|---|
APP_DEBUG |
false | プロダクション環境ではfalseに設定 |
LOG_CHANNEL |
stack | Laravel11のデフォルト値 |
移行後のテストケース作成とトラブルシューティング
移行完了後は、ユニットテストやエラーデバッグが重要です。特にPHPUnitでのカバレッジ確認や、新機能との互換性テストを行います。
ユニットテストのカバレッジ確認
Laravel10から11への移行では、テストコードの不整合が発生する可能性があります。以下のコマンドで実行してください。
|
1 2 |
phpunit --testsuite unit |
テスト失敗時の対処法
- パッケージバージョンの確認：
composer show laravel/frameworkでLaravel11が正しく適用されているかをチェック。 - 型ヒンティングの修正：PHP8との互換性を確保するために、コントローラーやモデルに
?や|で戻り値を明示。
エラー発生時のデバッグ手順
移行後のエラー発見時には以下のように対応します。
- ログ確認：
storage/logs/laravel.logを開き、エラーの詳細を把握。 - composer update：依存関係が解決されていない場合、再実行。
- Laravel Octaneとの互換性テスト：もしOctaneを使用している場合は、
php artisan octane:serveで動作確認。
- Laravel10→11への移行は、以下の手順を順守することでリスクを最小限に抑えられます。
- 事前準備（依存関係の確認とバックアップ）
- composer.jsonでのバージョン更新
- データベースマイグレーションと Seeder クラスの対応
- 設定ファイルの変更点を精査
- 移行後のテスト実施
本記事の手順に従ってLaravel10から11への移行を実施し、システムの安定性向上を目指してください。具体的な質問はコメント欄で受け付けています。