Langage de programmation - PHP - Référence de procédures et fonctions

PARSE_URL	Analyse URL
PHP 4+

Syntaxe

function parse_url($url);

function parse_url($url,$component);

Paramètres

Nom	Description
$url	Ce paramètre permet d'indiquer le lien URL à décomposer.
$component	Ce paramètre optionnel permet d'indiquer la partie à extraire du lien URL :
	Constante	Description
	PHP_URL_FRAGMENT	Cette constante permet d'indiquer qu'il faut retourner les fragments URL.
	PHP_URL_HOST	Cette constante permet d'indiquer qu'il faut retourner l'hôte de l'URL.
	PHP_URL_PASS	Cette constante permet d'indiquer qu'il faut retourner le mot de passe de l'URL.
	PHP_URL_PATH	Cette constante permet d'indiquer qu'il faut retourner le chemin URL.
	PHP_URL_PORT	Cette constante permet d'indiquer qu'il faut retourner le port URL.
	PHP_URL_QUERY	Cette constante permet d'indiquer qu'il faut retourner les paramètres de requêtes URL.
	PHP_URL_SCHEME	Cette constante permet d'indiquer qu'il faut retourner le schéma de l'URL.
	PHP_URL_USER	Cette constante permet d'indiquer qu'il faut retourner l'utilisateur URL.

Retour

Valeur	Description
FALSE	Cette valeur permet d'indiquer qu'une erreur s'est produite et que le URL est probablement mal formé.
tableau associatif	Ces valeurs permettent d'indiquer les composantes souhaités. Voici certaines des champs pouvant être retourné scheme, host, port, user, pass, path, query, fragment,...

Description

Cette fonction permet d'effectuer la décomposition des composantes d'un lien URL.

Remarques

Cette fonction n'effectue pas une validation afin de s'assurer que le URL est d'un format valide. Seul le traitement de découpage de l'URL en tableau est effectué.
A partir de la version 5.3.3, il n'y a plus de message d'attention retourné par PHP lorsque l'URL est invalide. Pour obtenir un comportement uniforme, il est préférable d'écrire «@parse_url» plutôt que «parse_url».
A partir de la version 5.1.2, il est possible d'indiquer quel composante peut être retourné.
ATTENTION ! Si vous indiquer une composante a retourner et que votre URL ne commence par «http://» ou «https://», il retournera NULL.

Exemple

Voici quelques exemples de l'utilisation de cette fonction (il est a noté que le comportement peut varié d'une sous-version de PHP à l'autre) :


				<?php
echo "parse_url('http://www.gladir.com'):";
var_dump(parse_url("http://www.gladir.com"));
echo "<br />";
echo "parse_url('www.gladir.com'):";
var_dump(parse_url("www.gladir.com"));
echo "<br />";
echo "parse_url('mentronix.gladir.com'):";
var_dump(parse_url("mentronix.gladir.com"));
echo "<br />";
 
echo "parse_url('http://www.gladir.com', PHP_URL_HOST):";
var_dump(parse_url("http://www.gladir.com", PHP_URL_HOST));
echo "<br />";
echo "parse_url('www.gladir.com', PHP_URL_HOST):";
var_dump(parse_url("www.gladir.com", PHP_URL_HOST));
echo "<br />";
echo "parse_url('mentronix.gladir.com', PHP_URL_HOST):";
var_dump(parse_url("mentronix.gladir.com", PHP_URL_HOST));
echo "<br />";
?>

on obtiendra le résultat semblable suivant :

parse_url('http://www.gladir.com'):array(2) { ["scheme"]=> string(4) "http" ["host"]=> string(14) "www.gladir.com" } parse_url('www.gladir.com'):array(1) { ["path"]=> string(14) "www.gladir.com" } parse_url('mentronix.gladir.com'):array(1) { ["path"]=> string(20) "mentronix.gladir.com" } parse_url('http://www.gladir.com', PHP_URL_HOST):string(14) "www.gladir.com" parse_url('www.gladir.com', PHP_URL_HOST):NULL parse_url('mentronix.gladir.com', PHP_URL_HOST):NULL

Voir également

Articles - URL (Uniform Resource Locator)
Langage de programmation - PHP - Référence de procédures et fonctions - dirname
Langage de programmation - PHP - Référence de procédures et fonctions - basename
Langage de programmation - PHP - Référence de procédures et fonctions - pathinfo
Langage de programmation - PHP - Référence de procédures et fonctions - parse_str

Références

PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 371

Dernière mise à jour : Dimanche, le 5 avril 2015

Section courante

A propos

Section administrative du site

PARSE_URL