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

Subversion Repositories Applications.framework

(root)/trunk/framework/Url.php @ 196 – Rev 149 → 150