Se sviluppi software per il mercato italiano, prima o poi scrivi una factory così:
'codice_fiscale' => fake('it_IT')->taxId(),
'iban' => fake('it_IT')->iban('IT'),
E poi aggiungi una validazione seria al form, come è giusto che sia. A quel punto i test iniziano a fallire. Non sempre: quasi sempre.
Ho misurato quanto spesso, generando 10.000 valori con il provider it_IT di Faker e controllandoli con un validatore completo:
| Valore | Validi |
|---|---|
Codice fiscale (taxId()) |
1,1% |
IBAN italiano (iban('IT')) |
3,6% |
Partita IVA (vat()) |
84,3% |
Vediamo perché.
Il codice fiscale non è una stringa casuale
Faker genera il codice fiscale con un semplice schema di lettere e cifre:
// Faker\Provider\it_IT\Person
public static function taxId()
{
return strtoupper(static::bothify('??????##?##?###?'));
}
Il risultato ha la forma giusta, ma il contenuto no. Alcuni esempi reali:
TUROAS92L62Z558R → carattere di controllo sbagliato
GNCYKS46A60N219M → carattere di controllo sbagliato
WFRJKY67I92H299I → "I" non è un mese valido, e il giorno 92 non esiste
Un codice fiscale vero ha una struttura precisa:
| Caratteri | Significato |
|---|---|
| 1–3 | consonanti (e vocali) del cognome |
| 4–6 | consonanti (e vocali) del nome |
| 7–8 | anno di nascita |
| 9 | mese, con una lettera tra ABCDEHLMPRST
|
| 10–11 | giorno di nascita, +40 per le donne |
| 12–15 | codice catastale del comune o dello stato estero (es. H501 Roma) |
| 16 | carattere di controllo |
L'ultimo carattere si calcola dai primi 15 con una tabella di valori per le posizioni dispari e una per le pari, poi il resto della divisione per 26. Una stringa casuale lo indovina una volta su 26, e deve anche avere un mese e un giorno validi: da qui l'1,1%.
L'IBAN italiano ha un controllo in più
Per un IBAN qualsiasi basta il controllo internazionale (modulo 97) sulle due cifre dopo IT, e Faker lo calcola correttamente. Ma gli IBAN italiani hanno anche il CIN: la lettera subito dopo le cifre di controllo, calcolata da ABI, CAB e numero di conto con lo stesso algoritmo del codice fiscale.
IT96 C376 4097 024Y 249W 526M 7NJ
^
CIN casuale: dovrebbe essere X
Faker mette una lettera a caso, quindi indovina circa una volta su 26. I validatori "solo modulo 97" lo accettano, quelli italiani (molti gestionali e i moduli delle banche) no.
La partita IVA quasi ci arriva
Per la partita IVA Faker calcola la cifra di controllo (un algoritmo simile a Luhn), ma sceglie il codice ufficio, le cifre 8–10, tra 001 e 121. I codici validi sono 001–100, più 120, 121, 888 e 999: le partite IVA con un ufficio tra 101 e 119 non esistono. Da qui l'84%.
La soluzione: faker-italia
Ho raccolto gli algoritmi corretti in un pacchetto open source, faker-italia:
composer require --dev generatore-dati/faker-italia
use GeneratoreDati\FakerItalia\FakerProvider;
$faker = Faker\Factory::create('it_IT');
$faker->addProvider(new FakerProvider($faker));
$faker->codiceFiscale(); // "GRCCHR58E68L219K"
$faker->codiceFiscale('F', '1990-05-12', 'F205'); // donna, nata a Milano il 12/05/1990
$faker->partitaIva(); // "10446710534"
$faker->ibanItaliano(); // "IT31E5666885391743795602475"
E se ti servono dati coerenti tra loro, per esempio per un'anagrafica:
$faker->personaItaliana();
// [
// 'nome' => 'Chiara', 'cognome' => 'Greco', 'sesso' => 'F',
// 'data_nascita' => '1958-05-28', 'luogo_nascita' => 'Torino',
// 'codice_catastale' => 'L219', 'codice_fiscale' => 'GRCCHR58E68L219K',
// ]
Con Laravel
Il provider si registra da solo, quindi funziona subito nelle factory:
public function definition(): array
{
$persona = fake()->personaItaliana();
return [
'nome' => $persona['nome'],
'cognome' => $persona['cognome'],
'codice_fiscale' => $persona['codice_fiscale'],
'partita_iva' => fake()->partitaIva(),
'iban' => fake()->ibanItaliano(),
];
}
E include le regole di validazione per i form:
use GeneratoreDati\FakerItalia\Laravel\Rules\CodiceFiscale;
use GeneratoreDati\FakerItalia\Laravel\Rules\Iban;
use GeneratoreDati\FakerItalia\Laravel\Rules\PartitaIva;
$request->validate([
'codice_fiscale' => ['required', new CodiceFiscale],
'partita_iva' => ['nullable', new PartitaIva],
'iban' => ['required', new Iban(onlyItalian: true)],
]);
Le regole gestiscono anche l'omocodia (i codici fiscali in cui alcune cifre sono sostituite da lettere) e il prefisso IT della partita IVA.
Senza scrivere codice
Se ti serve solo un file di dati al volo (per un import, una demo o un database di staging), gli stessi algoritmi sono disponibili gratis anche online su generatore-dati.it.
Tutto avviene nel browser: i dati inseriti non vengono inviati a nessun server.
In sintesi
-
taxId()di Faker genera stringhe con la forma di un codice fiscale, ma valide solo nell'1% dei casi. - Gli IBAN italiani di Faker superano il controllo internazionale ma quasi mai quello del CIN.
- Se la tua applicazione valida questi campi, usa dati generati con gli algoritmi veri: i test smettono di fallire a caso.
Il pacchetto è MIT: suggerimenti, issue e pull request sono benvenuti su GitHub.
Top comments (0)