Follow Us on Social Media
Devmont Digital Insights

To new businesses, give you the expertise, approaches, and techniques you should know to be a super hero.

BLOG - BLOG - BLOG - BLOG - BLOG - BLOG - BLOG - BLOG - BLOG

Laravel Upgrade Guide: 7 Steps to Move Off an Old Version

Nov 17, 2026
Laravel Upgrade Guide: 7 Steps to Move Off an Old Version
Laravel Upgrade Guide: 7 Steps to Move Off an Old Version

Your Laravel app works. Nobody wants to touch it. Then a host drops an old PHP version, a security scanner flags a package, or a new developer refuses to work on a version that stopped getting patches years ago. The longer the upgrade waits, the more versions it has to cross, and every version adds its own breaking changes.

This guide gives a practical order of work for upgrading a Laravel application, from checking whether you need to, through seven steps that keep production safe. It also compares doing it yourself, using an automated tool, and hiring it out, so you can decide before you start.

Is your version still supported?

Laravel supports each major release with bug fixes for 18 months and security fixes for two years. Once security fixes end, a newly found vulnerability in the framework is not patched for your version.

Version PHP versions Security fixes until
10 8.1 to 8.3 February 4, 2025
11 8.2 to 8.4 March 12, 2026
12 8.2 to 8.5 February 24, 2027
13 8.3 to 8.5 Q1 2028 (planned)

Source: the Laravel release notes. Versions 8 and 9 ended before this table starts.

If your app runs on 11 or older, it no longer receives security fixes. If it runs on 12, you have time, but not much of it, and a version-by-version upgrade is easier to plan than an emergency. If you would rather hand the work over, that is part of our Laravel development services, covered further down.

What usually breaks

Most upgrade pain falls into five areas. Know them before you start.

Area What breaks How to find it
PHP version Each Laravel version needs a minimum PHP version, and servers on old PHP cannot run it Check the table above against
php -v on every environment
Packages Abandoned or slow-to-update packages block the upgrade composer why-not laravel/framework:^13.0
Removed or changed framework methods Code that worked on your old version fails or behaves differently Your test suite, plus the upgrade guide for each version
Third-party services Payment, mail and storage integrations depend on library versions Test each integration on staging with test credentials
Hosting and deployment Old servers, shared hosting limits, build scripts tied to old Node or PHP A staging server that matches production

One note on structure. Laravel 11 introduced a slimmer default application skeleton, but the official upgrade guide does not require existing apps to adopt it. Upgrade first and restructure later, as a separate task

The 7 steps

1. Freeze scope and copy production

Create a branch for the upgrade and stop merging unrelated features into it. Copy the production database to a staging environment, with personal data removed, so you test on realistic data. Take a full backup of production before any deploy.

2. Write a safety net first

If the app has no tests, write them before you upgrade. They do not need to be perfect. Cover the flows that make money or lock people out: sign in, checkout, payments, password reset, exports and any scheduled job. Then run them to get a baseline:

php artisan test

An upgrade without tests is a guess. You find breakage when a customer does.

3. Audit your packages

List what is outdated, check what blocks the target version, and check for known vulnerabilities:

composer outdated --direct
composer why-not laravel/framework:^13.0
composer audit

Replace or fork abandoned packages now. A package that no longer updates is the most common reason an upgrade stalls halfway.

4. Raise PHP on staging

Move staging to a PHP version your next target supports. Run the tests again before touching Laravel. If the suite passes on the new PHP, you have already separated the PHP problems from the Laravel problems.

5. Upgrade one major version at a time

Follow the upgrade guide for each version, in order, and run the tests after every step:

composer require laravel/framework:^9.0 --update-with-all-dependencies
php artisan test

Then repeat for 10, 11, and so on. Going from version 8 to 13 is five hops. Teams with strong tests sometimes skip hops, but every skipped version multiplies the unknowns in one big change. Commit each hop on its own so you can find which step broke what.

