Filament PHP: v4 o v5, quale scegliere

Filament PHP è una raccolta di pacchetti open source per Laravel che costruisce pannelli di amministrazione, tabelle e form partendo da classi PHP, senza scrivere HTML o JavaScript a mano. Oggi il progetto ha due versioni mantenute in parallelo: la 4, legata a Livewire 3, e la 5, che richiede Livewire 4. Su un progetto nuovo si installa la 5, su un progetto già avviato con Livewire 3 conviene restare sulla 4, perché le due linee ricevono le stesse patch nello stesso giorno.

Cos'è Filament PHP e cosa fa in concreto?

Filament genera l'interfaccia di amministrazione a partire da classi PHP che descrivono risorse, form e tabelle. Il repository filamentphp/filament è distribuito con licenza MIT e conta 31.810 stelle e 4.190 fork, con l'ultimo push all'11 agosto 2026. Non è un pacchetto unico ma un insieme: filament/tables, filament/schemas, filament/forms, filament/infolists, filament/actions, filament/notifications, filament/widgets e filament/support si possono installare anche singolarmente dentro un'applicazione Laravel esistente, senza per forza adottare il pannello completo.

Una risorsa descrive il modello, le colonne della tabella, i campi del form e le azioni, e da lì escono la lista con ricerca e ordinamento, le pagine di creazione e modifica, i filtri e le notifiche. La validazione resta quella del framework, quindi le regole che useresti in una Form Request di Laravel valgono anche qui, scritte sui componenti invece che in una classe separata.

Filament v4 o v5: quale versione installare?

La differenza sta tutta in Livewire. Guardando i composer.json dei tag pubblicati, la 5.7.6 dichiara livewire/livewire: ^4.1 mentre la 4.12.6 si ferma a ^3.5, e questo vincolo decide da solo quale delle due puoi usare. La versione 4 è uscita il 12 agosto 2025, la 5 il 16 gennaio 2026, e le ultime patch di entrambe portano la data del 5 agosto 2026.

I requisiti restano gli stessi in tutti e due i casi: PHP 8.2 o superiore, Laravel dalla 11.28 in su e Tailwind CSS 4. Il pacchetto filament/support della 5.7.6 accetta illuminate/contracts nelle versioni ^11.28|^12.0|^13.0, quindi Laravel 13 è supportato senza forzature nel composer. Se stai valutando adesso se legarti a Livewire o restare su React, quella scelta pesa più della versione di Filament, e l'ho affrontata confrontando Inertia con React e Livewire su un'applicazione Laravel.

Cosa è cambiato con la versione 4?

La 4 ha riorganizzato il modo in cui si descrive l'interfaccia e ha lavorato sulle prestazioni delle tabelle. Il team dichiara un tempo di rendering lato server da due a tre volte più basso sulle tabelle grandi, ottenuto sostituendo le inclusioni di file con oggetti PHP e spostando le classi Tailwind fuori dall'HTML generato. La cifra arriva dal progetto stesso e nessuno l'ha verificata dall'esterno, quindi trattala come una direzione di lavoro e misura sulla tua tabella più pesante.

Sul resto, gli schemi diventano la base comune di form, infolist e pagine, le risorse possono essere annidate con breadcrumb e URL coerenti, e ogni pagina si personalizza attraverso il proprio schema con il metodo content(). Sono arrivati l'editor ricco basato su TipTap, lo slider, l'editor di codice e il repeater a tabella, insieme a hiddenJs(), visibleJs() e afterStateUpdatedJs(), che gestiscono lo stato dei campi nel browser ed evitano un giro di rete a ogni interazione. Per le azioni di massa ci sono chunkSelectedRecords(), che lavora a blocchi, e authorizeIndividualRecords(), che applica la policy record per record. La versione 5 è nata per stare al passo con Livewire 4 e non ha riscritto l'API.

Come si installa Filament su un progetto Laravel?

Bastano due comandi, più uno per creare il primo utente. Su un progetto nuovo si parte da composer require filament/filament:"^5.0", poi php artisan filament:install --panels, che genera app/Providers/Filament/AdminPanelProvider.php, e infine php artisan make:filament-user per l'accesso, con il pannello che risponde su /admin. Chi lancia i comandi da PowerShell su Windows deve scrivere il vincolo come "~5.0", perché il carattere ^ viene ignorato dalla shell.

