WebSVN – Applications.framework – Diff – /trunk/framework/Url.php


<?php
// declare(encoding='UTF-8');
/**
* classe Url, gérant le découpage des paramètres, leurs modification etc...
* Traduction et conversion d'une classe (NET_Url2) issue de Pear
*
 
 
* @category  Php5
* @package   Framework
// Auteur principal
* @author	Christian Schmidt <schmidt@php.net>
// Autre auteurs
* @author	Aurélien PERONNET <aurelien@tela-botanica.org>
* @author	Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @copyright 2009 Tela-Botanica
* @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
* @license   http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
* @version   SVN: $Id: Url.php 144 2010-03-02 13:01:18Z jpm $
* @link	  /doc/framework/
*
*/
class Url
{
	/**
	 * Parsing strict dans resoudre() (voir RFC 3986, section 5.2.2). Par défaut
	 * à true.
	 */
	const OPTION_STRICTE = 'strict';
 
	/**
	 * Répresenter les tableaux dans les requêtes en utilisant la notation php []. Par défaut à true.
	 */
	const OPTION_UTILISER_CROCHETS = 'use_brackets';
 
	/**
	 * URL-encoder les clés des variables dans les requêtes. Par défaut à true.
	 */
	const OPTION_ENCODER_CLES = 'encode_keys';
 
	/**
	 * Séparateurs de variables lors du parsing de la requête. Chaque caractère
	 * est considéré comme un séparateur. Par défaut, spécifié par le paramêtre
	 * arg_separator.input dans php.ini (par défaut "&").
	 */
	const OPTION_SEPARATEUR_ENTREE = 'input_separator';
 
	/**
	 * Séparateur de variables lors de la génération de la requête. Par défaut, spécifié
	 * par le paramètre arg_separator.output dans php.ini (par défaut "&").
	 */
	const OPTION_SEPARATEUR_SORTIE = 'output_separator';
 
	/**
	 * Options par défaut correspondant au comportement de php
	 * vis à vis de $_GET
	 */
	private $options = array(
		self::OPTION_STRICTE => true,
		self::OPTION_UTILISER_CROCHETS => true,
		self::OPTION_ENCODER_CLES => true,
		self::OPTION_SEPARATEUR_ENTREE => 'x&',
		self::OPTION_SEPARATEUR_SORTIE => 'x&');
 
 
	/**
	 * @var  string|bool
	 */
	private $schema = false;
 
	/**
	 * @var  string|bool
	 */
	private $infoUtilisateur = false;
 
	/**
	 * @var  string|bool
	 */
	private $hote = false;
 
	/**
	 * @var  int|bool
	 */
	private $port = false;
 
	/**
	 * @var  string
	 */
	private $chemin = '';
 
	/**
	 * @var  string|bool
	 */
	private $requete = false;
 
	/**
	 * @var  string|bool
	 */
	private $fragment = false;
 
	/**
	 * @param string $url	 une URL relative ou absolue
	 * @param array  $options
	 */
	public function __construct($url, $options = null) {
 
		$this->setOption(self::OPTION_SEPARATEUR_ENTREE,
						 ini_get('arg_separator.input'));
		$this->setOption(self::OPTION_SEPARATEUR_SORTIE,
						 ini_get('arg_separator.output'));
		if (is_array($options)) {
			foreach ($options as $nomOption => $valeur) {
				$this->setOption($nomOption);
			}
		}
 
		if (preg_match('@^([a-z][a-z0-9.+-]*):@i', $url, $reg)) {
			$this->schema = $reg[1];
			$url = substr($url, strlen($reg[0]));
		}
 
		if (preg_match('@^//([^/#?]+)@', $url, $reg)) {
			$this->setAutorite($reg[1]);
			$url = substr($url, strlen($reg[0]));
		}
 
		$i = strcspn($url, '?#');
		$this->chemin = substr($url, 0, $i);
		$url = substr($url, $i);
 
		if (preg_match('@^\?([^#]*)@', $url, $reg)) {
			$this->requete = $reg[1];
			$url = substr($url, strlen($reg[0]));
		}
 
		if ($url) {
			$this->fragment = substr($url, 1);
		}
	}
 
	/**
	 * Retourne le schéma, c.a.d. "http" ou "urn", ou false si aucun schéma n'est
	 * spécifié, i.e. l'url est une url relative
	 *
	 * @return  string|bool
	 */
	public function getSchema() {
 
		return $this->schema;
	}
 
	/**
	 * @param string|bool $schema
	 *
	 * @return void
	 * @see	getSchema()
	 */
	public function setSchema($schema) {
 
		$this->schema = $schema;
	}
 
	/**
	 * renvoie la partie user de la partie infoUtilisateur (partie précédant le premier
	 *  ":"), ou false si aucune partie infoUtilisateur n'est définie.
	 *
	 * @return  string|bool
	 */
	public function getUtilisateur() {
 
		return $this->infoUtilisateur !== false ? preg_replace('@:.*$@', '', $this->infoUtilisateur) : false;
	}
 
	/**
	 * renvoie la partie mot de passe de la partie infoUtilisateur (partie après le premier
	 *  ":"), , ou false si aucune partie infoUtilisateur n'est définie (i.e. l'URL ne contient
	 * pas de "@" en face du nom d'hôte) ou si la partie infoUtilisateur ne contient pas de ":".
	 *
	 * @return  string|bool
	 */
	public function getMotDePasse() {
 
		return $this->infoUtilisateur !== false ? substr(strstr($this->infoUtilisateur, ':'), 1) : false;
	}
 
	/**
	 * Renvoie la partie userinfio, ou false si celle-ci n'existe pas, i.e. si la partie
	 * autorité ne contient pas de "@"
	 *
	 * @return  string|bool
	 */
	public function getInfoUtilisateur() {
 
		return $this->infoUtilisateur;
	}
 
	/**
	 * Setteur pour la partie infoUtilisateur. Si deux argument sont passé, ils sont combinés
	 * dans la partie infoUtilisateur de cette manière username ":" password.
	 *
	 * @param string|bool $infoUtilisateur infoUtilisateur ou username
	 * @param string|bool $motDePasse
	 *
	 * @return void
	 */
	public function setInfoUtilisateur($infoUtilisateur, $motDePasse = false) {
 
		$this->infoUtilisateur = $infoUtilisateur;
		if ($motDePasse !== false) {
			$this->infoUtilisateur .= ':' . $motDePasse;
		}
	}
 
	/**
	 * Renvoie la partie hôte, ou false s'il n'y a pas de partie autorité, c.a.d.
	 * l'URL est relative.
	 *
	 * @return  string|bool
	 */
	public function getHote() {
 
		return $this->hote;
	}
 
	/**
	 * @param string|bool $hote
	 *
	 * @return void
	 */
	public function setHote($hote) {
 
		$this->hote = $hote;
	}
 
