parse_url

(PHP 4, PHP 5)

parse_url — Interpreta uma URL e retorna os seus componentes

Descrição

array parse_url ( string $url )

Esta função retorna uma matriz associativa retornando os vários componentes que estão presentes em uma url. Se um dos elementos não estiver presente, não será criada uma entrada para ele. Os componemtes são:

scheme - ex. http
host
port
user
pass
path
query - após a interogação ?
fragment - após a cancela #

Esta função não é um meio para validar a URL indicada, ela somente quebra nas partes listadas. URLs parciais também são aceitas, parse_url() tenta o melhor para interpreta-las corretamente.

Nota:
Esta função não funciona com URLs relativas.

Exemplo #1 Exemplo parse_url()

$ php -r 'print_r(parse_url("http://username:password@hostname/path?arg=value#anchor"));'
Array
(
[scheme] => http
[host] => hostname
[user] => username
[pass] => password
[path] => /path
[query] => arg=value
[fragment] => anchor
)

$ php -r 'print_r(parse_url("http://invalid_host..name/"));'
Array
(
[scheme] => http
[host] => invalid_host..name
[path] => /
)

Veja também pathinfo(), parse_str(), dirname(), e basename().