array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'uk', ), 'this' => array ( 0 => 'function.parse-str.php', 1 => 'parse_str', 2 => 'Parse a string as a URL query string', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'String Функції', ), 'prev' => array ( 0 => 'function.ord.php', 1 => 'ord', ), 'next' => array ( 0 => 'function.print.php', 1 => 'print', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/strings/functions/parse-str.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

parse_str

(PHP 4, PHP 5, PHP 7, PHP 8)

parse_str — Parse a string as a URL query string

Опис

parse_str(string $string, array &$result): void

Parses string as if it were the query string passed via a URL and sets keys in the provided result array. If no result is passed, values are instead set as variables in the current scope.

Параметри

string

The input string.

result

A variable passed by reference, which will be set to an array containing the key-value pairs extracted from string. If the result parameter is not passed, a separate variable is set in the local scope for each key.

Увага

Using this function without the result parameter is highly DISCOURAGED and DEPRECATED as of PHP 7.2. As of PHP 8.0.0, the result parameter is mandatory.

Значення, що повертаються

Не повертає значень.

Журнал змін

Версія Опис
8.0.0 result is no longer optional.
7.2.0 Usage of parse_str() without a second parameter now emits an E_DEPRECATED notice.

Приклади

Приклад #1 Using parse_str()

<?php
$str = "first=value&arr[]=foo+bar&arr[]=baz";

// Recommended
parse_str($str, $output);
echo $output['first'], PHP_EOL; // value
echo $output['arr'][0], PHP_EOL; // foo bar
echo $output['arr'][1], PHP_EOL; // baz
?>

Any spaces and dots in parameter names are converted to underscores when creating array keys or local variables. This is because variable names in PHP are not allowed to contain spaces or dots, but applies even when using this function with the recommended result parameter.

Приклад #2 parse_str() name mangling

<?php
parse_str("My Value=Something", $output);
echo $output['My_Value']; // Something
?>

Примітки

Зауваження:

parse_str() is affected by the max_input_vars directive. Exceeding this limit triggers an E_WARNING, and any variables beyond the limit are not added to the result array. The default is 1000; adjust max_input_vars as needed.

Зауваження:

All values populated in the result array (or variables created if second parameter is not set) are already URL-decoded using the same rules as urldecode().

Зауваження:

To get the query string of the current request, you may use the variable $_SERVER['QUERY_STRING']. Also, you may want to read the section on variables from external sources.

Прогляньте також