WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

http_build_query()

Erzeugt eine Abfrage aus einem Array oder öffentlichen Objekteigenschaften.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

http_build_query(array|object $data, string $numeric_prefix = "", ?string $arg_separator = null, int $encoding_type = PHP_QUERY_RFC1738): string

Erzeugt eine Abfrage aus einem Array oder öffentlichen Objekteigenschaften. Verschachtelte Schlüssel verwenden Klammern, null entfällt und der Zahlenpräfix gilt auf oberster Ebene. RFC 1738 nutzt Plus für Leerzeichen, RFC 3986 nutzt %20. Ein expliziter Trenner macht die Ausgabe konfigurationsunabhängig.

Signatur

http_build_query(array|object $data, string $numeric_prefix = "", ?string $arg_separator = null, int $encoding_type = PHP_QUERY_RFC1738): string

Ausgabe des Beispiels

n0=a+b&tag%5B0%5D=x%2By
n0=a%20b&tag%5B0%5D=x%2By

Beispiele

<?php
$data = [0=>"a b","tag"=>["x+y"],"empty"=>null];
echo http_build_query($data,"n","&",PHP_QUERY_RFC1738),PHP_EOL;
echo http_build_query($data,"n","&",PHP_QUERY_RFC3986);

Ergebnis

n0=a+b&tag%5B0%5D=x%2By
n0=a%20b&tag%5B0%5D=x%2By

Quellen