parse_url

(PHP 3, PHP 4, PHP 5)

parse_url -- Przetwarza adres URL i zwraca jego składowe

Opis

array parse_url ( string url )

Funkcja przetwarza URL i zwraca tablicę asocjacyjną zawierającą każdy z komponentów wchodzących w skład URL.

Ta funkcja nie służy do sprawdzania poprawności podanego URL, tylko rozbija go na podane niżej części. Częściowe URLe także są obsługiwane parse_url() postara się przetworzyć je poprawnie.

Parametry

url

Adres URL do przetworzenia

Zwracane wartości

W przypadku poważnie zdeformowanych URLi, parse_url() może zwrócić FALSE i wyemitować E_WARNING. W przeciwnym wypadku zostanie zwrócona asocjatywna tablica, której składowe mogą być następujące (wystąpi przynajmnej jedena):

Przykłady

Przykład 1. A parse_url() przykład

<?php
$url
= 'http://uzytkownik:haslo@serwer/sciezka?arg=wartosc#kotwica';

print_r(parse_url($url));
?>

Powyższy przykład wyświetli:

Array
(
    [scheme] => http
	[host] => serwerer
	[user] => uzytkownik
	[pass] => haslo
	[path] => /sciezka
	[query] => arg=wartosc
	[fragment] => kotwica
)

Notatki

Notatka: Funkcja nie działa na relatywnych URLach.

Notatka: parse_url() jest przeznaczona do przetwarzania URLi, a nie URI. Jednakże, aby zastosować wymóg wstecznej kompatybilności PHP, zrobiono wyjątek dla protokołu file:// gdzie potrójne ukośniki (file:///...) są dozwolone. Dla innych protokołów jest to nieprawidłowe.

Patrz także

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