Codificatore URL

Il Codificatore URL è uno strumento gratuito che converte una stringa nella rappresentazione codificata usata nei parametri di query degli URL e in altri dati web in formato testuale.

Che cos'è la codifica URL e a cosa serve?

La codifica URL sostituisce i caratteri che hanno un significato speciale in un URL con un segno di percentuale seguito da cifre esadecimali. In questo modo, il testo può attraversare sistemi che accettano solo un insieme limitato di caratteri.

Per esempio, la e commerciale separa i parametri di query. Se fa parte di un valore, deve quindi essere codificata come %26. Anche gli spazi richiedono un trattamento specifico. Questo strumento usa la funzione PHP urlencode, che converte gli spazi in segni più.

Prima: tea and cake

Dopo: tea+and+cake

Puoi incontrare testo con codifica URL in:

• stringhe di query inviate tramite moduli web;
• URI di dati contenenti testo che non può essere riportato letteralmente;
• link inclusi nei messaggi email;
• valori URL memorizzati nei payload JSON;
• parametri di reindirizzamento e callback usati dalle applicazioni web;
• URL associati a domini internazionalizzati, anche se il nome di dominio può richiedere Punycode anziché la codifica percentuale.

La codifica URL non è una forma di crittografia e non garantisce alcuna riservatezza. Chiunque possa vedere un valore URL codificato con percentuali può decodificarlo.

Come si usa il Codificatore URL?

Inserisci la stringa da codificare, avvia lo strumento e leggi il valore convertito nel campo del risultato Codificato URL. Codifica solo il valore, senza includere eventuali virgolette o testo esplicativo.

L'elaborazione avviene sul server. I dati inseriti vengono trasmessi al server tramite HTTPS e non vengono memorizzati. Evita comunque di inserire negli URL password, token di sessione o dati personali riservati, perché gli indirizzi web possono comparire nella cronologia del browser, nei sistemi di analisi e nei log dei server.

Per invertire l'operazione, usa il Decodificatore URL. Se vengono applicate la stessa codifica dei caratteri e le stesse regole di codifica dei moduli in entrambe le direzioni, il valore decodificato correttamente deve corrispondere al testo originale.

Devo codificare l'intero URL o solo il valore del parametro?

Di norma devi codificare ogni valore dei parametri, non l'URL completo. Codificando l'intero indirizzo sostituiresti anche caratteri strutturali come i due punti, le barre, il punto interrogativo e il segno di uguale.

Supponiamo che il valore di ricerca sia green tea & coffee. La forma codificata è green+tea+%26+coffee e può essere inserita dopo il nome di un parametro. La codifica dell'indirizzo completo renderebbe irriconoscibili i separatori necessari al browser per individuare schema, host, percorso e stringa di query.

L'uso di urlencode rende questo strumento adatto ai parametri di query nello stile dei moduli HTML. Alcune API e alcuni segmenti di percorso seguono invece le convenzioni RFC 3986, secondo cui uno spazio viene rappresentato come %20 anziché +. Verifica se il sistema destinatario richiede la codifica dei moduli con + oppure la forma %20 prevista da RFC 3986.

Esempi pratici di codifica URL

Le lettere e le cifre ASCII restano leggibili. Gli spazi diventano segni più, mentre la punteggiatura riservata e il testo non ASCII vengono rappresentati tramite byte codificati.

• hello world diventa hello+world.
• tea & cake diventa tea+%26+cake.
• email=test@example.com diventa email%3Dtest%40example.com.
• 100% ready diventa 100%25+ready.
• café diventa caf%C3%A9 quando il testo di origine usa UTF-8.

Le lettere accentate e i sistemi di scrittura non latini vengono prima rappresentati come byte tramite una codifica dei caratteri, in genere UTF-8 sul web. Ogni byte non compreso nell'insieme consentito riceve quindi una propria sequenza percentuale. Un singolo carattere visibile può perciò generare più gruppi che iniziano con %.

I numeri non richiedono alcun trattamento speciale. Un campo vuoto non produce contenuto codificato. I dati inseriti molto lunghi possono aumentare notevolmente di dimensioni, perché ogni byte codificato occupa tre caratteri.

Perché la decodifica URL non funziona o produce testo illeggibile?

La decodifica in genere non riesce perché i dati sono stati codificati secondo regole diverse, sono stati codificati più di una volta oppure non rappresentano testo nel set di caratteri previsto.

• Gestione diversa degli spazi. Un decodificatore per moduli interpreta + come uno spazio, mentre un decodificatore percentuale rigoroso può lasciarlo come segno più.
• Doppia codifica. Il segno di percentuale in %26 può essere a sua volta trasformato in %25, producendo %2526. Una singola decodifica restituisce quindi %26 anziché la e commerciale originale.
• Codifica dei caratteri errata. Se i byte UTF-8 vengono decodificati usando un altro set di caratteri, possono comparire simboli sostitutivi o lettere illeggibili.
• Dati binari anziché testo. I byte decodificati potrebbero costituire un'immagine, un archivio o un altro file. Visualizzarli come testo produce quindi contenuto illeggibile.
• Formato o alfabeto errato. Base64 compatibile con gli URL, Base64 standard e codifica percentuale sono formati diversi. Applicando un decodificatore URL a testo Base64 non si recupera il valore previsto.

La codifica URL non usa caratteri di riempimento. Se un decodificatore segnala un riempimento mancante, probabilmente i dati sono in Base64 o in un altro formato con riempimento, non in testo con codifica percentuale.

Domande frequenti

Le sequenze percentuali maiuscole e minuscole sono equivalenti?

Sì. Le lettere esadecimali nelle sequenze percentuali non distinguono tra maiuscole e minuscole, quindi %2F e %2f rappresentano entrambi una barra. Per mantenere una rappresentazione uniforme, si consiglia di usare cifre esadecimali maiuscole.

La codifica URL può convertire un nome di dominio internazionale?

No. Le etichette di dominio, per esempio un nome contenente é, richiedono normalmente l'elaborazione prevista per i nomi di dominio internazionalizzati e una forma Punycode ASCII che inizia con xn--. La codifica percentuale viene usata per altri componenti dell'URL e non deve essere considerata un'alternativa a questa conversione.

Che cosa succede alle interruzioni di riga e alle tabulazioni?

I byte delle tabulazioni e delle interruzioni di riga vengono codificati con percentuali perché non possono comparire letteralmente in un normale valore URL. Una tabulazione viene comunemente rappresentata come %09, mentre la codifica delle interruzioni di riga dipende dall'uso dei caratteri LF o CRLF nei dati di origine.

Perché un URL codificato non funziona quando lo incollo in un'applicazione?

L'applicazione potrebbe richiedere un valore non elaborato e applicare autonomamente la codifica, causando una doppia codifica. Potrebbe anche rifiutare l'URL perché supera un limite di lunghezza complessivo o perché un carattere riservato è stato codificato in una parte strutturale dell'indirizzo. Prima di effettuare la codifica, verifica quale singolo componente viene richiesto dall'applicazione.

È sicuro condividere i dati codificati di una stringa di query?

No. La codifica URL percentuale modifica soltanto la rappresentazione dei dati, mentre browser e strumenti per sviluppatori possono mostrare il valore originale. Prima di condividere un link, controlla che i parametri di query non contengano indirizzi email, riferimenti ad account, token di accesso o altri dati che non devono essere divulgati.