Koder URL

Koder URL to bezpłatne narzędzie, które przekształca tekst do postaci używanej w parametrach zapytań URL oraz innych tekstowych danych internetowych.

Co to jest kodowanie URL i do czego służy?

Kodowanie URL zastępuje znaki mające specjalne znaczenie w adresie URL znakiem procentu i następującymi po nim cyframi szesnastkowymi. Dzięki temu tekst może być przesyłany przez systemy, które obsługują ograniczony zestaw znaków.

Na przykład znak ampersand oddziela parametry zapytania. Jeśli ma być częścią wartości, trzeba go zakodować jako %26. Specjalnego traktowania wymagają również spacje. To narzędzie korzysta z funkcji PHP urlencode, która zamienia spację na znak plus.

Przed: tea and cake

Po: tea+and+cake

Tekst zakodowany w formacie URL możesz spotkać w:

• ciągach zapytań przesyłanych przez formularze internetowe;
• identyfikatorach URI typu data zawierających tekst, którego nie można zapisać dosłownie;
• linkach umieszczanych w wiadomościach e-mail;
• wartościach URL przechowywanych w danych JSON;
• parametrach przekierowań i wywołań zwrotnych używanych przez aplikacje internetowe;
• adresach URL powiązanych z domenami ze znakami narodowymi, chociaż sama nazwa domeny może wymagać formatu Punycode zamiast kodowania procentowego.

Kodowanie URL nie jest szyfrowaniem i nie zapewnia poufności. Każdy, kto widzi wartość URL zakodowaną procentowo, może ją odkodować.

Jak korzystać z Kodera URL?

Wpisz tekst, który chcesz zakodować, uruchom narzędzie i odczytaj przekształconą wartość w polu wyniku Zakodowany URL. Koduj samą wartość, bez otaczających ją cudzysłowów ani tekstu objaśniającego.

Przetwarzanie odbywa się na serwerze. Wprowadzone dane są przesyłane do niego przez HTTPS i nie są przechowywane. Mimo to nie umieszczaj w adresach URL haseł, tokenów sesji ani prywatnych danych osobowych, ponieważ adresy internetowe mogą trafiać do historii przeglądarki, systemów analitycznych i dzienników serwera.

Aby odwrócić tę operację, użyj Dekodera URL. Prawidłowo odkodowana wartość powinna odpowiadać pierwotnemu tekstowi, pod warunkiem że w obu kierunkach zastosowano to samo kodowanie znaków i te same reguły kodowania formularzy.

Kodować cały URL czy tylko wartość parametru?

Zwykle należy kodować osobno wartość każdego parametru, a nie cały adres URL. Zakodowanie pełnego adresu zastąpiłoby również znaki tworzące jego strukturę, takie jak dwukropek, ukośniki, znak zapytania i znak równości.

Załóżmy, że wyszukiwana wartość to green tea & coffee. Jej zakodowana postać to green+tea+%26+coffee i można ją umieścić po nazwie parametru. Zakodowanie całego adresu ukryłoby separatory, których przeglądarka potrzebuje do rozpoznania schematu, hosta, ścieżki i ciągu zapytania.

Funkcja urlencode używana przez to narzędzie dobrze nadaje się do parametrów zapytań w formacie formularzy HTML. Niektóre API i segmenty ścieżek stosują jednak konwencje RFC 3986, w których spację zapisuje się jako %20, a nie +. Sprawdź, czy system odbierający dane oczekuje kodowania formularzy ze znakiem +, czy zapisu %20 zgodnego z RFC 3986.

Przykłady kodowania URL

Litery i cyfry ASCII pozostają czytelne. Spacje zmieniają się w znaki plus, natomiast zarezerwowane znaki interpunkcyjne i tekst spoza ASCII są zapisywane jako zakodowane bajty.

• hello world zmienia się w hello+world.
• tea & cake zmienia się w tea+%26+cake.
• email=test@example.com zmienia się w email%3Dtest%40example.com.
• 100% ready zmienia się w 100%25+ready.
• café zmienia się w caf%C3%A9, jeśli tekst źródłowy używa UTF-8.

