Laravel 11'den 12'ye Geçiş Rehberi: Breaking Changes ve Deploy Kontrol Listesi (2026)

Laravel ekosisteminin en güncel ana sürümü olan Laravel 12, daha yalın uygulama iskeleti, modern PHP 8.2+ özellikleri ve optimize edilmiş dahili servislerle yayınlandı. Mevcut bir Laravel 11 projesini Laravel 12'ye sıfır kesintiyle yükseltmek için bu kontrol listesini adım adım takip edebilirsiniz.

1. Sistem ve Runtime Gereksinimleri

• PHP: Minimum 8.2.0 (PHP 8.3 önerilir).
• Composer: Minimum 2.7.0+.
• Veritabanı: MySQL 8.0+, PostgreSQL 14+, SQLite 3.35+ veya MariaDB 10.10+.

2. composer.json Bağımlılıklarını Güncelleme

composer.json dosyanızdaki ana framework ve birinci parti paket sürümlerini güncelleyin:

"require": {
    "php": "^8.2",
    "laravel/framework": "^12.0",
    "laravel/tinker": "^2.10"
},
"require-dev": {
    "nunomaduro/collision": "^8.1",
    "pestphp/pest": "^3.0",
    "pestphp/pest-plugin-laravel": "^3.0"
}

Ardından terminalinizde bağımlılıkları güncelleyin:

3. Skyversal PaaS ile Güvenli Zero-Downtime Deploy

Skyversal Git-push hattı, Laravel 12 projelerini otomatik olarak algılar ve PHP 8.2+ konteynerinde derler. Veritabanı tablolarında kilitlenme yaşamamak için:

• Additive Migration: Sütun silmek yerine önce yeni sütun ekleyin, kodu deploy edin, ardından eski sütunu temizleyin.
• Migration Toggle: Skyversal panelindeki Otomatik Migration anahtarı açık olduğunda php artisan migrate --force adımı derleme sonrasında güvenle yürütülür.