Laravel10からLaravel11へのアップグレード

Laravel10のプロジェクトをLaravel11にアップグレードする際の手順について解説します。

本記事では公式マニュアルで【影響の可能性：高い】とあったものを中心に取り上げています。

ただ変更すべき項目は、Webアプリによって異なります。ご了承ください。

Laravel10からLaravel11へのアップグレード
ライブラリ（Laravel Shift）を使ったアップグレード
さいごに

Laravel10からLaravel11へのアップグレード

今回は、Laravel10で作成した下記のWebアプリを、実際にローカル環境でLaravel11に変更してみました。

犬猫サークル

ライブラリのアップデート

Laravel11にするために、ライブラリをアップデートします。

composer.jsonファイル内で該当のライブラリが含まれていたら、下記のようにバージョンを上げておきます。またphpバージョンも8.2以上とします（アップグレードの際には、あらかじめphp8.2以上の環境が必要となります）。

laravel/frameworkを^11.0へ
nunomaduro/collisionを^8.1へ
laravel/breezeを^2.0へ（インストール済みの場合）
laravel/cashierを^15.0へ（インストール済みの場合）
laravel/duskを^8.0へ（インストール済みの場合）
laravel/jetstreamを^5.0へ（インストール済みの場合）
laravel/octaneを^2.3へ（インストール済みの場合）
laravel/passportを^12.0へ（インストール済みの場合）
laravel/sanctumを^4.0へ（インストール済みの場合）
laravel/spark-stripeを^5.0へ（インストール済みの場合）
laravel/telescopeを^5.0へ（インストール済みの場合）
inertiajs/inertia-laravelを^1.0へ（インストール済みの場合）

わたしの場合は、下記のように、phpを含めると5項目を変更しました。

composer.jsonファイルを変更後、下記コマンドを実行してライブラリをアップデートします。

composer update

1	composer update

以上です。

ミドルウェアなどの登録場所はそのままで大丈夫

Laravel11ではミドルウェアの登録場所など変わっております。ですが、Laravel10からアップグレードした場合には、そのままの構造で大丈夫です。

公式マニュアルでも次のように記載があります。

Laravel10アプリケーションをLaravel11にアップグレードするときに、アプリケーション構造の移行を試みることはお勧めしません。Laravel11はLaravel10のアプリケーション構造もサポートするように注意深く調整してあります。

https://readouble.com/laravel/11.x/ja/upgrade.html

ちなみにLaravel10ではミドルウェアはapp/Http/Kernel.phpに登録しましたが、Laravel11では、bootstrap/app.phpに登録します。ですがLaravel10からLaravel11にアップグレード後は、引き続きapp/Http/Kernel.phpにミドルウェアを記述できました。

アップグレード後は、bootstrap/app.phpには、次のようにコードが記載されています。

【アップグレード後のbootstrap/app.php】

$app->singleton(
    Illuminate\Contracts\Http\Kernel::class,
    App\Http\Kernel::class
);

$app->singleton(
    Illuminate\Contracts\Console\Kernel::class,
    App\Console\Kernel::class
);

$app->singleton(
    Illuminate\Contracts\Debug\ExceptionHandler::class,
    App\Exceptions\Handler::class
);

$app->singleton(

Illuminate\Contracts\Http\Kernel::class,

App\Http\Kernel::class

);

$app->singleton(

Illuminate\Contracts\Console\Kernel::class,

App\Console\Kernel::class

);

$app->singleton(

Illuminate\Contracts\Debug\ExceptionHandler::class,

App\Exceptions\Handler::class

);

Laravel11を通常どおりインストールした際のbootstrap/app.phpファイルの書き方は、下記記事で説明しています。上記コードと見比べてみると、違いが分かります。

Laravel11でのミドルウェアの新規登録方法：CSRF除外なども解説

Laravel11では、これまでとミドルウェアの登録方法が色々と変わっています。 Laravel10までは app/Http/Kernel.phpにミドルウェアを登録していましたが、Laravel11では、bootstrap/...