Litery ze znakami diakrytycznymi i znaki alfabetów innych niż łaciński są najpierw zamieniane na bajty zgodnie z określonym kodowaniem znaków, zwykle UTF-8 w internecie. Każdy bajt spoza dozwolonego zestawu otrzymuje następnie własną sekwencję procentową. Dlatego jeden widoczny znak może utworzyć kilka grup zaczynających się od %.

Liczby nie wymagają specjalnego przetwarzania. Puste dane wejściowe nie dają żadnej zakodowanej zawartości. Bardzo długie dane mogą znacznie zwiększyć swoją objętość, ponieważ każdy zakodowany bajt zajmuje trzy znaki.

Dlaczego dekodowanie URL nie działa lub daje nieczytelny wynik?

Dekodowanie zwykle kończy się niepowodzeniem, gdy dane zakodowano według innych reguł, zakodowano je więcej niż raz albo nie reprezentują tekstu w oczekiwanym zestawie znaków.

• Inny sposób obsługi spacji. Dekoder formularzy interpretuje + jako spację, natomiast ścisły dekoder procentowy może pozostawić go jako znak plus.
• Podwójne kodowanie. Znak procentu w %26 może zostać ponownie zakodowany jako %25, co daje %2526. Jedno dekodowanie zwróci wtedy %26, a nie pierwotny znak ampersand.
• Nieprawidłowe kodowanie znaków. Bajty UTF-8 odkodowane przy użyciu innego zestawu znaków mogą dać symbole zastępcze lub zniekształcone litery.
• Dane binarne zamiast tekstu. Odkodowane bajty mogą być obrazem, archiwum lub innym plikiem, więc wyświetlenie ich jako tekstu da nieczytelny wynik.
• Niewłaściwy format lub alfabet. Base64 bezpieczny dla adresów URL, standardowy Base64 i kodowanie procentowe to różne formaty. Zastosowanie dekodera URL do tekstu Base64 nie przywróci oczekiwanej wartości.

Kodowanie URL nie używa znaków dopełnienia. Jeśli dekoder zgłasza brak dopełnienia, dane wejściowe są prawdopodobnie zapisane w Base64 albo w innym formacie z dopełnieniem, a nie zakodowane procentowo.

Najczęściej zadawane pytania

Czy wielkość liter w sekwencjach procentowych ma znaczenie?

Nie. Wielkość liter szesnastkowych w sekwencjach procentowych nie ma znaczenia, dlatego zarówno %2F, jak i %2f oznaczają ukośnik. Dla zachowania spójnego zapisu zaleca się używanie wielkich liter szesnastkowych.

Czy kodowanie URL przekształci międzynarodową nazwę domeny?

Nie. Etykiety domen zawierające na przykład é zwykle wymagają przetworzenia zgodnego ze standardem umiędzynarodowionych nazw domen i zastosowania formatu ASCII Punycode zaczynającego się od xn--. Kodowanie procentowe służy do zapisu innych części adresu URL i nie należy traktować go jako zamiennika tej konwersji.

Co dzieje się z podziałami wiersza i tabulatorami?

Tabulatory i bajty podziału wiersza są kodowane procentowo, ponieważ nie mogą występować dosłownie w typowej wartości URL. Tabulator jest zwykle zapisywany jako %09, natomiast sposób kodowania końców wierszy zależy od tego, czy źródło używa znaków LF, czy CRLF.

Dlaczego zakodowany URL nadal nie działa po wklejeniu do aplikacji?

Aplikacja może oczekiwać niezakodowanej wartości i samodzielnie ją kodować, co prowadzi do podwójnego kodowania. Może też odrzucić URL z powodu limitu całkowitej długości albo dlatego, że zarezerwowany znak zakodowano w części strukturalnej adresu. Przed kodowaniem sprawdź, którego konkretnie elementu oczekuje aplikacja.

Czy można bezpiecznie udostępniać zakodowane parametry zapytania?

Nie. Kodowanie procentowe URL zmienia tylko sposób zapisu, a przeglądarki i narzędzia programistyczne mogą ujawnić pierwotną wartość. Zanim udostępnisz link, sprawdź jego parametry zapytania pod kątem adresów e-mail, identyfikatorów kont, tokenów dostępu i innych danych, których nie należy ujawniać.