PHP Dokumentation: Function http-build-query
12. Januar 2010 von werner
http_build_query
(PHP 5)
http_build_query — Erstellen eines URL-kodierten Query-Strings
Beschreibung
Erstellt einen URL-kodierten Query-String aus einem gegebenen assoziativen (oder indexierten) Array.
Parameter-Liste
- formdata
Kann ein Array oder ein Objekt sein, das Eigenschaften enthält.
Das Array kann eine einfache eindimensionale Struktur haben, oder ein Array aus Arrays sein (die wiederum weitere Arrays enthalten können).
- numeric_prefix
Wenn numerische Indizes im äußeren Array verwendet werden und ein numeric_prefix angegeben wurde, wird dieser nur den numerischen Schlüsseln im äußeren Array vorangestellt.
Dieser Weg wurde gewählt, um gültige Variablennamen zu erhalten, wenn die Daten später von PHP oder einer anderen CGI-Applikation dekodiert werden.
- arg_separator
arg_separator.output wird verwendet, um die Argumente voneinander zu trennen, es sei denn, dass der Parameter angegeben ist. In diesem Falle wird letzteres verwendet.
Rückgabewerte
Gibt einen URL-kodierten String zurück.
Changelog
| Version | Beschreibung |
|---|---|
| 5.1.2 | arg_separator-Parameter hinzugefügt. |
| 5.1.3 | Eckige Klammern werden maskiert. |
Beispiele
Beispiel #1 Einfache Verwendung von http_build_query()
<?php
$data = array('foo'=>'bar',
'baz'=>'boom',
'cow'=>'milch',
'php'=>'hypertext processor');echo
http_build_query($data); // foo=bar&baz=boom&cow=milch&php=hypertext+processor
echo http_build_query($data, '', '&'); // foo=bar&baz=boom&cow=milch&php=hypertext+processor
?>Beispiel #2 http_build_query() mit numerischen Index-Elementen.
<?php
$data = array('foo', 'bar', 'baz', 'boom', 'kuh' => 'milch', 'php' =>'hypertext processor');echo
http_build_query($data) . "\n";
echo http_build_query($data, 'meineVariable_');
?>Das oben gezeigte Beispiel erzeugt folgendeAusgabe:
0=foo&1=bar&2=baz&3=boom&kuh=milch&php=hypertext+processormeineVariable_0=foo&meineVariable_1=bar&meineVariable_2=baz&meineVariable_3=boom&kuh=milch&php=hypertext+processor
Beispiel #3 http_build_query() mit verschachtelten Arrays
<?php
$data = array('user'=>array('name'=>'Bob Smith',
'alter'=>47,
'geschlecht'=>'M',
'geb'=>'5/12/1956'),
'hobbies'=>array('golf', 'opera', 'poker', 'rap'),
'kinder'=>array('bobby'=>array('alter'=>12,
'geschlecht'=>'M'),
'sally'=>array('alter'=>8,
'geschlecht'=>'F')),
'CEO');echo
http_build_query($data, 'flags_');
?>Ausgabe: (für bessere Lesbarkeit umgebrochen!)
user[name]=Bob+Smith&user[alter]=47&user[geschlecht]=M&user[geb]=5%2F12%2F1956&hobbies[0]=golf&hobbies[1]=opera&hobbies[2]=poker&hobbies[3]=rap&kinder[bobby][alter]=12&kinder[bobby][geschlecht]=M&kinder[sally][alter]=8&kinder[sally][geschlecht]=F&flags_0=CEO
Hinweis: Nur das numerische Indexelement im äußeren Array "CEO" erhält ein Prefix. Die anderen numerischen Indizes unterhalb von hobbies benötigen kein String-Prefix, um einen gültigen Variablennamen darzustellen.
Beispiel #4 Verwendung von http_build_query() mit einem Objekt
<?php
class meineKlasse {
var $foo;
var $baz; function
meineKlasse() {
$this->foo = 'bar';
$this->baz = 'boom';
}
}$data = new meineKlasse();echo
http_build_query($data); // foo=bar&baz=boom?>Siehe auch
- parse_str() – Überträgt einen String in Variable
- parse_url() – Analysiert einen URL und gibt seine Bestandteile zurück
- urlencode() – URL-kodiert einen String
- array_walk() – Wendet eine Benutzerfunktion auf jedem Element eines Arrays an
Loading ...