# parse_str

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

parse_str — Convierte el string en variables

### Descripción

parse_str(string `$str`, array `&$arr` = ?): void

Analiza `str` como si fuera un string de consulta pasado por medio de un URL y establece variables en el ámbito actual.

> Nota:

> Para obtener el `QUERY_STRING` actual, se puede utilizar la variable $_SERVER['QUERY_STRING']. También se puede consultar la sección sobre variables a partir de fuentes externas.

> Nota:

> La configuración magic_quotes_gpc afecta la salida de esta función, ya que parse_str() usa el mismo mecanismo que PHP utiliza para poblar las variables $_GET, $_POST, etc.

### Parámetros

`str`

  El string de entrada.

`arr`

  Si el segundo parámetro `arr` está presente, es su lugar las variables serán almacenadas en esta variable como elementos de array.

### Valores devueltos

No devuelve ningún valor.

### Ejemplos

Ejemplo #1 Utilizando parse_str()

`<?php
$str = "first=value&arr[]=foo+bar&arr[]=baz";
parse_str($str);
echo $first; // value
echo $arr[0]; // foo bar
echo $arr[1]; // baz
parse_str($str, $output);
echo $output['first']; // value
echo $output['arr'][0]; // foo bar
echo $output['arr'][1]; // baz
?>`

### Ver también

- parse_url() - Analiza un URL y devuelve sus componentes
- pathinfo() - Devuelve información acerca de la ruta de un fichero
- http_build_query() - Generar una cadena de consulta codificada estilo URL
- get_magic_quotes_gpc() - Obtiene el valor actual de configuración de magic_quotes_gpc
- urldecode() - Decodifica una cadena cifrada como URL