Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

http_build_query()

Cria uma consulta a partir de um array ou das propriedades públicas de um objeto.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

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

Cria uma consulta a partir de um array ou das propriedades públicas de um objeto. Chaves aninhadas usam parênteses retos, null é omitido e o prefixo numérico aplica-se ao primeiro nível. O RFC 1738 usa mais para espaços e o RFC 3986 usa %20. Um separador explícito evita depender da configuração.

Assinatura

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

Saída do exemplo

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

Exemplos

<?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);

Resultado

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

Fontes