Laravel11では、ミドルウェアやGateの登録場所の変更が必要かと思っていましたが、そういった変更は不要でした。

手間いらずのところは、嬉しいですよね。

Laravel Cashier Stripe、Passport、Sanctum、Spark Stripe、Telescopeを使用している場合

以下のコマンドを実行して、アプリケーションへマイグレーションをリソース公開する必要があります。さらに、これらの各パッケージのアップグレードガイドを確認して、追加の変更点を把握してください。

php artisan vendor:publish --tag=cashier-migrations
php artisan vendor:publish --tag=passport-migrations
php artisan vendor:publish --tag=sanctum-migrations
php artisan vendor:publish --tag=spark-migrations
php artisan vendor:publish --tag=telescope-migrations

php artisan vendor:publish --tag=cashier-migrations

php artisan vendor:publish --tag=passport-migrations

php artisan vendor:publish --tag=sanctum-migrations

php artisan vendor:publish --tag=spark-migrations

php artisan vendor:publish --tag=telescope-migrations

doctrine/dbalを使用している場合

composer.jsonでdoctrine/dbalを確認し、もしあれば、下記コマンドでアンインストールします。

composer remove doctrine/dbal

1	composer remove doctrine/dbal

SQLiteを使用している場合

データベース管理システムでSQLiteを使用している場合は、Laravel11からは、SQLite3.35.0以上が必要となります。

カラムの変更がある場合

カラムに対して属性等の変更がある場合、以前に設定した属性を保持するには、カラム変更時にそれらを呼び出す必要があります。

ちょっと分かりにくいので、例を使って説明しますね。

たとえばavatarカラムに、次のようにdefault()属性を加えていたとします。

このあと、avatarカラムにcomment属性を加えるとします。そのためにマイグレーションファイルを作成しますが、この時、書き方に注意が必要です。

もし以前の設定を含めず下記のようにマイグレーションファイルを作成したとすると、最初に設定したdefault属性が消えてしまいます。

【間違った例】

    public function up(): void
    {
        Schema::table('users', function (Blueprint $table) {
            $table->string('avatar')->comment('test')->change();
        });
    }

public function up(): void

{

Schema::table('users', function (Blueprint $table) {

$table->string('avatar')->comment('test')->change();

});

}

最初に設定したdefault属性を保つには、次のようにdefault属性も含めた形でマイグレーションファイルを記述する必要があります。

【正しい例】

    public function up(): void
    {
        Schema::table('users', function (Blueprint $table) {
            $table->string('avatar')->default('user_default.jpg')->comment('test')->change();
        });
    }

public function up(): void

{

Schema::table('users', function (Blueprint $table) {

$table->string('avatar')->default('user_default.jpg')->comment('test')->change();

});

}

マイグレーションファイルのデータ型でdouble, float, unsignedDecimal, unsignedDouble, unsignedFloatが含まれる場合

書き方が変わっています。マニュアルを参考にしてください。

11.x アップグレードガイド Laravel

エラーになった場合

次のようなエラーになった場合には、該当ライブラリの公式ドキュメントまたは GitHub のリポジトリでLaravel11に対応する現在のバージョンを確認してください。

our requirements could not be resolved to an installable set of packages.
Problem 1
– Conclusion: don’t install laravel/framework v11.0.0 (conflict analysis result)
– Root composer.json requires spatie/laravel-ignition ^1.0 -> satisfiable by spatie/laravel-ignition[1.0.0, …, v1.x-dev].

たとえば上記のエラーは、spatie/laravel-ignition パッケージが Laravel 11 との互換性がないことを示しています。GitHub で確認した結果、次のように composer.json ファイルのバージョン指定を更新しました。

“spatie/laravel-ignition”: “^1.0”

↓↓

“spatie/laravel-ignition”: “^2.0”

このあと、再度composer updateを実行します。なお、下記のようにコマンドを実行すると、spatie/laravel-ignition だけでなく、他の依存パッケージも適切にアップデートしてくれます。依存関係に関する問題を解決するのに役立ちます。