6. Fix deprecations and add static analysis

Once you are on the target version, clean up the deprecation warnings. Add a static analysis tool such as Larastan to catch type problems the tests miss, and run Laravel Pint to keep style changes separate from logic changes. This is the step people skip, and it is where quiet bugs hide.

7. Stage, test, deploy with a way back

Run the full test suite and a manual pass on staging. Test every payment webhook with test credentials, because failures there are silent until money goes missing. Our guide to fixing payment gateway problems is written for Shopify, but the failure patterns it describes apply to any checkout.  Deploy at a quiet time with a rollback plan, then restart queue workers so they load the new code:

php artisan queue:restart

Watch your error logs and your scheduled jobs for the first few days.

Do it yourself, use a tool, or hire it out?

Option Works best when Watch out for
Do it yourself You have a developer who knows the app, good test coverage and time to spare The upgrade competes with feature work, and gaps in tests surface late
An automated tool such as Laravel Shift The app is conventional and mostly follows framework defaults It automates framework changes, not your custom code or abandoned packages
Hire a Laravel team The app is business critical, has weak tests, takes payments or runs on an end-of-life version Choose a team that shows you a written plan and demos on staging before touching production

Tools help with the mechanical part, and they are worth using. They do not decide what to test, which packages to replace, or when to deploy. Those decisions are the real work.

When an upgrade is the wrong answer

Sometimes the app has deeper problems: no structure, logic spread across views, queries that fall over under load. An upgrade will not fix those, and it can make them harder to see. In that case, plan the upgrade together with a cleanup, using the principles in our guide to building scalable Laravel applications. And if the app is mostly pages and posts, ask whether Laravel was the right tool at all, using our Laravel vs WordPress comparison.

How we handle upgrades

When we upgrade a client application, you get a written plan before work starts, one branch per version hop, a staging site you can click through, and notes on every change that touched your code. That is how a team that works in your time zone keeps an upgrade readable instead of a black box.

Frequently Asked Questions

Run php artisan --version in the project folder, or open composer.lock and find the laravel/framework entry. The lock file shows the exact installed version, while composer.json shows only the allowed range. Check both, since the two can differ on long-running projects.

Technically you can change the version constraint and run Composer, but the official approach is one major version at a time, following each upgrade guide. Skipping hops means fixing every breaking change at once, with no way to tell which one caused a failure.

It depends on test coverage, how many versions you cross, how many packages are abandoned, and how much custom code touches framework internals. A small app with good tests moves quickly. A large app without tests takes longer, because writing the safety net comes first. Get an estimate after a code review.
Maria
About the Author

Maria

Content Manager at Devmont Digital

Maria is Content Manager at Devmont Digital, writing practical guides on WordPress, Shopify and Laravel for founders and marketing teams. The Devmont Digital team builds websites, stores, and web apps for clients across the US, UK, and Europe. Specialising in WordPress, Shopify, Laravel, and MERN, the team publishes plugins on WordPress.org and apps on the Shopify App Store, and has been recognised by Clutch as a top developer.


Recent Article

Nov 10, 2026

A reader opens your 2,000-word guide looking for one answer. They scroll, lose their place, scroll back up, and leave. Long posts only work when readers can jump to the part they came for, and WordPress does not ship a table of contents that does that. This guide shows three ways to add a sticky […]

Read more
Nov 3, 2026

You hand a client a finished website. The design is theirs, the copy is theirs, and then they open wp-login.php for the first time and see the WordPress logo. Click it and it opens wordpress.org. To a client who just paid for a custom brand, that looks like unfinished work, and it is the page their whole team sees every day.

Read more
Oct 27, 2026

You publish on Medium, but your own website shows none of it. A visitor who lands on your homepage has no idea you write at all, and the stories you spent hours on sit on someone else’s domain. Linking to them by hand works for a week. Then you publish again and the page is out of date.

Read more