URL-Codierer

Der URL-Codierer ist ein kostenloses Tool, das eine Zeichenfolge in die formularcodierte Darstellung umwandelt, die für URL-Abfrageparameter und andere textbasierte Webdaten verwendet wird.

Was ist URL-Codierung und wozu dient sie?

Bei der URL-Codierung werden Zeichen, die in einer URL eine besondere Bedeutung haben, durch ein Prozentzeichen und nachfolgende Hexadezimalziffern ersetzt. So lässt sich Text durch Systeme übertragen, die nur einen eingeschränkten Zeichensatz akzeptieren.

Ein kaufmännisches Und trennt beispielsweise Abfrageparameter. Gehört es stattdessen zu einem Wert, muss es als %26 codiert werden. Auch Leerzeichen benötigen eine besondere Behandlung. Dieses Tool verwendet die PHP-Funktion urlencode, die ein Leerzeichen in ein Pluszeichen umwandelt.

Vorher: tea and cake

Nachher: tea+and+cake

URL-codierter Text begegnet dir unter anderem in:

• Abfragezeichenfolgen, die von Webformularen übermittelt werden;
• Daten-URIs mit Text, der nicht wörtlich darin vorkommen kann;
• Links in E-Mail-Nachrichten;
• URL-Werten, die in JSON-Nutzdaten gespeichert sind;
• Weiterleitungs- und Callback-Parametern von Webanwendungen;
• URLs mit internationalisierten Domains, wobei der Domainname selbst möglicherweise Punycode statt Prozentcodierung benötigt.

URL-Codierung ist keine Verschlüsselung und bietet keine Vertraulichkeit. Jeder, der einen prozentcodierten URL-Wert sehen kann, kann ihn auch decodieren.

Wie verwende ich den URL-Codierer?

Gib die zu codierende Zeichenfolge ein, führe das Tool aus und lies den umgewandelten Wert im Ergebnisfeld URL-kodiert ab. Codiere nur den eigentlichen Wert, nicht die umgebenden Anführungszeichen oder erläuternden Text.

Die Verarbeitung erfolgt auf dem Server. Deine Eingabe wird über HTTPS an den Server übertragen und nicht gespeichert. Trotzdem solltest du keine Passwörter, Sitzungstoken oder privaten personenbezogenen Daten in URLs einfügen, da Webadressen im Browserverlauf, in Analysesystemen und in Serverprotokollen erscheinen können.

Wenn du den Vorgang rückgängig machen möchtest, verwende den URL-Decoder. Ein korrekt decodierter Wert sollte mit dem ursprünglichen Text übereinstimmen, sofern in beide Richtungen dieselbe Zeichencodierung und dieselben Regeln für die Formularcodierung verwendet werden.

Soll ich die gesamte URL oder nur den Parameterwert codieren?

Normalerweise solltest du jeden Parameterwert einzeln codieren, nicht die vollständige URL. Beim Codieren der gesamten Adresse würden auch Strukturzeichen wie Doppelpunkt, Schrägstriche, Fragezeichen und Gleichheitszeichen ersetzt.

Angenommen, der Suchwert lautet green tea & coffee. Seine codierte Form ist green+tea+%26+coffee und kann hinter einem Parameternamen eingefügt werden. Würdest du die vollständige Adresse codieren, wären auch die Trennzeichen unkenntlich, anhand derer ein Browser Schema, Host, Pfad und Abfragezeichenfolge erkennt.

Da dieses Tool urlencode verwendet, eignet es sich gut für Abfrageparameter im Stil von HTML-Formularen. Manche APIs und Pfadsegmente richten sich stattdessen nach RFC 3986. Dort wird ein Leerzeichen als %20 und nicht als + dargestellt. Prüfe, ob das empfangende System eine Formularcodierung mit + oder eine Codierung nach RFC 3986 mit %20 erwartet.

Beispiele für die URL-Codierung

ASCII-Buchstaben und Ziffern bleiben lesbar. Leerzeichen werden zu Pluszeichen, während reservierte Satzzeichen und Nicht-ASCII-Text durch codierte Bytes dargestellt werden.

• hello world wird zu hello+world.
• tea & cake wird zu tea+%26+cake.
• email=test@example.com wird zu email%3Dtest%40example.com.
• 100% ready wird zu 100%25+ready.
• café wird zu caf%C3%A9, wenn der Ausgangstext UTF-8 verwendet.