L'autenticazione a due fattori non richiede pacchetti aggiuntivi, dato che filament/panels dipende già da pragmarx/google2fa e dal generatore di QR code. Sul lato infrastruttura il pannello non cambia niente, quindi restano valide le scelte di un deploy Laravel con Docker Compose.

Quanto costa Filament PHP?

Il framework è gratuito e resta MIT, mentre una parte dell'ecosistema è a pagamento. La pagina ufficiale dei plugin ne elenca 967 e avverte che la maggior parte è di terze parti, con l'invito esplicito a installarli a proprio rischio. Tra quelli in evidenza a pagamento compaiono Blueprint a 49 dollari, Custom Dashboards a 89 dollari, Data Lens a 99 dollari, Flex Forms a 99,99 dollari e Advanced Tables a 79 euro. Riporto le cifre nella valuta in cui sono pubblicate, perché convertirle darebbe un numero inventato.

Filament aiuta o intralcia un agente AI?

Aiuta, e in modo più concreto di quanto facciano quasi tutti i pacchetti Laravel. La documentazione è esposta in formato leggibile dai modelli su filamentphp.com/docs/llms.txt, e le linee guida per gli agenti arrivano attraverso Laravel Boost, che si installa con composer require laravel/boost --dev seguito da php artisan boost:install. Sopra c'è Blueprint, l'estensione a pagamento che produce documenti di specifica su modelli, risorse, form, tabelle, autorizzazioni e test, pensati per essere dati in pasto all'agente che scrive il codice. Si scarica da un repository Composer privato con email e chiave di licenza, quindi ha senso solo su progetti dove il pannello è grosso e cresce ogni settimana.

Quando conviene lasciar perdere Filament?

Quando l'interfaccia da costruire è pubblica e su misura, oppure quando l'area riservata si esaurisce in due CRUD. Nel primo caso ti ritrovi a combattere contro convenzioni pensate per un pannello interno, nel secondo il tempo speso a imparare le classi supera quello di due controller scritti a mano. Filament poi vive dentro Livewire, quindi ogni aggiornamento maggiore di Livewire diventa un aggiornamento maggiore anche per te, ed è esattamente il motivo per cui oggi la 4 e la 5 esistono insieme. Se il team non conosce Livewire e non ha intenzione di impararlo, il pannello generato diventa un pezzo di applicazione che nessuno vuole toccare.

Domande frequenti

Filament PHP è gratis?

Sì, il framework è pubblicato con licenza MIT e si installa via Composer senza costi. A pagamento sono alcuni plugin ufficiali e di terze parti, con prezzi che sulla pagina dei plugin vanno da 49 a 99,99 dollari, oltre a un plugin in evidenza a 79 euro.

Filament PHP funziona con Laravel 13?

Sì. Il pacchetto filament/support della versione 5.7.6 dichiara illuminate/contracts compatibile con ^11.28|^12.0|^13.0, quindi copre Laravel 11.28, 12 e 13.

Posso usare le tabelle di Filament senza il pannello?

Sì, i pacchetti sono separati e filament/tables, filament/forms e gli altri si installano da soli dentro un'applicazione Laravel esistente, purché ci sia Livewire nella versione richiesta dalla linea che scegli.

Devo aggiornare subito dalla versione 4 alla 5?

No, a meno che tu non voglia passare a Livewire 4. Le due linee ricevono patch in parallelo, l'ultima per entrambe è del 5 agosto 2026, e la guida di aggiornamento mette a disposizione uno script automatico quando deciderai di muoverti.

Da dove partire

Se il progetto è nuovo e nasce su Livewire 4, installa la versione 5 e costruisci una sola risorsa completa prima di aggiungerne altre, così capisci subito quanta della tua logica sta comoda dentro gli schemi. Se invece hai un'applicazione già in produzione su Livewire 3, resta sulla 4 e aggiorna quando Livewire ti obbligherà a farlo, senza sommare due migrazioni nello stesso rilascio.