	/**
	 * Renvoie le numéro de port, ou false si aucun numéro de port n'est spécifié,
	 * i.e. le port par défaut doit utilisé.
	 *
	 * @return  int|bool
	 */
	public function getPort() {
 
		return $this->port;
	}
 
	/**
	 * @param int|bool $port
	 *
	 * @return void
	 */
	public function setPort($port) {
 
		$this->port = intval($port);
	}
 
	/**
	 * Renvoie la partie autorité, i.e. [ infoUtilisateur "@" ] hote [ ":" port ], ou
	 * false si celle-ci est absente.
	 *
	 * @return string|bool
	 */
	public function getAutorite() {
 
		if (!$this->hote) {
			return false;
		}
 
		$autorite = '';
 
		if ($this->infoUtilisateur !== false) {
			$autorite .= $this->infoUtilisateur . '@';
		}
 
		$autorite .= $this->hote;
 
		if ($this->port !== false) {
			$autorite .= ':' . $this->port;
		}
 
		return $autorite;
	}
 
	/**
	 * @param string|false $autorite
	 *
	 * @return void
	 */
	public function setAutorite($autorite) {
 
		$this->user = false;
		$this->pass = false;
		$this->hote = false;
		$this->port = false;
		if (preg_match('@^(([^\@]+)\@)?([^:]+)(:(\d*))?$@', $autorite, $reg)) {
			if ($reg[1]) {
				$this->infoUtilisateur = $reg[2];
			}
 
			$this->hote = $reg[3];
			if (isset($reg[5])) {
				$this->port = intval($reg[5]);
			}
		}
	}
 
	/**
	 * Renvoie la partie chemin (chemin) (éventuellement vide).
	 *
	 * @return string
	 */
	public function getChemin() {
 
		return $this->chemin;
	}
 
	/**
	 * @param string $chemin
	 *
	 * @return void
	 */
	public function setChemin($chemin) {
 
		$this->chemin = $chemin;
	}
 
	/**
	 * renvoie la chaine de requête (requete string) (sans le premier "?"), ou false si "?"
	 * n'est pas présent dans l'url.
	 *
	 * @return  string|bool
	 * @see	 self::getVariablesRequete()
	 */
	public function getRequete() {
 
		return $this->requete;
	}
 
	/**
	 * @param string|bool $requete
	 *
	 * @return void
	 * @see   self::setVariablesRequete()
	 */
	public function setRequete($requete) {
 
		$this->requete = $requete;
	}
 
	/**
	 * Renvoie le nom du fragment, ou false si "#" n'est pas present dans l'URL.
	 *
	 * @return  string|bool
	 */
	public function getFragment() {
 
		return $this->fragment;
	}
 
	/**
	 * @param string|bool $fragment
	 *
	 * @return void
	 */
	public function setFragment($fragment) {
 
		$this->fragment = $fragment;
	}
 
	/**
	 * Renvoie la requete string sous forme d'un tableau de variables telles qu'elles apparaitraient
	 * dans le $_GET d'un script PHP
	 *
	 * @return  array
	 */
	public function getVariablesRequete() {
 
		$pattern = '/[' .
				   preg_quote($this->getOption(self::OPTION_SEPARATEUR_ENTREE), '/') .
				   ']/';
		$parties   = preg_split($pattern, $this->requete, -1, PREG_SPLIT_NO_EMPTY);
		$retour  = array();
 
		foreach ($parties as $partie) {
			if (strpos($partie, '=') !== false) {
				list($cle, $valeur) = explode('=', $partie, 2);
			} else {
				$cle   = $partie;
				$valeur = null;
			}
 
			if ($this->getOption(self::OPTION_ENCODER_CLES)) {
				$cle = rawurldecode($cle);
			}
			$valeur = rawurldecode($valeur);
 
			if ($this->getOption(self::OPTION_UTILISER_CROCHETS) &&
				preg_match('#^(.*)\[([0-9a-z_-]*)\]#i', $cle, $matches)) {
 
				$cle = $matches[1];
				$idx = $matches[2];
 
				// On s'assure que c'est bien un tableau
				if (empty($retour[$cle]) || !is_array($retour[$cle])) {
					$retour[$cle] = array();
				}
 
				// Ajout des données
				if ($idx === '') {
					$retour[$cle][] = $valeur;
				} else {
					$retour[$cle][$idx] = $valeur;
				}
			} elseif (!$this->getOption(self::OPTION_UTILISER_CROCHETS)
					  && !empty($retour[$cle])
			) {
				$retour[$cle]   = (array) $retour[$cle];
				$retour[$cle][] = $valeur;
			} else {
				$retour[$cle] = $valeur;
			}
		}
 
		return $retour;
	}
 
	/**
	 * @param array $tableau (nom => valeur) tableau
	 *
	 * @return void
	 */
	public function setVariablesRequete(array $tableau) {
 
		if (!$tableau) {
			$this->requete = false;
		} else {
			foreach ($tableau as $nom => $valeur) {
				if ($this->getOption(self::OPTION_ENCODER_CLES)) {
					$nom = rawurlencode($nom);
				}
 
				if (is_array($valeur)) {
					foreach ($valeur as $k => $v) {
						$parties[] = $this->getOption(self::OPTION_UTILISER_CROCHETS)
							? sprintf('%s[%s]=%s', $nom, $k, $v)
							: ($nom . '=' . $v);
					}
				} elseif (!is_null($valeur)) {
					$parties[] = $nom . '=' . $valeur;
				} else {
					$parties[] = $nom;
				}
			}
			$this->requete = implode($this->getOption(self::OPTION_SEPARATEUR_SORTIE),
								   $parties);
		}
	}
 
	/**
	 * @param string $nom
	 * @param mixed  $valeur
	 *
	 * @return  array
	 */
	public function setVariableRequete($nom, $valeur) {
 
		$tableau = $this->getVariablesRequete();
		$tableau[$nom] = $valeur;
		$this->setVariablesRequete($tableau);
	}
 
	/**
	 * @param string $nom
	 *
	 * @return void
	 */
	public function unsetVariableRequete($nom) {
 
		$tableau = $this->getVariablesRequete();
		unset($tableau[$nom]);
		$this->setVariablesRequete($tableau);
	}
 
	/**
	 * Renvoie un représentation sous forme de chaine de l'URL
	 *
	 * @return  string
	 */
	public function getURL() {
 
		// Voir RFC 3986, section 5.3
		$url = "";
 
		if ($this->schema !== false) {
			$url .= $this->schema . ':';
		}
 
		$autorite = $this->getAutorite();
		if ($autorite !== false) {
			$url .= '//' . $autorite;
		}
		$url .= $this->chemin;
 
		if ($this->requete !== false) {
			$url .= '?' . $this->requete;
		}
 
		if ($this->fragment !== false) {
			$url .= '#' . $this->fragment;
		}
 
		return $url;
	}
 
