🚀 Laravel 12 → 13 Migration Guide (Step-by-Step Upgrade Guide)

The Laravel ecosystem continues to evolve rapidly, and Laravel 13 was released in 2026. But is it difficult to upgrade an existing project from Laravel 12 to 13?

In this article, I explain all the necessary steps in a simple and clear way to ensure a smooth transition in real production projects .

📌 Things You Should Know Before Upgrading to Laravel 13

Laravel 13 isn't a groundbreaking release, but it does include some significant changes.

✔️ The most critical changes:

1. Minimum PHP: 8.3
2. CSRF middleware changed.
3. There are minor changes to the queue event structure.
4. Caching and serialization have been made more secure.
5. Some internal behaviors have been updated.

🧱 1. Upgrade your PHP version.

To use Laravel 13:

Least:

👉 If you are using Docker:

📦 2. Update Your Composer Addictions

Update your composer.json file as follows:

After that:

⚠️ 3. CSRF Middleware Modification

Included with Laravel 13:

❌ Old:

✅ New:

👉 If you are using withoutMiddleware() or custom middleware, be sure to check.

⚙️ 4. Queue & Job Changes

There are small but critical changes to queue events:

❌ Old:

✅ New:

❌ Old:

✅ New:

👉 If you've written an event listener, be sure to check it.

🧠 5. Pay Attention to Cache Usage

Cache security has been improved with Laravel 13.

Problem:

If you are placing an object directly into the cache:

👉 This could now cause problems.

Solution:

1. Use arrays
2. Use DTO
3. or manage serialization permissions

📦 6. Check 3rd Party Packages

This is the most critical point 👇

Don't upgrade without checking these things first:

1. Laravel Horizon
2. Laravel Excel
3. Spatie packages
4. Sanctum / Passport
5. Debug tools

👉 Make sure they all support Laravel 13.

🧭 Route Behavior Changed (Nothing More Expected)

If you are using domain-based routing, be aware of the following:

👉 In Laravel 13, domain routes now have higher priority.

This can lead to some route conflicts.

🧪 8. Testing and Cleaning

After the upgrade, you must:

🔍 9. Quick Control Commands

Look for the following in your project:

🧩 10. Secure Upgrade Strategy

Proposed production workflow for the project:

1. Open a new branch
2. Upgrade to PHP 8.3
3. Composer update
4. Correct package compatibility.
5. Run the tests
6. Try in a staging environment
7. Take it to production

🎯 Result

Laravel 12 → 13 transition:

✅ Not difficult

⚠️ But it requires caution.

Especially:

1. Queue
2. Cache
3. Middleware
4. 3rd party packages

If properly checked, the upgrade can be done without any problems.