Filament v5 Yayınlandı: Yenilikler, Değişiklikler ve Güncelleme Yapmalı mısınız?

Orijinal olarak hafiz.dev adresinde yayınlanmıştır.

Filament v5, 16 Ocak 2026’da yayımlandı. Eğer Filament’i Laravel yönetici panellerinizde kullanıyorsanız, muhtemelen duyuruları görmüş ve: aslında neyin yeni olduğunu merak etmişsinizdir. Şu anda yükseltme yapmalı mıyım?

Ben, resmi sürüm duyurusu, yükseltme kılavuzu ve Livewire v4 belgelerini gözden geçirerek durumu sizin için sadeleştirdim.

Kısa Versiyon

Belki de sizi şaşırtacak şey: Filament v5, v4 ile karşılaştırıldığında yeni bir özellik içermiyor. Sıfır. Bu büyük sürüm artışının tek nedeni Livewire v4 desteğidir.

Bu kadar. İşte sürüm.

Fakat bu sekmeyi kapatmadan önce listenin uzağına gideceğe benzemiyorsunuz; yükseltmekle açtığınız Livewire v4 özellikleri oldukça önemli ve yükseltme süreci, büyük sürüm yükseltmeleri için en acısız olanıdır.

Neden Sadece Livewire Desteği için Büyük Bir Sürüm?

Filament ekibi burada kasıtlı bir seçim yaptı. Livewire v4 desteğini Filament v4 için küçük bir güncelleme olarak gönderebilirlerdi, ancak bu, Livewire’ı içsel olarak kullanan projeleri potansiyel olarak bozabilirdi.

Bir büyük sürüm yaparak, Livewire’a açıkça ihtiyaç duymayan projelerin, rutin composer update çalışmaları sırasında beklenmedik bir bozulmayı yaşamayacağını garanti altına aldılar. Bu, semver’ı dikkate alan bir yaklaşımdır ve bunu takdir ediyorum.

Ekip ayrıca, v4 ve v5’e özellik eklemeye devam edeceklerini onayladı, bu nedenle hemen yükseltmek zorunda değilsiniz.

Gereksinimler

Yükseltmeye başlamadan önce projenizin bu gereksinimleri karşıladığından emin olun:

• PHP 8.2+
• Laravel 11.28+
• Livewire 4.0+
• Tailwind CSS 4.0+

Tailwind v4 gereksinimi bazı projeler için en büyük engel olabilir. Eğer hala özel bir tema ile Tailwind v3 kullanıyorsanız, önce Tailwind’i yükseltmeniz gerekecektir.

Yükseltme Süreci

Yükseltme oldukça basit. Filament, çoğu işi üstlenen otomatik bir script sağlar:

composer require filament/upgrade:"^5.0" -W --dev

vendor/bin/filament-v5

Script projenizi analiz edecek ve ayarlarınıza göre özelleştirilmiş composer komutları üretecektir. Bu komutları çalıştırın:

# Bunlar projenize özel olacaktır
composer require filament/filament:"^5.0" -W --no-update
composer update

İşleminiz tamamlandığında, yükseltme paketini kaldırın:

composer remove filament/upgrade --dev

Windows PowerShell kullanıyorsanız, ^5.0 yerine ~5.0 kullanın çünkü PowerShell ‘caret’ karakterini görmezden gelir.

Özel Livewire Bileşenleri Ne Olacak?

Eğer projeniz Filament dışında özel Livewire bileşenlerine sahipse, Livewire v4 yükseltme kılavuzunu takip etmeniz gerekecektir. Bu süreçte bazı manuel iş gerektirebilir.

Livewire v4’teki ana kırılma değişiklikleri arasında:

• Ayar dosyası güncellemeleri: Birkaç anahtar yeniden adlandırılmıştır. layout artık component_layout olarak geçmektedir ve varsayılan düzen layouts:: ad alanını kullanmaktadır.
• wire:model davranış değişikliği: Artık çocuk elemanlardan yukarı doğru yükselen olaylara tepki vermez. Bu davranışa güveniyorsanız .deep eklemeniz gerekmektedir.
• Bileşen etiketleri kapatılmalıdır: artık şeklinde olmalıdır.
• wire:transition View Transitions API’yi kullanır: .opacity veya .duration gibi dönüştürücüler kaybolmuştur.

Filament’a özel projelerin çoğu için bunlar hakkında endişelenmenize gerek yok. Filament yükseltme scripti gerekli olanları yönetir.

Eklenti Uyumluluğu: Gerçek Değerlendirme

Burada bir mola vermek isteyebilirsiniz. Bazı Filament eklentileri henüz v5 ile uyumlu olmayabilir.

Yükseltme scripti, eklentilerinizi kontrol edecek ve uyumluluk sorunları hakkında sizi uyaracaktır. Birkaç seçeneğiniz var:

1. Bekleyin eklentileriniz güncellenene kadar
2. Geçici olarak çıkarın uyumsuz eklentileri composer.json dosyasından
3. V5 destekleyen alternatifler bulun
4. Eklenti yazarlarına yükseltmeleri yardım edin