	/**
	 * Renvoie une représentation de cette URL sous forme de chaine normalisée. Utile pour la
	 * comparaison d'URLs
	 *
	 * @return  string
	 */
	public function getURLNormalisee() {
 
		$url = clone $this;
		$url->normaliser();
		return $url->getUrl();
	}
 
	/**
	 * Renvoie une instance normalisée de Url
	 *
	 * @return  Url
	 */
	public function normaliser() {
 
		// See RFC 3886, section 6
 
		// les cchémas sont insesibles à la casse
		if ($this->schema) {
			$this->schema = strtolower($this->schema);
		}
 
		// les noms d'hotes sont insensibles à la casse
		if ($this->hote) {
			$this->hote = strtolower($this->hote);
		}
 
		// Supprimer le numéro de port par défaut pour les schemas connus (RFC 3986, section 6.2.3)
		if ($this->port &&
			$this->schema &&
			$this->port == getservbyname($this->schema, 'tcp')) {
 
			$this->port = false;
		}
 
		// normalisation dans le cas d'un encodage avec %XX pourcentage (RFC 3986, section 6.2.2.1)
		foreach (array('infoUtilisateur', 'hote', 'chemin') as $partie) {
			if ($this->$partie) {
				$this->$partie  = preg_replace('/%[0-9a-f]{2}/ie', 'strtoupper("\0")', $this->$partie);
			}
		}
 
		// normalisation des segments du chemin (RFC 3986, section 6.2.2.3)
		$this->chemin = self::supprimerSegmentsAPoints($this->chemin);
 
		// normalisation basée sur le schéma (RFC 3986, section 6.2.3)
		if ($this->hote && !$this->chemin) {
			$this->chemin = '/';
		}
	}
 
	/**
	 * Renvoie vrai ou faux suivant que l'instance en cours représente une URL relative ou absolue.
	 *
	 * @return  bool
	 */
	public function etreAbsolue() {
 
		return (bool) $this->schema;
	}
 
	/**
	 * Renvoie une instance de Url représentant une URL absolue relative à
	 * cette URL.
	 *
	 * @param Url|string $reference URL relative
	 *
	 * @return Url
	 */
	public function resoudre($reference) {
 
		if (is_string($reference)) {
			$reference = new self($reference);
		}
		if (!$this->etreAbsolue()) {
			throw new Exception('L\'URL de base doit être absolue !');
		}
 
		// Un parseur non strict peut choisir d'ignorer un schema dans la référence
		// si celui ci est identique au schéma de base de l'URI.
		if (!$this->getOption(self::OPTION_STRICTE) && $reference->schema == $this->schema) {
			$reference->schema = false;
		}
 
		$cible = new self('');
		if ($reference->schema !== false) {
			$cible->schema = $reference->schema;
			$cible->setAutorite($reference->getAutorite());
			$cible->chemin  = self::supprimerSegmentsAPoints($reference->chemin);
			$cible->requete = $reference->requete;
		} else {
			$autorite = $reference->getAutorite();
			if ($autorite !== false) {
				$cible->setAutorite($autorite);
				$cible->chemin  = self::supprimerSegmentsAPoints($reference->chemin);
				$cible->requete = $reference->requete;
			} else {
				if ($reference->chemin == '') {
					$cible->chemin = $this->chemin;
					if ($reference->requete !== false) {
						$cible->requete = $reference->requete;
					} else {
						$cible->requete = $this->requete;
					}
				} else {
					if (substr($reference->chemin, 0, 1) == '/') {
						$cible->chemin = self::supprimerSegmentsAPoints($reference->chemin);
					} else {
						// Concaténation chemins (RFC 3986, section 5.2.3)
						if ($this->hote !== false && $this->chemin == '') {
							$cible->chemin = '/' . $this->chemin;
						} else {
							$i = strrpos($this->chemin, '/');
							if ($i !== false) {
								$cible->chemin = substr($this->chemin, 0, $i + 1);
							}
							$cible->chemin .= $reference->chemin;
						}
						$cible->chemin = self::supprimerSegmentsAPoints($cible->chemin);
					}
					$cible->requete = $reference->requete;
				}
				$cible->setAutorite($this->getAutorite());
			}
			$cible->schema = $this->schema;
		}
 
		$cible->fragment = $reference->fragment;
 
		return $cible;
	}
 
	/**
	 * La suppression des segments à points est décrite dans la RFC 3986, section 5.2.4, e.g.
	 * "/foo/../bar/baz" => "/bar/baz"
	 *
	 * @param string $chemin un chemin
	 *
	 * @return string un chemin
	 */
	private static function supprimerSegmentsAPoints($chemin) {
 
		$sortie = '';
 
		// Assurons de ne pas nous retrouver piégés dans une boucle infinie due à un bug de
		// cette méthode
		$j = 0;
		while ($chemin && $j++ < 100) {
			// Étape A
			if (substr($chemin, 0, 2) == './') {
				$chemin = substr($chemin, 2);
			} elseif (substr($chemin, 0, 3) == '../') {
				$chemin = substr($chemin, 3);
 
			// Étape B
			} elseif (substr($chemin, 0, 3) == '/./' || $chemin == '/.') {
				$chemin = '/' . substr($chemin, 3);
 
			// Étape C
			} elseif (substr($chemin, 0, 4) == '/../' || $chemin == '/..') {
				$chemin = '/' . substr($chemin, 4);
				$i = strrpos($sortie, '/');
				$sortie = $i === false ? '' : substr($sortie, 0, $i);
 
			// Étape D
			} elseif ($chemin == '.' || $chemin == '..') {
				$chemin = '';
 
			// Étape E
			} else {
				$i = strpos($chemin, '/');
				if ($i === 0) {
					$i = strpos($chemin, '/', 1);
				}
				if ($i === false) {
					$i = strlen($chemin);
				}
				$sortie .= substr($chemin, 0, $i);
				$chemin = substr($chemin, $i);
			}
		}
 
		return $sortie;
	}
 
	/**
	 * Renvoie une instance de Url representant l'URL canonique du script PHP
	 * en cours d'éxécution
	 *
	 * @return  string
	 */
	public static function getCanonique() {
 
		if (!isset($_SERVER['REQUEST_METHOD'])) {
			// ALERT - pas d'URL en cours
			throw new Exception('Le script n\'a pas été appellé à travers un serveur web');
		}
 
		// on part d'une URL relative
		$url = new self($_SERVER['PHP_SELF']);
		$url->schema = isset($_SERVER['HTTPS']) ? 'https' : 'http';
		$url->hote = $_SERVER['SERVER_NAME'];
		$port = intval($_SERVER['SERVER_PORT']);
		if ($url->schema == 'http' && $port != 80 ||
			$url->schema == 'https' && $port != 443) {
 
			$url->port = $port;
		}
		return $url;
	}
 
	/**
	 * Renvoie l'URL utilisée pour récupérer la requête en cours
	 *
	 * @return  string
	 */
	public static function getURLDemande() {
 
		return self::getDemande()->getUrl();
	}
 
