Rilevatore di versione IP

Un valore valido restituisce la versione rilevata e una rappresentazione canonica stabile, più facile da confrontare, archiviare e controllare. Un testo non valido restituisce un motivo preciso, come un ottetto IPv4 fuori intervallo, uno zero iniziale vietato, troppi gruppi IPv6 o una compressione errata con doppi due punti. Il parser è deterministico, non interroga la rete e applica regole rigorose anziché tentare di intuire il significato di un valore incompleto o corredato da altri elementi.

Identifichi con precisione la sintassi IPv4 e IPv6

IPv4 e IPv6 rappresentano gli indirizzi in forme testuali molto diverse, quindi verificare soltanto la presenza di un punto o dei due punti non basta a convalidare nessuna delle due. Questo rilevatore analizza l’intera stringa secondo le regole strutturali di entrambe le versioni. IPv4 deve contenere esattamente quattro ottetti decimali separati da punti. Ogni ottetto deve essere compreso tra 0 e 255, contenere solo cifre e non iniziare con zero. IPv6 utilizza otto gruppi esadecimali separati da due punti e può abbreviare una sequenza di gruppi zero con doppi due punti. Un indirizzo IPv6 può inoltre terminare con un indirizzo IPv4 decimale incorporato, purché il conteggio complessivo dei gruppi rimanga corretto. Il risultato indica IPv4 o IPv6 soltanto dopo che l’intero valore ha superato la convalida. Un valore che assomiglia semplicemente a un indirizzo viene classificato come nessuno dei due e include un motivo che identifica la regola violata. In questo modo Lei può impiegare il risultato nella convalida di moduli, nei controlli di configurazione, nella pulizia delle importazioni e nei test automatici senza accettare dati errati a causa di una supposizione troppo permissiva.

Usi l’output canonico per confronti e archiviazione

Un indirizzo IP valido può avere più rappresentazioni testuali, soprattutto nel caso di IPv6. Le lettere esadecimali maiuscole e minuscole esprimono gli stessi valori, gli zeri iniziali in un gruppo non cambiano l’indirizzo e una sequenza di gruppi zero può essere compressa. Il risultato IPv6 canonico usa lettere minuscole, elimina gli zeri iniziali superflui e comprime la sequenza più lunga di almeno due gruppi zero. Se più sequenze hanno la stessa lunghezza, viene compressa la prima. I componenti IPv4 decimali incorporati vengono convertiti nei gruppi esadecimali equivalenti, così la risposta mantiene sempre un’unica forma IPv6 coerente. IPv4 viene restituito come quattro normali ottetti decimali. Queste regole permettono di confrontare stringhe canoniche senza scambiare due grafie dello stesso indirizzo per due endpoint distinti. Sono inoltre utili per preparare log, deduplicare configurazioni, creare snapshot di test o presentare un indirizzo alla revisione umana. La canonicalizzazione non esegue DNS, geolocalizzazione, analisi di sottorete o test di raggiungibilità; modifica soltanto la rappresentazione, senza alterare il valore numerico dell’indirizzo.

Interpreti i motivi di rifiuto e i limiti rigorosi

Quando il testo dell’indirizzo non è valido, la risposta lo classifica come nessuna versione e spiega il motivo del rifiuto. Gli errori IPv4 comuni includono un ottetto mancante, un componente superiore a 255, caratteri non decimali o uno zero iniziale che software meno recenti potrebbero interpretare diversamente. Per IPv6 sono frequenti un gruppo più lungo di quattro cifre esadecimali, un numero errato di gruppi espansi, più di una coppia di doppi due punti o una compressione che non sostituisce alcun gruppo. Le parentesi quadre usate negli URL, le lunghezze di prefisso CIDR, i numeri di porta e gli identificatori di zona sono intenzionalmente esclusi dal contratto di input. Rimuova questi elementi e invii soltanto l’indirizzo. Questo limite rigoroso rende la convalida prevedibile tra browser, server e linguaggi i cui parser possono accettare forme storiche differenti. Un indirizzo assente o non espresso come stringa è un errore di contratto; una stringa con sintassi errata è invece un normale risultato accompagnato dal motivo. L’algoritmo non usa rete né stato esterno, quindi richieste ripetute concordano sempre. Ogni richiesta API costa $0.002, mentre la versione nel browser può essere eseguita localmente.