Projeniz ağır bir şekilde üçüncü taraf eklentilere bağımlıysa, yükseltmeden önce GitHub repolarını v5 desteği için kontrol etmenizi öneririm.

Livewire v4 Gerçekten Neler Getiriyor?

Şimdi heyecan verici kısma geçelim. Filament v5 ile Livewire v4’ten ne gibi özellikler kazanıyorsunuz:

Tek Dosya Bileşenleri

Artık Livewire bileşenlerinizi PHP ve Blade’i tek bir dosyada yazabilirsiniz:

// resources/views/components/⚡counter.blade.php

use Livewire\Component;

new class extends Component {
    public $count = 0;

    public function increment() {
        $this->count++;
    }
};
?>


    {{ $count }}
     wire:click="increment">+

Evet, dosya adındaki yıldırım simgesi kasıtlı. Eğer emojileri sevmiyorsanız devre dışı bırakabilirsiniz.

Adalar

Bu, performans için büyük bir gelişme. Adalar, bileşen içinde bağımsız olarak güncellenen izole bölgeler oluşturmanızı sağlar:

@island(name: 'stats', lazy: true)
    
{{ $this->expensiveStats }}
@endisland

“Adalar” üzerinde “Yenile” düğmesine tıkladığınızda, yalnızca o ada yeniden oluşturulur. Diğerleri etkilenmez. Daha önce bunu ayrı bir çocuk bileşenine ayırmanız gerekiyordu.

Drag-and-Drop İçin wire:sort

Harici paketler olmadan, yerleşik sıralanabilir listeler:

    @foreach ($items as $item)
        

            {{ $item->name }}
        
    @endforeach

Asenkron İşlemler

Diğer istekleri engellemeyen paralel işlemler yürütün:

İzle

Ya da PHP niteliğiyle:

#[Async]
public function logActivity() { ... }

Performans İyileştirmeleri

Livewire v4, engellemeyen polling ve paralel canlı güncellemeleri getiriyor. wire:model.live istekleri artık paralel çalışıyor, bu da yazma işlemini daha duyarlı hale getiriyor.

Filament Blueprint’u Tanıtıyoruz

v5 ile birlikte, Filament ekibi ayrıca Filament Blueprint adlı AI destekli geliştirme için premium bir araç sundu.

Filament uygulamaları oluştururken AI kodlama ajanlarını (Claude Code, Cursor veya GitHub Copilot gibi) kullanıyorsanız, bu ajanların genellikle ad alanlarını yanlış aldığını, yapılandırma detaylarını kaçırdığını veya düzgün çalışmayan düzenler oluşturduğunu fark etmişsinizdir.

Blueprint, AI ajanınza Filament’in bileşenleri ve en iyi uygulamaları hakkında kapsamlı bilgiler sağlayan bir Laravel teşvik eklentisidir. Belirsiz uygulama planları yerine, size detaylı spesifikasyonlar, kesin bileşen referansları, CLI komutları ve yapılandırma zincirleri alıyorsunuz.

Bu, herkesin ihtiyacı olan bir şey değil, ama AI destekli geliştirme iş akışınızın bir parçasıysa kontrol etmenize değer olabilir.

Şimdi Yükseltmeli Misin?

İşte benim görüşüm:

Hemen yükseltin eğer:

• Eklentileriniz v5 ile uyumluysa
• Zaten Tailwind v4 üzerindeyseniz
• Livewire v4’ün Adalar gibi özelliklerine erişmek istiyorsanız
• Yeni bir proje başlatıyorsanız

Bekleyin eğer:

• Kritik eklentiler henüz v5’i desteklemiyorsa
• Özel temalarla Tailwind v3 üzerindeyseniz
• Projeniz kritik bir aşamada ve istikrar daha önemliyse

İyi haber şu ki, acele yok. Filament v4, özellikler almaya devam edecek ve yükseltme yolu, daha fazla eklenti güncellenirken daha da kolaylaşacaktır.

Son Düşünceler

Filament v5, akıllı ve temkinli bir sürümdür. Ekip, parlak yeni özellikler yerine istikrara öncelik vermiştir ve otomatik yükseltme scripti geçişi olabildiğince acısız hale getiriyor.

Buradaki gerçek değer, Livewire v4’ü açmaktır. Adalar ve asenkron işlemler gibi özellikler, yönetim panelinizin performansını ve kullanıcı deneyimini önemli ölçüde iyileştirebilir.

Yükseltme için doğru zamanı bekliyorsanız, bu muhtemelen odaklanmanız gereken zamandır. Yükseltme scripti çoğu işi hallediyor ve ekosistem hızla ilerliyor.

Kaynaklar

Filament projenizi yükseltme ile ilgili sorularınız mı var? Laravel geliştiricilerine yönetici paneli mimarisi ve optimizasyonu konusunda yardımcı oluyorum. İletişime geçin.