Filament 5 wyszedł w styczniu 2026 i jest wydaniem, którego głównym celem było wsparcie Livewire 4 — funkcjonalnie odpowiada Filamentowi 4, więc nie znajdziesz tu rewolucji w API, ale i tak warto zaplanować aktualizację: nowe projekty startują na piątce, a ekosystem wtyczek stopniowo się na nią przenosi. Ten artykuł zbiera, co dokładnie się zmieniło, jakie są wymagania i jak przeprowadzić migrację krok po kroku — bez przestoju w działaniu panelu.
Jeśli dopiero wybierasz framework panelu, zacznij od artykułu Filament i Livewire — panele administracyjne w Laravel; ten tekst jest dla zespołów, które mają działający panel na Filament 3 lub 4 i chcą go bezpiecznie zaktualizować.
Co nowego w Filament 5?
- Wsparcie Livewire 4 — to główna zmiana wydania. Filament 5 działa na Livewire 4, który jest teraz wymagany; sama architektura paneli, zasobów i formularzy pozostaje zgodna z wersją 4.
- Nowe wymagania bazowe — PHP 8.2+, Laravel 11.28+ i Tailwind CSS 4. Jeśli Twój panel stoi na starszym Laravelu, aktualizacja frameworka będzie pierwszym krokiem.
- Skrypt aktualizacji — migracja z Filament 4 odbywa się oficjalnym skryptem, bez ręcznego przepisywania kodu. Zmiany dotykają przede wszystkim zależności i pojedynczych sygnatur, nie logiki zasobów.
- Spójny ekosystem — wtyczki i motywy stopniowo wydają wersje zgodne z piątką; przed migracją warto sprawdzić status tych, których używasz.
| Komponent | Wymagana wersja |
|---|---|
| PHP | 8.2+ |
| Laravel | 11.28+ (w tym Laravel 12) |
| Livewire | 4 |
| Tailwind CSS | 4 |
Najważniejsze: Filament 5 to wydanie zgodnościowe z Livewire 4, a nie przepisanie frameworka. Dla większości paneli migracja z wersji 4 to kwestia dni — aktualizacja zależności, skrypt, testy i wdrożenie. Prawdziwym wyzwaniem bywa nie sam Filament, a zaległe aktualizacje Laravela i wtyczek.
Migracja z Filament 4 — krok po kroku
1. Inwentaryzacja panelu i wtyczek
Zanim cokolwiek zaktualizujesz, wypisz: używane wtyczki i ich status wsparcia dla Filament 5, własne pola i strony, motywy oraz niestandardowe rozszerzenia. To lista ryzyk, która zdecyduje o kolejności prac.
2. Aktualizacja Laravela i Livewire
Filament 5 wymaga Laravela 11.28+ i Livewire 4. Jeśli masz zaległości, najpierw domknij je według planu z artykułu aktualizacja Laravel — plan migracji — dopiero potem ruszaj z Filamentem.
3. Composer update i skrypt aktualizacji
Podnieś wersje pakietów filament/* i uruchom oficjalny skrypt aktualizacji. Skrypt przechodzi przez najczęstsze zmiany między wersjami — po jego wykonaniu zostaje przegląd kodu własnych rozszerzeń.
4. Testy własnych elementów
Przetestuj to, co niestandardowe: własne pola formularzy, tabele, widgety dashboardu, strony z własnymi widokami i motywy. Największa część pracy przy migracji to nie framework, a własny kod na nim zbudowany.
5. Staging, potem produkcja
Całą migrację przeprowadź najpierw na kopii produkcyjnej bazy na środowisku staging. Na produkcję wchodzisz z gotowym planem rollbacku — w praktyce aktualizacja Filamentu to zwykle kilkuminutowe okno wdrożeniowe, ale przy dużych panelach lepiej zaplanować je poza godzinami pracy zespołu.
Ile trwa migracja do Filament 5?
| Zakres panelu | Orientacyjny czas |
|---|---|
| Prosty panel bez własnych rozszerzeń | 1–2 dni |
| Panel z wtyczkami i własnymi polami | 3–5 dni |
| Rozbudowany panel z motywem i integracjami | 1–3 tygodnie |
W projektach, które prowadzimy, aktualizacja Filamentu jest zwykle częścią szerszej aktualizacji Laravela — łączymy je w jedno okno wdrożeniowe. Jeśli nie masz zespołu utrzymaniowego, robimy to w ramach opieki technicznej.
Kiedy zostać na Filament 4, a kiedy migrować z 3?
- Filament 4 — nie musisz się spieszyć, jeśli panel działa i nie planujesz nowych wdrożeń. Zaplanuj aktualizację w najbliższym oknie serwisowym, zanim wtyczki zaczną wymagać piątki.
- Filament 3 — migruj dwuetapowo: najpierw do wersji 4, potem do 5. Każdy krok osobno, z testami — łączenie dwóch dużych aktualizacji w jeden deployment to najczęstsze źródło problemów.
- Nowy projekt — zawsze Filament 5. Nie ma powodu startować na starszej wersji.
Najczęściej zadawane pytania
Filament 5 czy Filament 4 — co wybrać w nowym projekcie?
Filament 5 — to aktualna wersja, wymaga PHP 8.2+, Laravela 11.28+ i Livewire 4. Jest zgodna funkcjonalnie z czwórką, więc nie tracisz żadnych możliwości, a zyskujesz wsparcie i aktualizacje.
Czy migracja z Filament 4 do 5 jest trudna?
Dla większości paneli nie — aktualizacja odbywa się oficjalnym skryptem, a zmiany w API są minimalne. Najwięcej pracy generują własne pola, motywy i wtyczki, które trzeba przetestować. Prosty panel to 1–2 dni, rozbudowany — do kilku tygodni.
Czy wtyczki do Filament 4 działają na Filament 5?
Większość popularnych wtyczek wydała wersje zgodne z piątką. Przed migracją sprawdź status każdej wtyczki, której używasz — jeśli któraś nie ma wsparcia, zaplanuj alternatywę albo przesuń aktualizację.
Czy aktualizacja Filamentu wymaga aktualizacji Laravela?
Zwykle tak — Filament 5 wymaga Laravela 11.28+. Jeśli masz starszą wersję frameworka, aktualizacja Laravela będzie pierwszym krokiem; jak ją zaplanować, opisuję w artykule aktualizacja Laravel — plan migracji.
👉 Masz panel na Filament 3 lub 4 i chcesz go bezpiecznie zaktualizować? Robimy takie migracje z testami na stagingu — zobacz Laravel Development lub opiekę techniczną.
📖 Zobacz również: Filament i Livewire — panele administracyjne w Laravel, Filament vs Nova vs Backpack oraz aktualizacja Laravel — plan migracji.