(PHP 4, PHP 5, PHP 7, PHP 8)
parse_str — Converte a string em variáveis
Interpreta string
como se ela fosse uma string de consulta
passada via URL e cria variáveis no escopo atual ou no array se
informado em result
.
string
A string de entrada.
result
Se o segundo parâmetro result
for informado,
as variáveis serão gravadas como elementos de array.
Utilizar esta função sem o parâmetro result
é altamente
DESENCORAJADO e foi DESCONTINUADO a partir do PHP 7.2.
Desde o 8.0.0, o parâmetro result
é obrigatório.
Nenhum valor é retornado.
Versão | Descrição |
---|---|
8.0.0 |
result não é mais opcional.
|
7.2.0 |
Utilização de parse_str() sem o segundo parâmetro
agora emite um aviso de E_DEPRECATED .
|
Exemplo #1 Usando parse_str()
<?php
$str = "first=value&arr[]=foo+bar&arr[]=baz";
// Recomendado
parse_str($str, $output);
echo $output['first']; // value
echo $output['arr'][0]; // foo bar
echo $output['arr'][1]; // baz
// DESENCORAJADO
parse_str($str);
echo $first; // value
echo $arr[0]; // foo bar
echo $arr[1]; // baz
?>
Como variáveis no PHP não podem conter pontos ou espaços em seus nomes,
estes são convertidos em sublinhados. O mesmo se aplica aos nomes de
chaves de array no caso de utilizar esta função com o parâmetro
result
.
Exemplo #2 Confusão de nomes em parse_str()
<?php
parse_str("My Value=Something");
echo $My_Value; // Something
parse_str("My Value=Something", $output);
echo $output['My_Value']; // Something
?>
Nota:
parse_str()() é afetado pela diretiva max_input_vars. Exceder esse limite emite um
E_WARNING
, e quaisquer variáveis além do limite não são adicionadas ao array de resultados. O padrão é 1000; ajuste max_input_vars conforme necessário.
Nota:
Todas as variáveis criadas ou os valores informados no array do segundo parâmetro, já estarão automaticamente convertidos porurldecode().
Nota:
Para obter a string de consulta (
QUERY_STRING
) em si, vocẽ pode utilizar a variável $_SERVER['QUERY_STRING']. Além disso, leia a seção sobre variáveis de fontes externas.