	/**
	 * Renvoie une instance de Url representant l'URL utilisée pour
	 * récupérer la requête en cours
	 *
	 * @return  Url
	 */
	public static function getDemande() {
 
		if (!isset($_SERVER['REQUEST_METHOD'])) {
			// ALERTE - pas d'URL en cours
			throw new Exception('Le script n\'a pas été appellé à travers un serveur web');
		}
 
		// On part d'une URL relative
		$url = new self($_SERVER['REQUEST_URI']);
		$url->schema = isset($_SERVER['HTTPS']) ? 'https' : 'http';
		// On met à jour les valeurs de l'hote et si possible du port
		$url->setAutorite($_SERVER['HTTP_hote']);
		return $url;
	}
 
	/**
	 * Met à jour la valeur de l'option spécifiée.
	 *
	 * @param string $nomOption une des constantes commençant par self::OPTION_
	 * @param mixed  $valeur	  valeur de l'option
	 *
	 * @return void
	 * @see  self::OPTION_STRICTE
	 * @see  self::OPTION_UTILISER_CROCHETS
	 * @see  self::OPTION_ENCODER_CLES
	 */
	function setOption($nomOption, $valeur) {
 
		if (!array_key_exists($nomOption, $this->options)) {
			return false;
		}
		$this->options[$nomOption] = $valeur;
	}
 
	/**
	 * Renvoie la valeur de l'option specifiée.
	 *
	 * @param string $nomOption Nom de l'option demandée
	 *
	 * @return  mixed
	 */
	function getOption($nomOption) {
 
		return isset($this->options[$nomOption])
			? $this->options[$nomOption] : false;
	}
 
	public function __toString() {
		return $this->getURL();
	}
}

