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()