Skip to content

Laravel 13.x Shift - #174

Open
ohnotnow wants to merge 10 commits into
upgrade/laravel-13from
shift-174889
Open

Laravel 13.x Shift#174
ohnotnow wants to merge 10 commits into
upgrade/laravel-13from
shift-174889

Conversation

@ohnotnow

Copy link
Copy Markdown
Contributor

This pull request includes the changes for upgrading to Laravel 13.x. Feel free to commit any additional changes to the shift-174889 branch.

Before merging, you need to:

  • Checkout the shift-174889 branch
  • Review all pull request comments for additional changes
  • Run composer update (if the scripts fail, try with --no-scripts)
  • Clear any config, route, or view cache
  • Thoroughly test your application (no tests?, no CI?)

If you get stuck, never hesitate to email support. If you need more help with your upgrade, check out the Human Shifts.

@ohnotnow

Copy link
Copy Markdown
Contributor Author

⚠️ Shift upgraded your configuration files by defaulting them and merging your true customizations. These include values which are not changeable through core ENV variables.

You should review this commit for additional customizations or opportunities to use new ENV variables. If you have a lot of customizations, you may undo this commit with git revert eeb1b505 and make the config file changes manually.

@ohnotnow

Copy link
Copy Markdown
Contributor Author

⚠️ The default values for CACHE_PREFIX, REDIS_PREFIX, and SESSION_COOKIE changed in Laravel 13. If you are not setting these values explicitly, this change could cause cache or session invalidation after upgrading. As these defaults have changed a few times in recent Laravel versions, Shift recommends explicitly setting these ENV variables in your environment to ensure consistent behavior when upgrading.

 ✨ Automate more with AI...

Shift automates the changes it determines are reliable. If you want to push this automation further, you may paste the following prompt into your AI of choice:

I'm upgrading to Laravel 13. The default values for `CACHE_PREFIX`,
`REDIS_PREFIX`, and `SESSION_COOKIE` have changed. In Laravel 12 and earlier,
these were derived from `APP_NAME` using `Str::slug(env('APP_NAME', 'laravel'),
'_')` as a base (e.g. `myapp_cache_`, `myapp_database_`, `myapp_session`).
Please check my config files and `.env` to determine if these are explicitly set
or relying on the old defaults. If relying on defaults, suggest the explicit
values I should add to my `.env` to preserve the previous behavior.

@ohnotnow

Copy link
Copy Markdown
Contributor Author

⚠️ The default cache configuration now includes a serializable_classes option set to false. This hardens cache unserialization behavior to help prevent PHP deserialization attacks. If your application stores PHP objects in cache, you should update this value to an array of the classes that may be unserialized.

 ✨ Automate more with AI...

Shift automates the changes it determines are reliable. If you want to push this automation further, you may paste the following prompt into your AI of choice:

I'm upgrading to Laravel 13. The default cache configuration now includes a
`serializable_classes` option set to `false` to prevent PHP deserialization
attacks. Please search my codebase for any code that stores PHP objects in the
cache (e.g. using `Cache::put()`, `cache()`, or `remember()` with object
values). If found, identify the classes being cached and suggest the explicit
list of classes I should set for the `serializable_classes` option in
`config/cache.php`.

@ohnotnow

Copy link
Copy Markdown
Contributor Author

❌ Shift detected a PHP version constraint of ^8.2 in your composer.json file. Laravel 13 requires PHP 8.3 or higher. Shift bumped your PHP dependency to make your application compatible. However, if you encounter PHP errors, you should review the Migration Notes to ensure your PHP code is compatible.

@ohnotnow

Copy link
Copy Markdown
Contributor Author

⚠️ Shift detected your application is using Pest. To provide you with a compatible set of dependencies, Shift bumped your version of Pest to 4.x. While your test suite may still run, you are encouraged to review their Upgrade Guide to ensure your test suite is fully upgraded.

@ohnotnow

Copy link
Copy Markdown
Contributor Author

ℹ️ Shift updated your dependencies for Laravel 13. While many of the popular packages are reviewed, you may have to update additional packages in order for your application to be compatible with Laravel 13. Watch dealing with dependencies for tips on handling any Composer issues.

The following dependencies were not updated by Shift and may be incompatible. If Composer lists one of these packages as a problem, you should check for a newer version.

@ohnotnow

Copy link
Copy Markdown
Contributor Author

ℹ️ Shift detected you are running Livewire 3. While this is compatible with Laravel 13, Shift recommends upgrading. Once you have a verified your Laravel upgrade, you may run the Livewire 4.x Shift to upgrade to Livewire 4.

@ohnotnow

Copy link
Copy Markdown
Contributor Author

ℹ️ Laravel added a composer run dev script which starts php artisan serve, php artisan queue:listen --tries=1, php artisan pail, and npm run dev all in one command.

Shift added this script, as well as the necessary packages. Once you run composer update and npm install, you will be able to use the new composer run dev script.

@ohnotnow

Copy link
Copy Markdown
Contributor Author

ℹ️ Laravel added a composer run setup script which runs commands like composer install, npm install, and others to set up your Laravel application. For convenience, Shift added the default script. You are encouraged to customize this script for your project.

@ohnotnow

Copy link
Copy Markdown
Contributor Author

ℹ️ Laravel added a composer run test script which runs the new php artisan config:clear command, then php artisan test. For convenience, Shift added the default script. You are welcome to customize this script for your test suite.

@ohnotnow

Copy link
Copy Markdown
Contributor Author

ℹ️ Laravel 13 changed the password reset mail subject from "Reset Password Notification" to "Reset your password". If your application relied on the previous subject, for example in custom translation messages, you should update them accordingly.

@ohnotnow

Copy link
Copy Markdown
Contributor Author

🎉 Congratulations, you're now running the latest version of Laravel!

Next, you may optionally run the following Shifts to ensure your application is fully upgraded, adopts the latest Laravel conventions, and easier to maintain in the future:

  • Laravel Fixer automatically updates your code to the latest Laravel conventions.
  • Tests Generator intelligently generates model factories, HTTP Tests, and configuration for your application.
  • CI Generator intelligently generates CI jobs to lint PHP, check code style, and run tests, including Dusk.

You may also use the Shift Workbench to automate common tasks for maintaining your Laravel application.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants