PHP Handbuch
Zurück |  | Weiter

# http_build_query

(PHP 5)

http_build_query -- Erstellen eines URL-kodierten Query-Strings

## Description

string http_build_query ( array formdata [, string numeric_prefix [, string arg_separator]] )

Erstellt einen URL-kodierten Query-String aus einem gegebenen assoziativem (oder indexiertem) Array. `formdata` kann ein Array oder ein Objekt sein, das Eigenschaften enthält. Ein `formdata`-Array kann eine einfache eindimensionale Struktur haben, oder ein Array aus Arrays sein (die wiederum weitere Arrays enthalten können). 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.

> Anmerkung: arg_separator.output wird verwendet, um die Argumente voneinander zu trennen, es sei denn, dass `arg_separator` angegeben ist. In diesem Falle wird letzteres verwendet.

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, '', '&amp;'); // foo=bar&amp;baz=boom&amp;cow=milch&amp;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); /* Ausgabe: 0=foo&1=bar&2=baz&3=boom&kuh=milch&php=hypertext+processor */ echo http_build_query($data, 'meineVariable_'); /* Ausgabe: (fuer bessere Lesbarkeit umgebrochen!) meineVariable_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
Anmerkung: 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 ?>`

> Anmerkung: Der Parameter `arg_separator` wurde mit PHP 5.1.2 hinzugefügt.

Siehe auch parse_str(), parse_url(), urlencode() und array_walk()

Zurück | Zum Anfang | Weiter
get_meta_tags | Nach oben | parse_url