Upgrade Guide ​

Upgrading To 11.0 From 10.x

Updating Dependencies

Likelihood Of Impact: High

PHP 8.2.0 Required

Laravel now requires PHP 8.2.0 or greater.

Composer Dependencies

You should update the following dependencies in your application’s composer.json file:

• laravel/framework to ^11.0
• laravel/sanctum to ^4.0
• laravel/telescope to ^5.0 (If installed)

If your application is using Laravel Telescope, you should run the following command to publish Telescope’s migrations to your application. Telescope no longer automatically loads migrations from its own migrations directory:

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

In addition, you may remove the doctrine/dbal Composer dependency if you have previously added it to your application, as Laravel is no longer dependent on this package.

Application Structure

Laravel 11 introduces a new default application structure with fewer default files. Namely, new Laravel applications contain fewer service providers, middleware, and configuration files.

However, we do not recommend that Laravel 10 applications upgrading to Laravel 11 attempt to migrate their application structure, as Laravel 11 has been carefully tuned to also support the Laravel 10 application structure.

Authentication

Password Rehashing

Laravel 11 will automatically rehash your user’s passwords during authentication if your hashing algorithm’s “work factor” has been updated since the password was last hashed.

Typically, this should not disrupt your application; however, you may disable this behavior by adding the rehash_on_login option to your application’s config/hashing.php configuration file:

'rehash_on_login' => false,