Codice fiscale per Laravel

Presentazione

La versione 3.0 è una riscrittura completa: un nucleo di dominio indipendente da Laravel, con value object immutabili e servizi dedicati, più uno strato Laravel che comprende una regola di validazione, un cast Eloquent, un provider Faker e un comando artisan. Il nucleo gestisce generazione, analisi, validazione, confronto con una persona e omocodia. I messaggi d’errore sono tradotti, in inglese e in italiano.

I dati dei luoghi di nascita (comuni italiani e stati esteri) non sono inclusi nel pacchetto: ogni installazione li scarica con il comando codice-fiscale:update-places. Finché non viene eseguito, la validazione semantica e la ricerca del luogo di nascita restituiscono «sconosciuto».

Punti di forza

• Regola di validazione «codice_fiscale» (formato, controllo, semantica) e regola fluente CodiceFiscaleRule::make()->matching() per confrontare con nome, data, luogo e sesso inseriti.
• Generazione e analisi di un codice fiscale (Generator, Parser), con normalizzazione automatica di accenti, apostrofi e spazi nei nomi.
• Gestione dell’omocodia: forma canonica, livello e le 128 varianti possibili di uno stesso codice.
• Cast Eloquent, provider Faker e messaggi d’errore tradotti, in inglese e in italiano.
• Confronto con una persona a tre stati: corrispondente, non corrispondente o saltato, senza mai contare come valido un campo assente.

Per chi

Per i team che sviluppano in PHP con Laravel e devono validare, generare o analizzare il codice fiscale in form o modelli Eloquent. Il nucleo si può usare anche fuori da Laravel.

Installazione

Installazione con Composer; il service provider viene scoperto in automatico. Poi va eseguito una volta il comando artisan che scarica i dati dei luoghi di nascita, e rieseguito per aggiornarli. È disponibile una configurazione pubblicabile.

composer require robertogallea/laravel-codicefiscale:^3.0

php artisan codice-fiscale:update-places

Leggete il README su GitHub

Punti di attenzione

• Requisiti: PHP ^8.2 e Laravel ^12.0 o ^13.0.
• I dati dei luoghi di nascita non sono forniti con il pacchetto e vanno scaricati con update-places; senza, la validazione semantica restituisce «sconosciuto».
• La versione 3.0 rompe volutamente con la 2.x, senza livelli di compatibilità; il file UPGRADE.md contiene la tabella di migrazione.

Utilizzabile da un agente?

AGENTS.md e CLAUDE.md sono indicazioni per gli agenti che contribuiscono al codice del repository. Nessun SKILL.md né server MCP trovato: è una libreria PHP, non uno strumento per agenti.