Section courante

A propos

Section administrative du site

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

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

  1. <?php
  2. echo "parse_url('http://www.gladir.com'):";
  3. var_dump(parse_url("http://www.gladir.com"));
  4. echo "<br />";
  5. echo "parse_url('www.gladir.com'):";
  6. var_dump(parse_url("www.gladir.com"));
  7. echo "<br />";
  8. echo "parse_url('mentronix.gladir.com'):";
  9. var_dump(parse_url("mentronix.gladir.com"));
  10. echo "<br />";
  11.  
  12. echo "parse_url('http://www.gladir.com', PHP_URL_HOST):";
  13. var_dump(parse_url("http://www.gladir.com", PHP_URL_HOST));
  14. echo "<br />";
  15. echo "parse_url('www.gladir.com', PHP_URL_HOST):";
  16. var_dump(parse_url("www.gladir.com", PHP_URL_HOST));
  17. echo "<br />";
  18. echo "parse_url('mentronix.gladir.com', PHP_URL_HOST):";
  19. var_dump(parse_url("mentronix.gladir.com", PHP_URL_HOST));
  20. echo "<br />";
  21. ?>

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