Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

http_build_query

URL-Funktionen

    Befehl:
string http_build_query ( array $formdata [, string $numeric_prefix [, string $arg_separator ]] )


    Parameter-Liste:
NameBeschreibung
formdataKann 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_prefixWenn 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_separatorarg_separator.output wird verwendet, um die Argumente voneinander zu trennen, es sei denn, dass der Parameter angegeben ist. In diesem Falle wird letzteres verwendet.

    Beschreibung:
Erstellt einen URL-kodierten Query-String aus einem gegebenen assoziativen (oder indexierten) Array.


    Aktiv in Version:
(PHP 5, PHP 7)

    Siehe auch:
Überträgt einen String in Variable
 
Analysiert einen URL und gibt seine Bestandteile zurück
 
URL-kodiert einen String
 
Wendet eine Benutzerfunktion auf jedem Element eines Arrays an
 

http_build_query() - Beispiel:


Eingabe:
<?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

?>


Beschreibung:
Mit http_build_query() kann man sich anhand eines Objekts oder assoziativen Arrays (formdate) eine kodierte URL erstellen lassen. Gibt man den optionalen Parameter numeric_prefix an, so wird jedem nicht explizit zugewiesenen Wert ein Prefix vorangestellt.

Beschreibung:
Version Beschreibung
5.1.2 arg_separator-Parameter hinzugefügt.
5.1.3 Eckige Klammern werden maskiert.
http_build_query() - Beispiel 2: mit numerischen Index-Elementen.


Eingabe:
<?php
$data = array('foo', 'bar', 'baz', 'boom', 'kuh' => 'milch', 'php' =>'hypertext processor');

echo http_build_query($data) . "\n";
echo http_build_query($data, 'meineVariable_');
?>


Ausgabe:
0=foo&1=bar&2=baz&3=boom&kuh=milch&php=hypertext+processor
meineVariable_0=foo&meineVariable_1=bar&meineVariable_2=baz&meineVariable_3=boom&kuh=milch&php=hypertext+processor

Beschreibung:
Mit http_build_query() kann man sich anhand eines Objekts oder assoziativen Arrays (formdate) eine kodierte URL erstellen lassen. Gibt man den optionalen Parameter numeric_prefix an, so wird jedem nicht explizit zugewiesenen Wert ein Prefix vorangestellt.

Beschreibung:
Version Beschreibung
5.1.2 arg_separator-Parameter hinzugefügt.
5.1.3 Eckige Klammern werden maskiert.
http_build_query() - Beispiel 3: mit verschachtelten Arrays


Eingabe:
<?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:
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

Beschreibung:
Mit http_build_query() kann man sich anhand eines Objekts oder assoziativen Arrays (formdate) eine kodierte URL erstellen lassen. Gibt man den optionalen Parameter numeric_prefix an, so wird jedem nicht explizit zugewiesenen Wert ein Prefix vorangestellt.

Beschreibung:
Version Beschreibung
5.1.2 arg_separator-Parameter hinzugefügt.
5.1.3 Eckige Klammern werden maskiert.
http_build_query() - Beispiel 4: mit einem Objekt


Eingabe:
<?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

?>


Beschreibung:
Mit http_build_query() kann man sich anhand eines Objekts oder assoziativen Arrays (formdate) eine kodierte URL erstellen lassen. Gibt man den optionalen Parameter numeric_prefix an, so wird jedem nicht explizit zugewiesenen Wert ein Prefix vorangestellt.

Beschreibung:
Version Beschreibung
5.1.2 arg_separator-Parameter hinzugefügt.
5.1.3 Eckige Klammern werden maskiert.
URL-Funktionen