(PHP 4, PHP 5)
parse_url — Analiza una URL y devolver sus componentes
Esta función analiza una URL y devuelve un array asociativo que contiene aquellos componentes presentes en la URL.
El propósito de esta función no es validar la URL dada, tan solo la separa en las partes listadas anteriormente. Las URLs parciales son aceptadas también, parse_url() hace lo mejor que puede para procesarlas correctamente.
La URL a analizar. Caracteres inválidos son reemplazados por _.
Especifique uno de PHP_URL_SCHEME, PHP_URL_HOST, PHP_URL_PORT, PHP_URL_USER, PHP_URL_PASS, PHP_URL_PATH, PHP_URL_QUERY or PHP_URL_FRAGMENT para recibir solo un componente URL específico como un valor tipo string.
Sobre URLs seriamente malformadas, parse_url() puede devolver FALSE. De lo contrario se devuelve un array asociativo, cuyos componentes pueden ser (al menos uno):
Si el parámetro componente es especificado, un valor tipo string es devuelto en lugar de un array.
Versión | Descripción |
---|---|
5.3.3 | Eliminado el E_WARNING que era producido cuando fallaba el análisis de la URL. |
5.1.2 | ASe agregó el parámetro component. |
Example #1 Un ejemplo de parse_url()
<?php
$url = 'http://username:password@hostname/path?arg=value#anchor';
print_r(parse_url($url));
echo parse_url($url, PHP_URL_PATH);
?>
El resultado del ejemplo sería:
Array ( [scheme] => http [host] => hostname [user] => username [pass] => password [path] => /path [query] => arg=value [fragment] => anchor ) /path
Note:
Esta función no trabaja con URLs relativas.
Note:
Esta función tiene el propósito específico de procesar URLs y no URIs. Sin embargo, para cumplir con los requerimientos de compatibilidad hacia atrás de PHP, hace una excepción para el esquema file:// en donde se permiten tres barras (file:///...). Para cualquier otro esquema, lo anterior es inválido.