imported>Hutch: Abschnittlink korrigiert, Kleinkram

2026-02-21T07:15:30Z

Abschnittlink korrigiert, Kleinkram

Neue Seite

Die '''[[Abfragesprache|Query]]-Komponente''', häufig auch '''Query-String''' ([[Englische Sprache|englisch]] für ''Abfrage-[[Zeichenkette]]''), ist Teil eines [[Uniform Resource Locator]]s (URL) im [[World Wide Web]] und in <nowiki>RFC 3986</nowiki> spezifiziert.<ref name="RFC-3986" /> Die Query-Komponente enthält Daten, häufig in Form von benannten [[Parameter (Informatik)|Parametern]], die an einen [[Webserver]] gesendet und vom nachgeschalteten Server-Teil einer [[Webanwendung]] ausgewertet werden können.

== Aufbau ==

Ein Query-String wird mit einem [[Fragezeichen]] (<code>?</code>) eingeleitet und endet mit einem [[Rautezeichen]] (<code>#</code>) oder dem Ende des URLs. Er besteht oft aus einem oder mehreren Parametern, häufig in Form von Schlüssel-Wert-Paaren, die oft mit einem [[Et-Zeichen]] (<code>&</code>) voneinander getrennt werden. Parametername und -wert werden durch ein [[Uniform Resource Locator#Liste erlaubter Zeichen|reserviertes Zeichen]], meist ein [[Gleichheitszeichen]] (<code>=</code>), getrennt. Die genannten Trennzeichen entsprechen der Vorgabe des [[World Wide Web Consortium]]s (W3C) für die Übertragung von [[Webformular|HTML-Formular]]-Daten.<ref name="W3C-Query-Delimiter" />

Der folgende URL enthält den Query-String <code>stichwort=wiki&ausgabe=liste</code>:

<code><nowiki>http://www.example.org/suche?stichwort=wiki&ausgabe=liste</nowiki></code>

Dabei ist dem Parameter <code>stichwort</code> der Wert <code>wiki</code> und dem Parameter <code>ausgabe</code> der Wert <code>liste</code> zugeordnet.

== Beispiel ==

Ein Webformular ist folgendermaßen implementiert:
{{#tag:syntaxhighlight
|<form action="suche.php" method="get">
<label for="stichwort">Suche nach</label>
<input type="text" name="stichwort" id="stichwort" />
<input type="hidden" name="suchdatum" value="{{#time:Y-m-d}}" />
<input type="submit" value="Suche starten" />
</form>
|lang=html}}

Zu beachten ist dabei das verborgene (<code>type="hidden"</code>) Feld <code>suchdatum</code>. Es ist im Browser nicht sichtbar, wird beim Absenden des Formulars aber dennoch Teil des Query-Strings. Die Submit-Schaltfläche wird hingegen nicht in den Query-String aufgenommen, da für diese keine Bezeichnung (<code>name</code>) vergeben wurde. Gibt der Benutzer in das Textfeld das Stichwort „wiki“ ein und sendet das Formular ab, wird beispielsweise folgender URL mit dem entsprechenden Query-String <code style="white-space:nowrap">stichwort=wiki&suchdatum={{#time:Y-m-d}}</code> generiert:

<code><nowiki>http://<server>/suche.php?stichwort=wiki&suchdatum=</nowiki>{{#time:Y-m-d}}</code>

=== Auswertung (in PHP) ===

In [[PHP]] lässt sich der Query-String abfragen. Dabei ist der Inhalt des Query-Strings als [[Feld (Datentyp)|Array]] verfügbar.

<syntaxhighlight lang="php">
echo $_GET['stichwort'];
</syntaxhighlight>

gibt beispielsweise den Text aus, der in das Suchfeld eingetragen wurde.

<syntaxhighlight lang="php">
print_r($_GET);
</syntaxhighlight>

ergibt mit dem Beispiel von oben

{{#tag:pre
|Array
(
[stichwort] => wiki
[suchdatum] => {{#time:Y-m-d}}
)}}

== Nachteile und Probleme ==

=== Kodierung ===

{{Hauptartikel|URL-Encoding}}
Einige Zeichen dürfen nicht in einem Query-String auftreten, da diese ansonsten fehlerhaft interpretiert werden können. Wird das Gleichheitszeichen beispielsweise innerhalb eines Wertes benutzt, wird dieses fälschlicherweise als Schlüssel-Wert-Trennzeichen erkannt. Beim Generieren des Query-Strings müssen diese Zeichen speziell codiert werden – beispielsweise müsste ein Leerzeichen in ein Pluszeichen (<code>+</code>) umgewandelt werden.

==== Trennzeichen für Parameter ====

Das [[Et-Zeichen]] (<code>&</code>) als Trennzeichen von Schlüssel-Wert-Paaren ist innerhalb von HTML-Dokumenten problematisch, da dieses Zeichen laut dem [[World Wide Web Consortium]] (W3C) speziell kodiert sein muss. Das W3C empfiehlt daher eine Trennung der Paare durch ein [[Semikolon]] (<code>;</code>).<ref>[http://www.w3.org/TR/1999/REC-html401-19991224/appendix/notes.html#h-B.2.2 W3C-Empfehlung für das Trennen der Key-Value-Pairs]</ref>

=== Sicherheitsrisiken ===

Da der Query-String Teil des URLs ist, ist er für jeden Internetnutzer im [[Webbrowser|Browser]] einseh- und auch modifizierbar. In einer Webanwendung sollten demnach nur unkritische Parameter in den Query-String eingefügt werden, etwa die Eingabe in einem Suchfeld.

=== Technische Beschränkungen ===

Muss eine größere Menge von Daten übergeben werden, empfiehlt es sich diese nicht über den URL, sondern im [[Hypertext Transfer Protocol#Aufbau|Message Body]] mittels der HTTP-Methode [[Hypertext Transfer Protocol#HTTP-POST|POST]] zu übermitteln, da für URLs einige Beschränkungen gelten:

* Die HTTP-Spezifikation empfiehlt aus Kompatibilitätsgründen eine Maximalgröße von 255 [[Byte]]s für [[Uniform Resource Locator|URLs]] bzw. [[Uniform Resource Identifier|URIs]].<ref>{{RFC-Internet |RFC=2616 |Titel=HTTP/1.1 |Datum= |Abschnitt=3}}</ref>
* Der [[Internet Explorer]] unterstützt keine URLs, die aus mehr als 2083 Zeichen bestehen.<ref>[http://support.microsoft.com/kb/208427 support.microsoft.com]</ref>
* [[Webserver]] können die Maximallänge eines Query-Strings selbst begrenzen. Bei einer Überschreitung dieser Grenze sendet der Server den [[HTTP-Statuscode#4xx – Client-Fehler|HTTP-Statuscode 414]] an den Client zurück.
* Die (mittlerweile veraltete) [[Hypertext Markup Language|HTML]]-3-Spezifikation schreibt eine Maximallänge von Linkzielen von 1024 Zeichen vor.<ref>[http://www.w3.org/TR/html4/intro/sgmltut.html#h-3.2.2 HTML 3-Spezifikation]</ref> Diese Beschränkung ist seit HTML 4 nicht mehr vorhanden.

== Siehe auch ==

* [[Clean URL]]

== Einzelnachweise ==

<references>
<ref name="RFC-3986">
{{RFC-Internet |Autor=[[Tim Berners-Lee|T. Berners-Lee]], R. Fielding, L. Masinter |RFC=3986 |Titel=Uniform Resource Identifier (URI): Generic Syntax |Datum=2005-01 |Abschnitt=3.4 |Abschnittstitel=Query |Standard=66 |Updated=6874 |Obsoletes=2732 |Errata=1}}
</ref>
<ref name="W3C-Query-Delimiter">
{{Internetquelle
|url=https://www.w3.org/TR/REC-html40/interact/forms.html#form-content-type
|titel=17 Forms
|titelerg=17.13.4 Form content types
|werk=HTML 4.01 Specification
|hrsg=[[World Wide Web Consortium]] (W3C)
|datum=2018-03-27
|sprache=en
|abruf=2019-11-27}}
</ref>
</references>

[[Kategorie:HTTP]]

Query-String - Versionsgeschichte

imported>Hutch: Abschnittlink korrigiert, Kleinkram