parse_url

parse_url

(PHP 3, PHP 4, PHP 5)

parse_url -- Procesar una URL y devolver sus componentes

Descripci贸n

array parse_url ( string url )

Esta funci贸n analiza una URL y devuelve una matriz asociativa 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.

Lista de par谩metros

url

La URL a analizar

Valores retornados

Sobre URLs seriamente malformadas, parse_url() puede devolver FALSE y emitir un valor E_WARNING. De lo contrario se devuelve una matriz asociativa, cuyos componentes pueden ser (al menos uno):

Ejemplos

Ejemplo 1. Un ejemplo de parse_url()

<?php
$url
= 'http://nombre_usuario:contrasenya@nombre_host/ruta?arg=valor#ancla';

print_r(parse_url($url));
?>

El resultado del ejemplo seria:

Array
(
    [scheme] => http
    [host] => nombre_host
    [user] => nombre_usuario
    [pass] => contrasenya
    [path] => /ruta
    [query] => arg=valor
    [fragment] => ancla
)

Notes

Nota: Esta funci贸n no trabaja con URLs relativas.

Nota: parse_url() 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.

Ver tambi茅n

pathinfo()
parse_str()
dirname()
basename()