WebSVN – Applications.framework – Diff – /branches/v0.2-buhl/doc/PhpDoc/files/Url.php.txt


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

Subversion Repositories Applications.framework

(root)/branches/v0.2-buhl/doc/PhpDoc/files/Url.php.txt – Rev 467 → 476