Akzentbuchstaben und nichtlateinische Schriften werden zunächst mithilfe einer Zeichencodierung als Bytes dargestellt, im Web üblicherweise als UTF-8. Anschließend erhält jedes Byte außerhalb des zulässigen Zeichensatzes eine eigene Prozent-Escapesequenz. Deshalb kann ein einzelnes sichtbares Zeichen mehrere mit % beginnende Gruppen erzeugen.

Zahlen erfordern keine besondere Behandlung. Bei einer leeren Eingabe entstehen keine codierten Inhalte. Sehr lange Eingaben können deutlich anwachsen, da jedes codierte Byte drei Zeichen belegt.

Warum schlägt die URL-Decodierung fehl oder liefert unleserlichen Text?

Eine Decodierung schlägt meist fehl, weil die Eingabe nach anderen Regeln oder mehrfach codiert wurde oder keinen Text im erwarteten Zeichensatz darstellt.

• Unterschiedliche Behandlung von Leerzeichen. Ein Formulardecoder interpretiert + als Leerzeichen, während ein reiner Prozentdecoder es möglicherweise als Pluszeichen beibehält.
• Doppelte Codierung. Das Prozentzeichen in %26 kann selbst zu %25 werden, sodass %2526 entsteht. Nach einem einzigen Decodierungsschritt erhältst du dann %26 statt des ursprünglichen kaufmännischen Und.
• Falsche Zeichencodierung. Werden UTF-8-Bytes als ein anderer Zeichensatz decodiert, können Ersatzzeichen oder verstümmelte Buchstaben entstehen.
• Binärdaten statt Text. Die decodierten Bytes können ein Bild, ein Archiv oder eine andere Datei darstellen. Werden sie als Text angezeigt, entsteht unleserlicher Inhalt.
• Falsches Format oder Alphabet. URL-sicheres Base64, Standard-Base64 und Prozentcodierung sind unterschiedliche Formate. Wenn du einen URL-Decoder auf Base64-Text anwendest, erhältst du nicht den beabsichtigten Wert.

URL-Codierung verwendet keine Auffüllzeichen. Meldet ein Decoder eine fehlende Auffüllung, handelt es sich bei der Eingabe wahrscheinlich um Base64 oder ein anderes Format mit Auffüllung und nicht um prozentcodierten Text.

Häufig gestellte Fragen

Sind Prozent-Escapesequenzen mit Groß- und Kleinbuchstaben gleichbedeutend?

Ja. Bei Hexadezimalbuchstaben in Prozent-Escapesequenzen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Daher stellen %2F und %2f beide einen Schrägstrich dar. Für eine einheitliche Darstellung werden großgeschriebene Hexadezimalziffern empfohlen.

Kann ich einen internationalisierten Domainnamen per URL-Codierung umwandeln?

Nein. Domainlabels, etwa Namen mit é, müssen normalerweise als internationalisierte Domainnamen verarbeitet und in eine mit xn-- beginnende ASCII-Punycode-Form umgewandelt werden. Die Prozentcodierung wird für andere URL-Bestandteile verwendet und ist kein Ersatz für diese Umwandlung.

Was passiert mit Zeilenumbrüchen und Tabulatoren?

Tabulator- und Zeilenumbruchbytes werden prozentcodiert, da sie nicht wörtlich in einem herkömmlichen URL-Wert vorkommen können. Ein Tabulator wird üblicherweise als %09 dargestellt. Bei Zeilenenden hängt die Darstellung davon ab, ob der Ausgangstext LF- oder CRLF-Zeichen verwendet.

Warum funktioniert eine codierte URL nach dem Einfügen in eine Anwendung trotzdem nicht?

Möglicherweise erwartet die Anwendung einen Rohwert und codiert ihn selbst, wodurch eine doppelte Codierung entsteht. Sie kann die URL auch wegen einer Begrenzung der Gesamtlänge ablehnen oder weil ein reserviertes Zeichen in einem strukturellen Teil der Adresse codiert wurde. Prüfe vor dem Codieren, welchen einzelnen Bestandteil die Anwendung verlangt.

Kann ich codierte Abfrageparameter bedenkenlos teilen?

Nein. Die URL-Prozentcodierung ändert lediglich die Darstellung. Browser und Entwicklerwerkzeuge können den ursprünglichen Wert wieder sichtbar machen. Prüfe vor dem Teilen eines Links seine Abfrageparameter auf E-Mail-Adressen, Kontoreferenzen, Zugriffstoken und andere Daten, die nicht offengelegt werden sollten.