Codice fiscale pour Laravel

Présentation

La version 3.0 est une réécriture complète : un noyau de domaine indépendant de Laravel, avec objets valeur immuables et services dédiés, plus une couche Laravel comprenant une règle de validation, un cast Eloquent, un fournisseur Faker et une commande artisan. Le noyau gère la génération, l’analyse, la validation, la comparaison avec une personne et l’omocodia. Les messages d’erreur sont traduits, en anglais et en italien.

Les données des lieux de naissance (communes italiennes et pays étrangers) ne sont pas incluses dans le paquet : chaque installation les télécharge avec la commande codice-fiscale:update-places. Tant qu’elle n’a pas été lancée, la validation sémantique et la recherche de lieu de naissance renvoient « inconnu ».

Points forts

• Règle de validation « codice_fiscale » (format, contrôle, sémantique) et règle fluide CodiceFiscaleRule::make()->matching() pour recouper avec nom, date, lieu et sexe saisis.
• Génération et analyse d’un codice fiscale (Generator, Parser), avec normalisation automatique des accents, apostrophes et espaces dans les noms.
• Gestion de l’omocodia : forme canonique, niveau et les 128 variantes possibles d’un même code.
• Cast Eloquent, fournisseur Faker et messages d’erreur traduits, en anglais et en italien.
• Comparaison avec une personne à trois états : concordant, discordant ou ignoré, jamais un champ absent compté comme valide.

Pour qui

Pour les équipes qui développent en PHP avec Laravel et doivent valider, générer ou analyser le codice fiscale dans des formulaires ou des modèles Eloquent. Le noyau peut aussi servir hors de Laravel.

Installation

Installation avec Composer ; le service provider est découvert automatiquement. Il faut ensuite lancer une fois la commande artisan qui télécharge les données de lieux de naissance, et la relancer pour les actualiser. Une configuration publiable est disponible.

composer require robertogallea/laravel-codicefiscale:^3.0

php artisan codice-fiscale:update-places

Lire le README sur GitHub

Points d’attention

• Prérequis : PHP ^8.2 et Laravel ^12.0 ou ^13.0.
• Les données de lieux de naissance ne sont pas fournies avec le paquet et doivent être téléchargées avec update-places ; sans cela, la validation sémantique renvoie « inconnu ».
• La version 3.0 rompt volontairement avec la 2.x, sans couche de compatibilité ; le fichier UPGRADE.md donne la table de migration.

Utilisable par un agent ?

AGENTS.md et CLAUDE.md sont des consignes pour les agents qui contribuent au code du dépôt. Aucun SKILL.md ni serveur MCP trouvé : c’est une bibliothèque PHP, pas un outil pour agent.