アップグレードガイド¶
高影響の変更¶
中影響の変更¶
低影響の変更¶
10.x から 11.0 へのアップグレード¶
推定アップグレード時間: 15 分¶
Note
可能な限りすべての破壊的変更を文書化しようとしています。これらの破壊的変更の一部は、フレームワークのあまり知られていない部分にあるため、これらの変更の一部が実際にアプリケーションに影響を与える可能性があります。時間を節約したいですか？ Laravel Shift を使用して、アプリケーションのアップグレードを自動化することができます。
依存関係の更新¶
影響の可能性: 高
PHP 8.2.0 が必要¶
Laravel は現在、PHP 8.2.0 以上を必要とします。
curl 7.34.0 が必要¶
Laravel の HTTP クライアントは現在、curl 7.34.0 以上を必要とします。
Composer の依存関係¶
アプリケーションの composer.json ファイルで以下の依存関係を更新する必要があります:
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/scoutを^10.0に (インストールされている場合)laravel/spark-stripeを^5.0に (インストールされている場合)laravel/telescopeを^5.0に (インストールされている場合)livewire/livewireを^3.4に (インストールされている場合)inertiajs/inertia-laravelを^1.0に (インストールされている場合)
アプリケーションが Laravel Cashier Stripe、Passport、Sanctum、Spark Stripe、または Telescope を使用している場合、それらのマイグレーションをアプリケーションに公開する必要があります。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
さらに、これらの各パッケージのアップグレードガイドを確認して、追加の破壊的変更に注意する必要があります:
Laravel インストーラを手動でインストールしている場合、Composer を介してインストーラを更新する必要があります:
最後に、以前にアプリケーションに追加した doctrine/dbal Composer 依存関係を削除することができます。Laravel はもはやこのパッケージに依存していません。
アプリケーション構造¶
Laravel 11 は、デフォルトのアプリケーション構造を新しくし、デフォルトのファイルが少なくなりました。具体的には、新しい Laravel アプリケーションには、サービスプロバイダ、ミドルウェア、および設定ファイルが少なくなりました。
ただし、Laravel 10 から Laravel 11 にアップグレードするアプリケーションがアプリケーション構造を移行しようとすることは推奨しません。Laravel 11 は、Laravel 10 のアプリケーション構造もサポートするように慎重に調整されています。
認証¶
パスワードの再ハッシュ¶
Laravel 11 は、ハッシュアルゴリズムの「作業係数」がパスワードが最後にハッシュされてから更新された場合、認証中にユーザーのパスワードを自動的に再ハッシュします。
通常、これはアプリケーションに影響を与えないはずです。ただし、この動作を無効にするには、アプリケーションの config/hashing.php 設定ファイルに rehash_on_login オプションを追加します:
'rehash_on_login' => false,
UserProvider コントラクト¶
影響の可能性: 低
Illuminate\Contracts\Auth\UserProvider コントラクトに新しい rehashPasswordIfRequired メソッドが追加されました。このメソッドは、アプリケーションのハッシュアルゴリズムの作業係数が変更された場合に、ユーザーのパスワードを再ハッシュしてストレージに保存する役割を果たします。
アプリケーションまたはパッケージがこのインターフェースを実装するクラスを定義している場合、新しい rehashPasswordIfRequired メソッドを実装に追加する必要があります。参照実装は Illuminate\Auth\EloquentUserProvider クラス内にあります:
public function rehashPasswordIfRequired(Authenticatable $user, array $credentials, bool $force = false);
Authenticatable コントラクト¶
影響の可能性: 低
Illuminate\Contracts\Auth\Authenticatable コントラクトに新しい getAuthPasswordName メソッドが追加されました。このメソッドは、認証可能なエンティティのパスワードカラムの名前を返す役割を果たします。
アプリケーションまたはパッケージがこのインターフェースを実装するクラスを定義している場合、新しい getAuthPasswordName メソッドを実装に追加する必要があります:
Laravel に含まれるデフォルトの User モデルは、このメソッドが Illuminate\Auth\Authenticatable トレイトに含まれているため、自動的にこのメソッドを受け取ります。
AuthenticationException クラス¶
影響の可能性: 非常に低
Illuminate\Auth\AuthenticationException クラスの redirectTo メソッドは、最初の引数として Illuminate\Http\Request インスタンスを必要とするようになりました。この例外を手動でキャッチして redirectTo メソッドを呼び出している場合、コードをそれに応じて更新する必要があります:
キャッシュ¶
キャッシュキープレフィックス¶
影響の可能性: 非常に低
以前は、DynamoDB、Memcached、または Redis キャッシュストアにキャッシュキープレフィックスが定義されている場合、Laravel はプレフィックスに : を追加していました。Laravel 11 では、キャッシュキープレフィックスに : サフィックスが付きません。以前のプレフィックス動作を維持したい場合は、キャッシュキープレフィックスに手動で : サフィックスを追加できます。
コレクション¶
Enumerable コントラクト¶
影響の可能性: 低
Illuminate\Support\Enumerable コントラクトの dump メソッドが、可変長引数 ...$args を受け入れるように更新されました。このインターフェースを実装している場合、実装をそれに応じて更新する必要があります:
データベース¶
SQLite 3.26.0+¶
影響の可能性: 高
アプリケーションが SQLite データベースを利用している場合、SQLite 3.26.0 以上が必要です。
Eloquent モデルの casts メソッド¶
影響の可能性: 低
ベースの Eloquent モデルクラスは、属性キャストの定義をサポートするために casts メソッドを定義するようになりました。アプリケーションのモデルの1つが casts リレーションを定義している場合、ベースの Eloquent モデルクラスに存在する casts メソッドと競合する可能性があります。
カラムの変更¶
影響の可能性: 高
カラムを変更する場合、変更後のカラム定義に保持したいすべての修飾子を明示的に含める必要があります。欠落している属性は削除されます。たとえば、unsigned、default、および comment 属性を保持するには、カラムを変更する際に各修飾子を明示的に呼び出す必要があります。以前のマイグレーションによってそれらの属性がカラムに割り当てられていた場合でも同様です。
たとえば、votes カラムを unsigned、default、および comment 属性で作成するマイグレーションがあるとします:
Schema::create('users', function (Blueprint $table) {
$table->integer('votes')->unsigned()->default(1)->comment('The vote count');
});
後で、カラムを nullable にも変更するマイグレーションを作成します:
Schema::table('users', function (Blueprint $table) {
$table->integer('votes')->nullable()->change();
});
Laravel 10 では、このマイグレーションはカラムに unsigned、default、および comment 属性を保持します。しかし、Laravel 11 では、マイグレーションに以前に定義されたすべての属性も含める必要があります。そうしないと、それらは削除されます:
Schema::table('users', function (Blueprint $table) {
$table->integer('votes')
->unsigned()
->default(1)
->comment('The vote count')
->nullable()
->change();
});
changeメソッドは、カラムのインデックスを変更しません。したがって、カラムを変更する際にインデックスを明示的に追加または削除するために、インデックス修飾子を使用することができます。
// インデックスを追加...
$table->bigIncrements('id')->primary()->change();
// インデックスを削除...
$table->char('postal_code', 10)->unique(false)->change();
カラムの既存の属性を保持するために、アプリケーション内のすべての既存の「change」マイグレーションを更新したくない場合は、単にマイグレーションを圧縮することができます。
マイグレーションが圧縮されると、Laravelはアプリケーションのスキーマファイルを使用してデータベースを「マイグレート」し、その後に保留中のマイグレーションを実行します。
浮動小数点型¶
影響の可能性: 高
doubleおよびfloatマイグレーションカラムタイプは、すべてのデータベースで一貫性を持つように書き直されました。
doubleカラムタイプは、合計桁数と小数点以下の桁数（小数点以下の桁数）なしでDOUBLE相当のカラムを作成します。これは標準のSQL構文です。したがって、$totalと$placesの引数を削除することができます。
floatカラムタイプは、合計桁数と小数点以下の桁数（小数点以下の桁数）なしでFLOAT相当のカラムを作成しますが、ストレージサイズを4バイトの単精度カラムまたは8バイトの倍精度カラムとして決定するためのオプションの$precision指定があります。したがって、$totalと$placesの引数を削除し、データベースのドキュメントに従って希望する値としてオプションの$precisionを指定することができます。
unsignedDecimal、unsignedDouble、およびunsignedFloatメソッドは削除されました。これらのカラムタイプの符号なし修飾子はMySQLによって非推奨となり、他のデータベースシステムでは標準化されていませんでした。ただし、これらのカラムタイプに対して非推奨の符号なし属性を引き続き使用したい場合は、カラム定義にunsignedメソッドを連鎖させることができます。
$table->decimal('amount', total: 8, places: 2)->unsigned();
$table->double('amount')->unsigned();
$table->float('amount', precision: 53)->unsigned();
専用のMariaDBドライバ¶
影響の可能性: 非常に低
MariaDBデータベースに接続する際に常にMySQLドライバを使用する代わりに、Laravel 11はMariaDB用の専用データベースドライバを追加しました。
アプリケーションがMariaDBデータベースに接続している場合、接続設定を新しいmariadbドライバに更新して、将来のMariaDB固有の機能を利用することができます。
'driver' => 'mariadb',
'url' => env('DB_URL'),
'host' => env('DB_HOST', '127.0.0.1'),
'port' => env('DB_PORT', '3306'),
// ...
現在、新しいMariaDBドライバは現在のMySQLドライバと同様に動作しますが、1つの例外があります。uuidスキーマビルダーメソッドは、char(36)カラムの代わりにネイティブのUUIDカラムを作成します。
既存のマイグレーションがuuidスキーマビルダーメソッドを使用しており、新しいmariadbデータベースドライバを使用することを選択した場合、uuidメソッドの呼び出しをcharに更新して、破壊的な変更や予期しない動作を避ける必要があります。
空間型¶
影響の可能性: 低
データベースマイグレーションの空間カラムタイプは、すべてのデータベースで一貫性を持つように書き直されました。したがって、マイグレーションからpoint、lineString、polygon、geometryCollection、multiPoint、multiLineString、multiPolygon、およびmultiPolygonZメソッドを削除し、代わりにgeometryまたはgeographyメソッドを使用することができます。
MySQL、MariaDB、およびPostgreSQLでカラムに格納される値のタイプまたは空間参照システム識別子を明示的に制限するために、メソッドにsubtypeとsridを渡すことができます。
$table->geometry('dimension', subtype: 'polygon', srid: 0);
$table->geography('latitude', subtype: 'point', srid: 4326);
PostgreSQL文法のisGeometryおよびprojectionカラム修飾子は、それに応じて削除されました。
Doctrine DBALの削除¶
影響の可能性: 低
以下のDoctrine DBAL関連のクラスとメソッドが削除されました。Laravelはもはやこのパッケージに依存せず、以前はカスタムタイプを必要としたさまざまなカラムタイプの適切な作成と変更のために、カスタムDoctrinesタイプの登録は不要になりました。
Illuminate\Database\Schema\Builder::$alwaysUsesNativeSchemaOperationsIfPossibleクラスプロパティIlluminate\Database\Schema\Builder::useNativeSchemaOperationsIfPossible()メソッドIlluminate\Database\Connection::usingNativeSchemaOperations()メソッドIlluminate\Database\Connection::isDoctrineAvailable()メソッドIlluminate\Database\Connection::getDoctrineConnection()メソッドIlluminate\Database\Connection::getDoctrineSchemaManager()メソッドIlluminate\Database\Connection::getDoctrineColumn()メソッドIlluminate\Database\Connection::registerDoctrineType()メソッドIlluminate\Database\DatabaseManager::registerDoctrineType()メソッドIlluminate\Database\PDOディレクトリIlluminate\Database\DBAL\TimestampTypeクラスIlluminate\Database\Schema\Grammars\ChangeColumnクラスIlluminate\Database\Schema\Grammars\RenameColumnクラスIlluminate\Database\Schema\Grammars\Grammar::getDoctrineTableDiff()メソッド
さらに、アプリケーションのdatabase設定ファイルでdbal.typesを介してカスタムDoctrineタイプを登録することは不要になりました。
以前にDoctrine DBALを使用してデータベースとその関連テーブルを検査していた場合、代わりにLaravelの新しいネイティブスキーマメソッド（Schema::getTables()、Schema::getColumns()、Schema::getIndexes()、Schema::getForeignKeys()など）を使用することができます。
非推奨のスキーマメソッド¶
影響の可能性: 非常に低
非推奨のDoctrineベースのSchema::getAllTables()、Schema::getAllViews()、およびSchema::getAllTypes()メソッドは、新しいLaravelネイティブのSchema::getTables()、Schema::getViews()、およびSchema::getTypes()メソッドに置き換えられ、削除されました。
PostgreSQLおよびSQL Serverを使用する場合、新しいスキーマメソッドは3つの部分からなる参照（例：database.schema.table）を受け入れません。したがって、代わりにconnection()を使用してデータベースを宣言する必要があります。
スキーマビルダーのgetColumnType()メソッド¶
影響の可能性: 非常に低
Schema::getColumnType()メソッドは、Doctrine DBAL相当のタイプではなく、指定されたカラムの実際のタイプを常に返すようになりました。
データベース接続インターフェース¶
影響の可能性: 非常に低
Illuminate\Database\ConnectionInterfaceインターフェースに新しいscalarメソッドが追加されました。このインターフェースの独自の実装を定義している場合、scalarメソッドを実装に追加する必要があります。
日付¶
Carbon 3¶
影響の可能性: 中
Laravel 11はCarbon 2とCarbon 3の両方をサポートしています。CarbonはLaravelとエコシステム全体のパッケージで広く使用されている日付操作ライブラリです。Carbon 3にアップグレードする場合、diffIn*メソッドが浮動小数点数を返し、時間の方向を示すために負の値を返す可能性があることに注意してください。これはCarbon 2からの大きな変更です。これらの変更やその他の変更を処理する方法については、Carbonの変更ログを確認してください。
メール¶
Mailerコントラクト¶
影響の可能性: 非常に低
Illuminate\Contracts\Mail\Mailerコントラクトに新しいsendNowメソッドが追加されました。アプリケーションまたはパッケージがこのコントラクトを手動で実装している場合、新しいsendNowメソッドを実装に追加する必要があります。
パッケージ¶
サービスプロバイダをアプリケーションに公開¶
影響の可能性: 非常に低
アプリケーションのapp/Providersディレクトリにサービスプロバイダを手動で公開し、アプリケーションのconfig/app.php設定ファイルを手動で変更してサービスプロバイダを登録するLaravelパッケージを作成した場合、パッケージを更新して新しいServiceProvider::addProviderToBootstrapFileメソッドを使用する必要があります。
addProviderToBootstrapFileメソッドは、公開したサービスプロバイダをアプリケーションのbootstrap/providers.phpファイルに自動的に追加します。これは、providers配列が新しいLaravel 11アプリケーションのconfig/app.php設定ファイルに存在しないためです。
use Illuminate\Support\ServiceProvider;
ServiceProvider::addProviderToBootstrapFile(Provider::class);
キュー¶
BatchRepositoryインターフェース¶
影響の可能性: 非常に低
Illuminate\Bus\BatchRepositoryインターフェースに新しいrollBackメソッドが追加されました。このインターフェースを独自のパッケージまたはアプリケーション内で実装している場合、このメソッドを実装に追加する必要があります。
データベーストランザクション内の同期ジョブ¶
影響の可能性: 非常に低
以前は、同期ジョブ（sync キュードライバーを使用するジョブ）は、キュー接続の after_commit 設定オプションが true に設定されているか、ジョブで afterCommit メソッドが呼び出されているかに関係なく、即座に実行されていました。
Laravel 11 では、同期キュージョブはキュー接続の「コミット後」設定やジョブに従うようになりました。
レートリミット¶
秒単位のレートリミット¶
影響の可能性: 中
Laravel 11 は、分単位の粒度に制限される代わりに、秒単位のレートリミットをサポートします。この変更に関連する潜在的な破壊的変更について、注意する必要があります。
GlobalLimit クラスのコンストラクタは、分ではなく秒を受け入れるようになりました。このクラスは文書化されておらず、通常はアプリケーションで使用されません：
Limit クラスのコンストラクタも、分ではなく秒を受け入れるようになりました。このクラスの文書化された使用法はすべて、Limit::perMinute や Limit::perSecond などの静的コンストラクタに制限されています。ただし、このクラスを手動でインスタンス化している場合は、アプリケーションを更新して、クラスのコンストラクタに秒を提供するようにしてください：
Limit クラスの decayMinutes プロパティは decaySeconds に名前が変更され、分ではなく秒を含むようになりました。
Illuminate\Queue\Middleware\ThrottlesExceptions および Illuminate\Queue\Middleware\ThrottlesExceptionsWithRedis クラスのコンストラクタは、分ではなく秒を受け入れるようになりました：
Cashier Stripe¶
Cashier Stripe の更新¶
影響の可能性: 高
Laravel 11 は Cashier Stripe 14.x をサポートしなくなりました。したがって、アプリケーションの Laravel Cashier Stripe 依存関係を composer.json ファイル内で ^15.0 に更新する必要があります。
Cashier Stripe 15.0 は、独自のマイグレーションディレクトリからマイグレーションを自動的にロードしなくなりました。代わりに、以下のコマンドを実行して、Cashier Stripe のマイグレーションをアプリケーションに公開する必要があります：
追加の破壊的変更については、完全な Cashier Stripe アップグレードガイド を確認してください。
Spark (Stripe)¶
Spark Stripe の更新¶
影響の可能性: 高
Laravel 11 は Laravel Spark Stripe 4.x をサポートしなくなりました。したがって、アプリケーションの Laravel Spark Stripe 依存関係を composer.json ファイル内で ^5.0 に更新する必要があります。
Spark Stripe 5.0 は、独自のマイグレーションディレクトリからマイグレーションを自動的にロードしなくなりました。代わりに、以下のコマンドを実行して、Spark Stripe のマイグレーションをアプリケーションに公開する必要があります：
追加の破壊的変更については、完全な Spark Stripe アップグレードガイド を確認してください。
Passport¶
Passport の更新¶
影響の可能性: 高
Laravel 11 は Laravel Passport 11.x をサポートしなくなりました。したがって、アプリケーションの Laravel Passport 依存関係を composer.json ファイル内で ^12.0 に更新する必要があります。
Passport 12.0 は、独自のマイグレーションディレクトリからマイグレーションを自動的にロードしなくなりました。代わりに、以下のコマンドを実行して、Passport のマイグレーションをアプリケーションに公開する必要があります：
さらに、パスワード付与タイプはデフォルトで無効になっています。アプリケーションの AppServiceProvider の boot メソッドで enablePasswordGrant メソッドを呼び出すことで有効にできます：
public function boot(): void
{
Passport::enablePasswordGrant();
}
Sanctum¶
Sanctum の更新¶
影響の可能性: 高
Laravel 11 は Laravel Sanctum 3.x をサポートしなくなりました。したがって、アプリケーションの Laravel Sanctum 依存関係を composer.json ファイル内で ^4.0 に更新する必要があります。
Sanctum 4.0 は、独自のマイグレーションディレクトリからマイグレーションを自動的にロードしなくなりました。代わりに、以下のコマンドを実行して、Sanctum のマイグレーションをアプリケーションに公開する必要があります：
次に、アプリケーションの config/sanctum.php 設定ファイルで、authenticate_session、encrypt_cookies、および validate_csrf_token ミドルウェアへの参照を以下のように更新する必要があります：
'middleware' => [
'authenticate_session' => Laravel\Sanctum\Http\Middleware\AuthenticateSession::class,
'encrypt_cookies' => Illuminate\Cookie\Middleware\EncryptCookies::class,
'validate_csrf_token' => Illuminate\Foundation\Http\Middleware\ValidateCsrfToken::class,
],
Telescope¶
Telescope の更新¶
影響の可能性: 高
Laravel 11 は Laravel Telescope 4.x をサポートしなくなりました。したがって、アプリケーションの Laravel Telescope 依存関係を composer.json ファイル内で ^5.0 に更新する必要があります。
Telescope 5.0 は、独自のマイグレーションディレクトリからマイグレーションを自動的にロードしなくなりました。代わりに、以下のコマンドを実行して、Telescope のマイグレーションをアプリケーションに公開する必要があります：
Spatie Once パッケージ¶
影響の可能性: 中
Laravel 11 は、指定されたクロージャが一度だけ実行されることを保証する独自の once 関数 を提供するようになりました。したがって、アプリケーションが spatie/once パッケージに依存している場合、競合を避けるために、アプリケーションの composer.json ファイルから削除する必要があります。
その他¶
また、laravel/laravel GitHub リポジトリ の変更も確認することをお勧めします。これらの変更の多くは必須ではありませんが、アプリケーションとこれらのファイルを同期させたい場合があります。このアップグレードガイドでは一部の変更がカバーされますが、設定ファイルやコメントの変更などはカバーされません。GitHub 比較ツール を使用して簡単に変更を確認し、どの更新が重要かを選択できます。