(PHP 4, PHP 5, PHP 7, PHP 8)
parse_str — Converte a string em variáveis
Interpreta string como se ela fosse uma query string passada via URL e cria variáveis no escopo atual ou no array se informado em result.
stringThe input string.
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 Using parse_str()
<?php
$str = "first=value&arr[]=foo+bar&arr[]=baz";
// Recommended
parse_str($str, $output);
echo $output['first']; // value
echo $output['arr'][0]; // foo bar
echo $output['arr'][1]; // baz
// DISCOURAGED
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 underlines. O mesmo se aplica aos nomes de chaves de array no caso de utilizar esta função com o parâmetro result.
Exemplo #2 Name mangling 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:
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
QUERY_STRINGem si, vocẽ pode utilizar a variável $_SERVER['QUERY_STRING']. Além disso, leia a seção sobre variáveis de fontes externas.