Rev 120	Rev 144
1	`<?php`	1	`<?php`
2	`// declare(encoding='UTF-8');`	2	`// declare(encoding='UTF-8');`
3	`/**`	3	`/**`
4	`* classe Url, gérant le découpage des paramètres, leurs modification etc...`	4	`* classe Url, gérant le découpage des paramètres, leurs modification etc...`
5	`* Traduction et conversion d'une classe (NET_Url2) issue de Pear`	5	`* Traduction et conversion d'une classe (NET_Url2) issue de Pear`
6	`*`	6	`*`
7	`* PHP Version 5`	-
8	`*`	-
9	`* @category Class`	7	`* @category Php5`
10	`* @package Framework`	8	`* @package Framework`
11	`// auteur principal`	9	`// Auteur principal`
12	`* @author Christian Schmidt <schmidt@php.net>`	10	`* @author Christian Schmidt <schmidt@php.net>`
13	`// autre auteurs`	11	`// Autre auteurs`
14	`* @author aurelien <aurelien@tela-botanica.org>`	12	`* @author Aurélien PERONNET <aurelien@tela-botanica.org>`
-		13	`* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>`
15	`* @copyright 2009 Tela-Botanica`	14	`* @copyright 2009 Tela-Botanica`
16	`* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL`	15	`* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL`
17	`* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL`	16	`* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL`
18	`* @version SVN: $Id: Url.php 120 2009-09-01 12:21:14Z aurelien $`	17	`* @version SVN: $Id: Url.php 144 2010-03-02 13:01:18Z jpm $`
19	`* @link /doc/framework/`	18	`* @link /doc/framework/`
20	`*`	19	`*`
21	`*/`	20	`*/`
22	`class Url`	21	`class Url`
23	`{`	22	`{`
24	`/**`	23	`/**`
25	`* Parsing strict dans resoudre() (voir RFC 3986, section 5.2.2). Par défaut`	24	`* Parsing strict dans resoudre() (voir RFC 3986, section 5.2.2). Par défaut`
26	`* à true.`	25	`* à true.`
27	`*/`	26	`*/`
28	`const OPTION_STRICTE = 'strict';`	27	`const OPTION_STRICTE = 'strict';`
29		28
30	`/**`	29	`/**`
31	`* Répresenter les tableaux dans les requêtes en utilisant la notation php []. Par défaut à true.`	30	`* Répresenter les tableaux dans les requêtes en utilisant la notation php []. Par défaut à true.`
32	`*/`	31	`*/`
33	`const OPTION_UTILISER_CROCHETS = 'use_brackets';`	32	`const OPTION_UTILISER_CROCHETS = 'use_brackets';`
34		33
35	`/**`	34	`/**`
36	`* URL-encoder les clés des variables dans les requêtes. Par défaut à true.`	35	`* URL-encoder les clés des variables dans les requêtes. Par défaut à true.`
37	`*/`	36	`*/`
38	`const OPTION_ENCODER_CLES = 'encode_keys';`	37	`const OPTION_ENCODER_CLES = 'encode_keys';`
39		38
40	`/**`	39	`/**`
41	`* Séparateurs de variables lors du parsing de la requête. Chaque caractère`	40	`* Séparateurs de variables lors du parsing de la requête. Chaque caractère`
42	`* est considéré comme un séparateur. Par défaut, spécifié par le paramêtre`	41	`* est considéré comme un séparateur. Par défaut, spécifié par le paramêtre`
43	`* arg_separator.input dans php.ini (par défaut "&").`	42	`* arg_separator.input dans php.ini (par défaut "&").`
44	`*/`	43	`*/`
45	`const OPTION_SEPARATEUR_ENTREE = 'input_separator';`	44	`const OPTION_SEPARATEUR_ENTREE = 'input_separator';`
46		45
47	`/**`	46	`/**`
48	`* Séparateur de variables lors de la génération de la requête. Par défaut, spécifié`	47	`* Séparateur de variables lors de la génération de la requête. Par défaut, spécifié`
49	`* par le paramètre arg_separator.output dans php.ini (par défaut "&").`	48	`* par le paramètre arg_separator.output dans php.ini (par défaut "&").`
50	`*/`	49	`*/`
51	`const OPTION_SEPARATEUR_SORTIE = 'output_separator';`	50	`const OPTION_SEPARATEUR_SORTIE = 'output_separator';`
52		51
53	`/**`	52	`/**`
54	`* Options par défaut correspondant au comportement de php`	53	`* Options par défaut correspondant au comportement de php`
55	`* vis à vis de $_GET`	54	`* vis à vis de $_GET`
56	`*/`	55	`*/`
57	`private $options = array(`	56	`private $options = array(`
58	`self::OPTION_STRICTE => true,`	57	`self::OPTION_STRICTE => true,`
59	`self::OPTION_UTILISER_CROCHETS => true,`	58	`self::OPTION_UTILISER_CROCHETS => true,`
60	`self::OPTION_ENCODER_CLES => true,`	59	`self::OPTION_ENCODER_CLES => true,`
61	`self::OPTION_SEPARATEUR_ENTREE => 'x&',`	60	`self::OPTION_SEPARATEUR_ENTREE => 'x&',`
62	`self::OPTION_SEPARATEUR_SORTIE => 'x&',`	61	`self::OPTION_SEPARATEUR_SORTIE => 'x&');`
63	`);`	-
64		62
65	`/**`	63	`/**`
66	`* @var string\|bool`	64	`* @var string\|bool`
67	`*/`	65	`*/`
68	`private $schema = false;`	66	`private $schema = false;`
69		67
70	`/**`	68	`/**`
71	`* @var string\|bool`	69	`* @var string\|bool`
72	`*/`	70	`*/`
73	`private $infoUtilisateur = false;`	71	`private $infoUtilisateur = false;`
74		72
75	`/**`	73	`/**`
76	`* @var string\|bool`	74	`* @var string\|bool`
77	`*/`	75	`*/`
78	`private $hote = false;`	76	`private $hote = false;`
79		77
80	`/**`	78	`/**`
81	`* @var int\|bool`	79	`* @var int\|bool`
82	`*/`	80	`*/`
83	`private $port = false;`	81	`private $port = false;`
84		82
85	`/**`	83	`/**`
86	`* @var string`	84	`* @var string`
87	`*/`	85	`*/`
88	`private $chemin = '';`	86	`private $chemin = '';`
89		87
90	`/**`	88	`/**`
91	`* @var string\|bool`	89	`* @var string\|bool`
92	`*/`	90	`*/`
93	`private $requete = false;`	91	`private $requete = false;`
94		92
95	`/**`	93	`/**`
96	`* @var string\|bool`	94	`* @var string\|bool`
97	`*/`	95	`*/`
98	`private $fragment = false;`	96	`private $fragment = false;`
99		97
100	`/**`	98	`/**`
101	`* @param string $url une URL relative ou absolue`	99	`* @param string $url une URL relative ou absolue`
102	`* @param array $options`	100	`* @param array $options`
103	`*/`	101	`*/`
104	`public function __construct($url, $options = null)`	102	`public function __construct($url, $options = null) {`
105	`{`	-
106	`$this->setOption(self::OPTION_SEPARATEUR_ENTREE,`	103	`$this->setOption(self::OPTION_SEPARATEUR_ENTREE,`
107	`ini_get('arg_separator.input'));`	104	`ini_get('arg_separator.input'));`
108	`$this->setOption(self::OPTION_SEPARATEUR_SORTIE,`	105	`$this->setOption(self::OPTION_SEPARATEUR_SORTIE,`
109	`ini_get('arg_separator.output'));`	106	`ini_get('arg_separator.output'));`
110	`if (is_array($options)) {`	107	`if (is_array($options)) {`
111	`foreach ($options as $nomOption => $valeur) {`	108	`foreach ($options as $nomOption => $valeur) {`
112	`$this->setOption($nomOption);`	109	`$this->setOption($nomOption);`
113	`}`	110	`}`
114	`}`	111	`}`
115		112
116	`if (preg_match('@^([a-z][a-z0-9.+-]*):@i', $url, $reg)) {`	113	`if (preg_match('@^([a-z][a-z0-9.+-]*):@i', $url, $reg)) {`
117	`$this->schema = $reg[1];`	114	`$this->schema = $reg[1];`
118	`$url = substr($url, strlen($reg[0]));`	115	`$url = substr($url, strlen($reg[0]));`
119	`}`	116	`}`
120		117
121	`if (preg_match('@^//([^/#?]+)@', $url, $reg)) {`	118	`if (preg_match('@^//([^/#?]+)@', $url, $reg)) {`
122	`$this->setAutorite($reg[1]);`	119	`$this->setAutorite($reg[1]);`
123	`$url = substr($url, strlen($reg[0]));`	120	`$url = substr($url, strlen($reg[0]));`
124	`}`	121	`}`
125		122
126	`$i = strcspn($url, '?#');`	123	`$i = strcspn($url, '?#');`
127	`$this->chemin = substr($url, 0, $i);`	124	`$this->chemin = substr($url, 0, $i);`
128	`$url = substr($url, $i);`	125	`$url = substr($url, $i);`
129		126
130	`if (preg_match('@^\?([^#]*)@', $url, $reg)) {`	127	`if (preg_match('@^\?([^#]*)@', $url, $reg)) {`
131	`$this->requete = $reg[1];`	128	`$this->requete = $reg[1];`
132	`$url = substr($url, strlen($reg[0]));`	129	`$url = substr($url, strlen($reg[0]));`
133	`}`	130	`}`
134		131
135	`if ($url) {`	132	`if ($url) {`
136	`$this->fragment = substr($url, 1);`	133	`$this->fragment = substr($url, 1);`
137	`}`	134	`}`
138	`}`	135	`}`
139		136
140	`/**`	137	`/**`
141	`* Retourne le schéma, c.a.d. "http" ou "urn", ou false si aucun schéma n'est`	138	`* Retourne le schéma, c.a.d. "http" ou "urn", ou false si aucun schéma n'est`
142	`* spécifié, i.e. l'url est une url relative`	139	`* spécifié, i.e. l'url est une url relative`
143	`*`	140	`*`
144	`* @return string\|bool`	141	`* @return string\|bool`
145	`*/`	142	`*/`
146	`public function getSchema()`	143	`public function getSchema() {`
147	`{`	-
148	`return $this->schema;`	144	`return $this->schema;`
149	`}`	145	`}`
150		146
151	`/**`	147	`/**`
152	`* @param string\|bool $schema`	148	`* @param string\|bool $schema`
153	`*`	149	`*`
154	`* @return void`	150	`* @return void`
155	`* @see getSchema()`	151	`* @see getSchema()`
156	`*/`	152	`*/`
157	`public function setSchema($schema)`	153	`public function setSchema($schema) {`
158	`{`	-
159	`$this->schema = $schema;`	154	`$this->schema = $schema;`
160	`}`	155	`}`
161		156
162	`/**`	157	`/**`
163	`* renvoie la partie user de la partie infoUtilisateur (partie précédant le premier`	158	`* renvoie la partie user de la partie infoUtilisateur (partie précédant le premier`
164	`* ":"), ou false si aucune partie infoUtilisateur n'est définie.`	159	`* ":"), ou false si aucune partie infoUtilisateur n'est définie.`
165	`*`	160	`*`
166	`* @return string\|bool`	161	`* @return string\|bool`
167	`*/`	162	`*/`
168	`public function getUtilisateur()`	163	`public function getUtilisateur() {`
169	`{`	-
170	`return $this->infoUtilisateur !== false ? preg_replace('@:.*$@', '', $this->infoUtilisateur) : false;`	164	`return $this->infoUtilisateur !== false ? preg_replace('@:.*$@', '', $this->infoUtilisateur) : false;`
171	`}`	165	`}`
172		166
173	`/**`	167	`/**`
174	`* renvoie la partie mot de passe de la partie infoUtilisateur (partie après le premier`	168	`* renvoie la partie mot de passe de la partie infoUtilisateur (partie après le premier`
175	`* ":"), , ou false si aucune partie infoUtilisateur n'est définie (i.e. l'URL ne contient`	169	`* ":"), , ou false si aucune partie infoUtilisateur n'est définie (i.e. l'URL ne contient`
176	`* pas de "@" en face du nom d'hôte) ou si la partie infoUtilisateur ne contient pas de ":".`	170	`* pas de "@" en face du nom d'hôte) ou si la partie infoUtilisateur ne contient pas de ":".`
177	`*`	171	`*`
178	`* @return string\|bool`	172	`* @return string\|bool`
179	`*/`	173	`*/`
180	`public function getMotDePasse()`	174	`public function getMotDePasse() {`
181	`{`	-
182	`return $this->infoUtilisateur !== false ? substr(strstr($this->infoUtilisateur, ':'), 1) : false;`	175	`return $this->infoUtilisateur !== false ? substr(strstr($this->infoUtilisateur, ':'), 1) : false;`
183	`}`	176	`}`
184		177
185	`/**`	178	`/**`
186	`* Renvoie la partie userinfio, ou false si celle-ci n'existe pas, i.e. si la partie`	179	`* Renvoie la partie userinfio, ou false si celle-ci n'existe pas, i.e. si la partie`
187	`* autorité ne contient pas de "@"`	180	`* autorité ne contient pas de "@"`
188	`*`	181	`*`
189	`* @return string\|bool`	182	`* @return string\|bool`
190	`*/`	183	`*/`
191	`public function getInfoUtilisateur()`	184	`public function getInfoUtilisateur() {`
192	`{`	-
193	`return $this->infoUtilisateur;`	185	`return $this->infoUtilisateur;`
194	`}`	186	`}`
195		187
196	`/**`	188	`/**`
197	`* Setteur pour la partie infoUtilisateur. Si deux argument sont passé, ils sont combinés`	189	`* Setteur pour la partie infoUtilisateur. Si deux argument sont passé, ils sont combinés`
198	`* dans la partie infoUtilisateur de cette manière username ":" password.`	190	`* dans la partie infoUtilisateur de cette manière username ":" password.`
199	`*`	191	`*`
200	`* @param string\|bool $infoUtilisateur infoUtilisateur ou username`	192	`* @param string\|bool $infoUtilisateur infoUtilisateur ou username`
201	`* @param string\|bool $motDePasse`	193	`* @param string\|bool $motDePasse`
202	`*`	194	`*`
203	`* @return void`	195	`* @return void`
204	`*/`	196	`*/`
205	`public function setInfoUtilisateur($infoUtilisateur, $motDePasse = false)`	197	`public function setInfoUtilisateur($infoUtilisateur, $motDePasse = false) {`
206	`{`	-
207	`$this->infoUtilisateur = $infoUtilisateur;`	198	`$this->infoUtilisateur = $infoUtilisateur;`
208	`if ($motDePasse !== false) {`	199	`if ($motDePasse !== false) {`
209	`$this->infoUtilisateur .= ':' . $motDePasse;`	200	`$this->infoUtilisateur .= ':' . $motDePasse;`
210	`}`	201	`}`
211	`}`	202	`}`
212		203
213	`/**`	204	`/**`
214	`* Renvoie la partie hôte, ou false s'il n'y a pas de partie autorité, c.a.d.`	205	`* Renvoie la partie hôte, ou false s'il n'y a pas de partie autorité, c.a.d.`
215	`* l'URL est relative.`	206	`* l'URL est relative.`
216	`*`	207	`*`
217	`* @return string\|bool`	208	`* @return string\|bool`
218	`*/`	209	`*/`
219	`public function getHote()`	210	`public function getHote() {`
220	`{`	-
221	`return $this->hote;`	211	`return $this->hote;`
222	`}`	212	`}`
223		213
224	`/**`	214	`/**`
225	`* @param string\|bool $hote`	215	`* @param string\|bool $hote`
226	`*`	216	`*`
227	`* @return void`	217	`* @return void`
228	`*/`	218	`*/`
229	`public function setHote($hote)`	219	`public function setHote($hote) {`
230	`{`	-
231	`$this->hote = $hote;`	220	`$this->hote = $hote;`
232	`}`	221	`}`
233		222
234	`/**`	223	`/**`
235	`* Renvoie le numéro de port, ou false si aucun numéro de port n'est spécifié,`	224	`* Renvoie le numéro de port, ou false si aucun numéro de port n'est spécifié,`
236	`* i.e. le port par défaut doit utilisé.`	225	`* i.e. le port par défaut doit utilisé.`
237	`*`	226	`*`
238	`* @return int\|bool`	227	`* @return int\|bool`
239	`*/`	228	`*/`
240	`public function getPort()`	229	`public function getPort() {`
241	`{`	-
242	`return $this->port;`	230	`return $this->port;`
243	`}`	231	`}`
244		232
245	`/**`	233	`/**`
246	`* @param int\|bool $port`	234	`* @param int\|bool $port`
247	`*`	235	`*`
248	`* @return void`	236	`* @return void`
249	`*/`	237	`*/`
250	`public function setPort($port)`	238	`public function setPort($port) {`
251	`{`	-
252	`$this->port = intval($port);`	239	`$this->port = intval($port);`
253	`}`	240	`}`
254		241
255	`/**`	242	`/**`
256	`* Renvoie la partie autorité, i.e. [ infoUtilisateur "@" ] hote [ ":" port ], ou`	243	`* Renvoie la partie autorité, i.e. [ infoUtilisateur "@" ] hote [ ":" port ], ou`
257	`* false si celle-ci est absente.`	244	`* false si celle-ci est absente.`
258	`*`	245	`*`
259	`* @return string\|bool`	246	`* @return string\|bool`
260	`*/`	247	`*/`
261	`public function getAutorite()`	248	`public function getAutorite() {`
262	`{`	-
263	`if (!$this->hote) {`	249	`if (!$this->hote) {`
264	`return false;`	250	`return false;`
265	`}`	251	`}`
266		252
267	`$autorite = '';`	253	`$autorite = '';`
268		254
269	`if ($this->infoUtilisateur !== false) {`	255	`if ($this->infoUtilisateur !== false) {`
270	`$autorite .= $this->infoUtilisateur . '@';`	256	`$autorite .= $this->infoUtilisateur . '@';`
271	`}`	257	`}`
272		258
273	`$autorite .= $this->hote;`	259	`$autorite .= $this->hote;`
274		260
275	`if ($this->port !== false) {`	261	`if ($this->port !== false) {`
276	`$autorite .= ':' . $this->port;`	262	`$autorite .= ':' . $this->port;`
277	`}`	263	`}`
278		264
279	`return $autorite;`	265	`return $autorite;`
280	`}`	266	`}`
281		267
282	`/**`	268	`/**`
283	`* @param string\|false $autorite`	269	`* @param string\|false $autorite`
284	`*`	270	`*`
285	`* @return void`	271	`* @return void`
286	`*/`	272	`*/`
287	`public function setAutorite($autorite)`	273	`public function setAutorite($autorite) {`
288	`{`	-
289	`$this->user = false;`	274	`$this->user = false;`
290	`$this->pass = false;`	275	`$this->pass = false;`
291	`$this->hote = false;`	276	`$this->hote = false;`
292	`$this->port = false;`	277	`$this->port = false;`
293	`if (preg_match('@^(([^\@]+)\@)?([^:]+)(:(\d*))?$@', $autorite, $reg)) {`	278	`if (preg_match('@^(([^\@]+)\@)?([^:]+)(:(\d*))?$@', $autorite, $reg)) {`
294	`if ($reg[1]) {`	279	`if ($reg[1]) {`
295	`$this->infoUtilisateur = $reg[2];`	280	`$this->infoUtilisateur = $reg[2];`
296	`}`	281	`}`
297		282
298	`$this->hote = $reg[3];`	283	`$this->hote = $reg[3];`
299	`if (isset($reg[5])) {`	284	`if (isset($reg[5])) {`
300	`$this->port = intval($reg[5]);`	285	`$this->port = intval($reg[5]);`
301	`}`	286	`}`
302	`}`	287	`}`
303	`}`	288	`}`
304		289
305	`/**`	290	`/**`
306	`* Renvoie la partie chemin (chemin) (éventuellement vide).`	291	`* Renvoie la partie chemin (chemin) (éventuellement vide).`
307	`*`	292	`*`
308	`* @return string`	293	`* @return string`
309	`*/`	294	`*/`
310	`public function getChemin()`	295	`public function getChemin() {`
311	`{`	-
312	`return $this->chemin;`	296	`return $this->chemin;`
313	`}`	297	`}`
314		298
315	`/**`	299	`/**`
316	`* @param string $chemin`	300	`* @param string $chemin`
317	`*`	301	`*`
318	`* @return void`	302	`* @return void`
319	`*/`	303	`*/`
320	`public function setChemin($chemin)`	304	`public function setChemin($chemin) {`
321	`{`	-
322	`$this->chemin = $chemin;`	305	`$this->chemin = $chemin;`
323	`}`	306	`}`
324		307
325	`/**`	308	`/**`
326	`* renvoie la chaine de requête (requete string) (sans le premier "?"), ou false si "?"`	309	`* renvoie la chaine de requête (requete string) (sans le premier "?"), ou false si "?"`
327	`* n'est pas présent dans l'url.`	310	`* n'est pas présent dans l'url.`
328	`*`	311	`*`
329	`* @return string\|bool`	312	`* @return string\|bool`
330	`* @see self::getVariablesRequete()`	313	`* @see self::getVariablesRequete()`
331	`*/`	314	`*/`
332	`public function getRequete()`	315	`public function getRequete() {`
333	`{`	-
334	`return $this->requete;`	316	`return $this->requete;`
335	`}`	317	`}`
336		318
337	`/**`	319	`/**`
338	`* @param string\|bool $requete`	320	`* @param string\|bool $requete`
339	`*`	321	`*`
340	`* @return void`	322	`* @return void`
341	`* @see self::setVariablesRequete()`	323	`* @see self::setVariablesRequete()`
342	`*/`	324	`*/`
343	`public function setRequete($requete)`	325	`public function setRequete($requete) {`
344	`{`	-
345	`$this->requete = $requete;`	326	`$this->requete = $requete;`
346	`}`	327	`}`
347		328
348	`/**`	329	`/**`
349	`* Renvoie le nom du fragment, ou false si "#" n'est pas present dans l'URL.`	330	`* Renvoie le nom du fragment, ou false si "#" n'est pas present dans l'URL.`
350	`*`	331	`*`
351	`* @return string\|bool`	332	`* @return string\|bool`
352	`*/`	333	`*/`
353	`public function getFragment()`	334	`public function getFragment() {`
354	`{`	-
355	`return $this->fragment;`	335	`return $this->fragment;`
356	`}`	336	`}`
357		337
358	`/**`	338	`/**`
359	`* @param string\|bool $fragment`	339	`* @param string\|bool $fragment`
360	`*`	340	`*`
361	`* @return void`	341	`* @return void`
362	`*/`	342	`*/`
363	`public function setFragment($fragment)`	343	`public function setFragment($fragment) {`
364	`{`	-
365	`$this->fragment = $fragment;`	344	`$this->fragment = $fragment;`
366	`}`	345	`}`
367		346
368	`/**`	347	`/**`
369	`* Renvoie la requete string sous forme d'un tableau de variables telles qu'elles apparaitraient`	348	`* Renvoie la requete string sous forme d'un tableau de variables telles qu'elles apparaitraient`
370	`* dans le $_GET d'un script PHP`	349	`* dans le $_GET d'un script PHP`
371	`*`	350	`*`
372	`* @return array`	351	`* @return array`
373	`*/`	352	`*/`
374	`public function getVariablesRequete()`	353	`public function getVariablesRequete() {`
375	`{`	-
376	`$pattern = '/[' .`	354	`$pattern = '/[' .`
377	`preg_quote($this->getOption(self::OPTION_SEPARATEUR_ENTREE), '/') .`	355	`preg_quote($this->getOption(self::OPTION_SEPARATEUR_ENTREE), '/') .`
378	`']/';`	356	`']/';`
379	`$parties = preg_split($pattern, $this->requete, -1, PREG_SPLIT_NO_EMPTY);`	357	`$parties = preg_split($pattern, $this->requete, -1, PREG_SPLIT_NO_EMPTY);`
380	`$retour = array();`	358	`$retour = array();`
381		359
382	`foreach ($parties as $partie) {`	360	`foreach ($parties as $partie) {`
383	`if (strpos($partie, '=') !== false) {`	361	`if (strpos($partie, '=') !== false) {`
384	`list($cle, $valeur) = explode('=', $partie, 2);`	362	`list($cle, $valeur) = explode('=', $partie, 2);`
385	`} else {`	363	`} else {`
386	`$cle = $partie;`	364	`$cle = $partie;`
387	`$valeur = null;`	365	`$valeur = null;`
388	`}`	366	`}`
389		367
390	`if ($this->getOption(self::OPTION_ENCODER_CLES)) {`	368	`if ($this->getOption(self::OPTION_ENCODER_CLES)) {`
391	`$cle = rawurldecode($cle);`	369	`$cle = rawurldecode($cle);`
392	`}`	370	`}`
393	`$valeur = rawurldecode($valeur);`	371	`$valeur = rawurldecode($valeur);`
394		372
395	`if ($this->getOption(self::OPTION_UTILISER_CROCHETS) &&`	373	`if ($this->getOption(self::OPTION_UTILISER_CROCHETS) &&`
396	`preg_match('#^(.)\[([0-9a-z_-])\]#i', $cle, $matches)) {`	374	`preg_match('#^(.)\[([0-9a-z_-])\]#i', $cle, $matches)) {`
397		375
398	`$cle = $matches[1];`	376	`$cle = $matches[1];`
399	`$idx = $matches[2];`	377	`$idx = $matches[2];`
400		378
401	`// On s'assure que c'est bien un tableau`	379	`// On s'assure que c'est bien un tableau`
402	`if (empty($retour[$cle]) \|\| !is_array($retour[$cle])) {`	380	`if (empty($retour[$cle]) \|\| !is_array($retour[$cle])) {`
403	`$retour[$cle] = array();`	381	`$retour[$cle] = array();`
404	`}`	382	`}`
405		383
406	`// Ajout des données`	384	`// Ajout des données`
407	`if ($idx === '') {`	385	`if ($idx === '') {`
408	`$retour[$cle][] = $valeur;`	386	`$retour[$cle][] = $valeur;`
409	`} else {`	387	`} else {`
410	`$retour[$cle][$idx] = $valeur;`	388	`$retour[$cle][$idx] = $valeur;`
411	`}`	389	`}`
412	`} elseif (!$this->getOption(self::OPTION_UTILISER_CROCHETS)`	390	`} elseif (!$this->getOption(self::OPTION_UTILISER_CROCHETS)`
413	`&& !empty($retour[$cle])`	391	`&& !empty($retour[$cle])`
414	`) {`	392	`) {`
415	`$retour[$cle] = (array) $retour[$cle];`	393	`$retour[$cle] = (array) $retour[$cle];`
416	`$retour[$cle][] = $valeur;`	394	`$retour[$cle][] = $valeur;`
417	`} else {`	395	`} else {`
418	`$retour[$cle] = $valeur;`	396	`$retour[$cle] = $valeur;`
419	`}`	397	`}`
420	`}`	398	`}`
421		399
422	`return $retour;`	400	`return $retour;`
423	`}`	401	`}`
424		402
425	`/**`	403	`/**`
426	`* @param array $tableau (nom => valeur) tableau`	404	`* @param array $tableau (nom => valeur) tableau`
427	`*`	405	`*`
428	`* @return void`	406	`* @return void`
429	`*/`	407	`*/`
430	`public function setVariablesRequete(array $tableau)`	408	`public function setVariablesRequete(array $tableau) {`
431	`{`	-
432	`if (!$tableau) {`	409	`if (!$tableau) {`
433	`$this->requete = false;`	410	`$this->requete = false;`
434	`} else {`	411	`} else {`
435	`foreach ($tableau as $nom => $valeur) {`	412	`foreach ($tableau as $nom => $valeur) {`
436	`if ($this->getOption(self::OPTION_ENCODER_CLES)) {`	413	`if ($this->getOption(self::OPTION_ENCODER_CLES)) {`
437	`$nom = rawurlencode($nom);`	414	`$nom = rawurlencode($nom);`
438	`}`	415	`}`
439		416
440	`if (is_array($valeur)) {`	417	`if (is_array($valeur)) {`
441	`foreach ($valeur as $k => $v) {`	418	`foreach ($valeur as $k => $v) {`
442	`$parties[] = $this->getOption(self::OPTION_UTILISER_CROCHETS)`	419	`$parties[] = $this->getOption(self::OPTION_UTILISER_CROCHETS)`
443	`? sprintf('%s[%s]=%s', $nom, $k, $v)`	420	`? sprintf('%s[%s]=%s', $nom, $k, $v)`
444	`: ($nom . '=' . $v);`	421	`: ($nom . '=' . $v);`
445	`}`	422	`}`
446	`} elseif (!is_null($valeur)) {`	423	`} elseif (!is_null($valeur)) {`
447	`$parties[] = $nom . '=' . $valeur;`	424	`$parties[] = $nom . '=' . $valeur;`
448	`} else {`	425	`} else {`
449	`$parties[] = $nom;`	426	`$parties[] = $nom;`
450	`}`	427	`}`
451	`}`	428	`}`
452	`$this->requete = implode($this->getOption(self::OPTION_SEPARATEUR_SORTIE),`	429	`$this->requete = implode($this->getOption(self::OPTION_SEPARATEUR_SORTIE),`
453	`$parties);`	430	`$parties);`
454	`}`	431	`}`
455	`}`	432	`}`
456		433
457	`/**`	434	`/**`
458	`* @param string $nom`	435	`* @param string $nom`
459	`* @param mixed $valeur`	436	`* @param mixed $valeur`
460	`*`	437	`*`
461	`* @return array`	438	`* @return array`
462	`*/`	439	`*/`
463	`public function setVariableRequete($nom, $valeur)`	440	`public function setVariableRequete($nom, $valeur) {`
464	`{`	-
465	`$tableau = $this->getVariablesRequete();`	441	`$tableau = $this->getVariablesRequete();`
466	`$tableau[$nom] = $valeur;`	442	`$tableau[$nom] = $valeur;`
467	`$this->setVariablesRequete($tableau);`	443	`$this->setVariablesRequete($tableau);`
468	`}`	444	`}`
469		445
470	`/**`	446	`/**`
471	`* @param string $nom`	447	`* @param string $nom`
472	`*`	448	`*`
473	`* @return void`	449	`* @return void`
474	`*/`	450	`*/`
475	`public function unsetVariableRequete($nom)`	451	`public function unsetVariableRequete($nom) {`
476	`{`	-
477	`$tableau = $this->getVariablesRequete();`	452	`$tableau = $this->getVariablesRequete();`
478	`unset($tableau[$nom]);`	453	`unset($tableau[$nom]);`
479	`$this->setVariablesRequete($tableau);`	454	`$this->setVariablesRequete($tableau);`
480	`}`	455	`}`
481		456
482	`/**`	457	`/**`
483	`* Renvoie un représentation sous forme de chaine de l'URL`	458	`* Renvoie un représentation sous forme de chaine de l'URL`
484	`*`	459	`*`
485	`* @return string`	460	`* @return string`
486	`*/`	461	`*/`
487	`public function getURL()`	462	`public function getURL() {`
488	`{`	-
489	`// Voir RFC 3986, section 5.3`	463	`// Voir RFC 3986, section 5.3`
490	`$url = "";`	464	`$url = "";`
491		465
492	`if ($this->schema !== false) {`	466	`if ($this->schema !== false) {`
493	`$url .= $this->schema . ':';`	467	`$url .= $this->schema . ':';`
494	`}`	468	`}`
495		469
496	`$autorite = $this->getAutorite();`	470	`$autorite = $this->getAutorite();`
497	`if ($autorite !== false) {`	471	`if ($autorite !== false) {`
498	`$url .= '//' . $autorite;`	472	`$url .= '//' . $autorite;`
499	`}`	473	`}`

Subversion Repositories Applications.framework

(root)/trunk/framework/Url.php @ 340 – Rev 120 → 144