Subversion Repositories Applications.framework

Rev

Rev 359 | Rev 366 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 359 Rev 360
1 
<?php
 1 
<?php
2 
// declare(encoding='UTF-8');
 2 
// declare(encoding='UTF-8');
3 
/**
 3 
/**
4 
 * Classe principale gérant les services web de type (@link(REST, http://fr.wikipedia.org/wiki/Rest).
 4 
 * Classe principale gérant les services web de type (@link(REST, http://fr.wikipedia.org/wiki/Rest).
5 
 *
5 
 *
6 
 * Elle contient  :
 6 
 * Elle contient  :
7 
 *  - les constantes indiquant les différentes (@link(méthode HTTP, http://fr.wikipedia.org/wiki/Http) prises en compte.
 7 
 *  - les constantes indiquant les différentes (@link(méthode HTTP, http://fr.wikipedia.org/wiki/Http) prises en compte.
8 
 *  - les @link(codes HTTP des réponses, http://fr.wikipedia.org/wiki/Liste_des_codes_HTTP)
 8 
 *  - les @link(codes HTTP des réponses, http://fr.wikipedia.org/wiki/Liste_des_codes_HTTP)
9 
 *
9 
 *
10 
 * Ce serveur REST accepte 4 types de méthodes HTTP : GET, PUT, POST, DELETE.
 10 
 * Ce serveur REST accepte 4 types de méthodes HTTP : GET, PUT, POST, DELETE.
11 
 * GET et POST ne pose généralement pas de problème pour les clients HTTP mais ce n'est pas forcément le cas pour PUT et DELETE.
 11 
 * GET et POST ne pose généralement pas de problème pour les clients HTTP mais ce n'est pas forcément le cas pour PUT et DELETE.
12 
 * Vous pouvez donc pour réaliser :
 12 
 * Vous pouvez donc pour réaliser :
13 
 *  - DELETE : utiliser la méthode POST avec action=DELETE dans le corps de la requête.
 13 
 *  - DELETE : utiliser la méthode POST avec action=DELETE dans le corps de la requête.
14 
 *  - PUT : utiliser la méthode POST avec une url ne contenant aucune indication de ressource.
 14 
 *  - PUT : utiliser la méthode POST avec une url ne contenant aucune indication de ressource.
15 
 * Une autre solution consiste à utiliser n'importe quelle méthode et à ajouter l'entête "X_HTTP_METHOD_OVERRIDE" avec pour
15 
 * Une autre solution consiste à utiliser n'importe quelle méthode et à ajouter l'entête "X_HTTP_METHOD_OVERRIDE" avec pour
16 
 * valeur le nom de la méthode que vous souhaitez utiliser. Exemple d'entête : "X_HTTP_METHOD_OVERRIDE: PUT".
 16 
 * valeur le nom de la méthode que vous souhaitez utiliser. Exemple d'entête : "X_HTTP_METHOD_OVERRIDE: PUT".
17 
 * Exemple : <code>curl -v -v -H "X_HTTP_METHOD_OVERRIDE: DELETE" "http://www.mondomaine.org/services/apiVersion/[mon-service]/"</code>
 17 
 * Exemple : <code>curl -v -v -H "X_HTTP_METHOD_OVERRIDE: DELETE" "http://www.mondomaine.org/services/apiVersion/[mon-service]/"</code>
18 
 * Cela fonctionne avec Apache.
 18 
 * Cela fonctionne avec Apache.
19 
 *
19 
 *
20 
 * Les classes des services web doivent avoir un nom au format ChatMot "MonService" et être appelée dans l'url par le même nom
 20 
 * Les classes des services web doivent avoir un nom au format ChatMot "MonService" et être appelée dans l'url par le même nom
21 
 * en minuscule où les mots sont séparés par des tirets "mon-service".
 21 
 * en minuscule où les mots sont séparés par des tirets "mon-service".
22 
 *
22 
 *
23 
 * Paramètres liés dans config.ini :
 23 
 * Paramètres liés dans config.ini :
24 
 *  - serveur.baseURL : morceau de l'url pour appeler le serveur relative au domaine. Exemple : pour http://www.tela-botanica.org/mon_serveur/
 24 
 *  - serveur.baseURL : morceau de l'url pour appeler le serveur relative au domaine. Exemple : pour http://www.tela-botanica.org/mon_serveur/
25 
 *  	mettre : "/mon_serveur/"
 25 
 *  	mettre : "/mon_serveur/"
26 
 *  - serveur.baseAlternativeURL : sur le même principe que ci-dessus permet d'affecter une deuxième url (pour gérer des raccourci via htaccess)
 26 
 *  - serveur.baseAlternativeURL : sur le même principe que ci-dessus permet d'affecter une deuxième url (pour gérer des raccourci via htaccess)
27 
 *
27 
 *
28 
 * Encodage en entrée : utf8
 28 
 * Encodage en entrée : utf8
29 
 * Encodage en sortie : utf8
 29 
 * Encodage en sortie : utf8
30 
 *
30 
 *
31 
 * @category	Php 5.2
 31 
 * @category	Php 5.2
32 
 * @package	Framework
 32 
 * @package		Framework
33 
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
 33 
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
34 
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
 34 
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
35 
 * @license	GPL v3 <http://www.gnu.org/licenses/gpl.txt>
 35 
 * @license		GPL v3 <http://www.gnu.org/licenses/gpl.txt>
36 
 * @license	CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
 36 
 * @license		CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
37 
 * @since 		0.3
 37 
 * @since 		0.3
38 
 * @version	$Id: RestServeur.php 359 2011-08-30 13:53:45Z delphine $
 38 
 * @version		$Id: RestServeur.php 360 2011-09-01 13:30:16Z jpm $
39 
 * @link		/doc/framework/
 39 
 * @link		/doc/framework/
40 
 */
 40 
 */
41 
// TODO : gerer les retours : dans ce controleur : code retour et envoi ...
 41 
// TODO : gerer les retours : dans ce controleur : code retour et envoi ...
42 
class RestServeur {
 42 
class RestServeur {
43
43
44 
	/** Nom de la méthode appelée dans un service pour éxécuter une requête de type GET. */
 44 
	/** Nom de la méthode appelée dans un service pour éxécuter une requête de type GET. */
45 
	const METHODE_GET = 'consulter';
 45 
	const METHODE_GET = 'consulter';
46
46
47 
	/** Nom de la méthode appelée dans un service pour éxécuter une requête de type POST. */
 47 
	/** Nom de la méthode appelée dans un service pour éxécuter une requête de type POST. */
48 
	const METHODE_POST = 'modifier';
 48 
	const METHODE_POST = 'modifier';
49
49
50 
	/** Nom de la méthode appelée dans un service pour éxécuter une requête de type DELETE. */
 50 
	/** Nom de la méthode appelée dans un service pour éxécuter une requête de type DELETE. */
51 
	const METHODE_DELETE = 'supprimer';
 51 
	const METHODE_DELETE = 'supprimer';
52
52
53 
	/** Nom de la méthode appelée dans un service pour éxécuter une requête de type PUT. */
 53 
	/** Nom de la méthode appelée dans un service pour éxécuter une requête de type PUT. */
54 
	const METHODE_PUT = 'ajouter';
 54 
	const METHODE_PUT = 'ajouter';
55
55
56 
	/** Code HTTP 200 indiquant le succès de l'accès à un service web par la méthode GET.
 56 
	/** Code HTTP 200 indiquant le succès de l'accès à un service web par la méthode GET.
57 
	 * L'utiliser lors d'une requète de type GET (consulter) pour indiquer le succès de l'opération.
 57 
	 * L'utiliser lors d'une requète de type GET (consulter) pour indiquer le succès de l'opération.
58 
	 * Sera renvoyée par défaut par PHP. */
 58 
	 * Sera renvoyée par défaut par PHP. */
59 
	const HTTP_CODE_OK = '200';
 59 
	const HTTP_CODE_OK = '200';
60
60
61 
	/** Code HTTP 201 indiquant que l'accès à un service web est un succès et que la ressource a été créée ou modifié.
 61 
	/** Code HTTP 201 indiquant que l'accès à un service web est un succès et que la ressource a été créée ou modifié.
62 
	 * L'utiliser lors d'une requète de type PUT (ajouter) ou POST (modifier) pour indiquer le succès de l'opération. */
 62 
	 * L'utiliser lors d'une requète de type PUT (ajouter) ou POST (modifier) pour indiquer le succès de l'opération. */
63 
	const HTTP_CODE_CREATION_OK = '201';
 63 
	const HTTP_CODE_CREATION_OK = '201';
64
64
65 
	/** Code HTTP 204 indique que l'accès à un service web est un succès et qu'il n'y a pas de contenu à renvoyer.
 65 
	/** Code HTTP 204 indique que l'accès à un service web est un succès et qu'il n'y a pas de contenu à renvoyer.
66 
	 * L'utiliser lors d'une requète de type DELETE (supprimer) pour indiquer le succès de l'opération. */
 66 
	 * L'utiliser lors d'une requète de type DELETE (supprimer) pour indiquer le succès de l'opération. */
67 
	const HTTP_CODE_SUPPRESSION_OK = '204';
 67 
	const HTTP_CODE_SUPPRESSION_OK = '204';
68
68
69 
	/** Code HTTP 400 indique que les paramètres envoyés au service contiennent des erreurs.
 69 
	/** Code HTTP 400 indique que les paramètres envoyés au service contiennent des erreurs.
70 
	 * L'utiliser pour indiquer l'échec de l'accès au service. La réponse pourra contenir un message expliquant la source
70 
	 * L'utiliser pour indiquer l'échec de l'accès au service. La réponse pourra contenir un message expliquant la source
71 
	 * de l'erreur. */
 71 
	 * de l'erreur. */
72 
	const HTTP_CODE_MAUVAISE_REQUETE = '400';
 72 
	const HTTP_CODE_MAUVAISE_REQUETE = '400';
73
73
74 
	/** Code HTTP 401 indiquant que l'accès à un service web est refusé car l'authentification (obligatoire) a échoué pour
 74 
	/** Code HTTP 401 indiquant que l'accès à un service web est refusé car l'authentification (obligatoire) a échoué pour
75 
	 * accéder à la ressource. */
 75 
	 * accéder à la ressource. */
76 
	const HTTP_CODE_ACCES_NON_AUTORISE = '401';
 76 
	const HTTP_CODE_ACCES_NON_AUTORISE = '401';
77
77
78 
	/** Code HTTP 404 indiquant que la ressource indiquée par l'url est introuvable. */
 78 
	/** Code HTTP 404 indiquant que la ressource indiquée par l'url est introuvable. */
79 
	const HTTP_CODE_RESSOURCE_INTROUVABLE = '404';
 79 
	const HTTP_CODE_RESSOURCE_INTROUVABLE = '404';
80
80
81 
	/** Code HTTP 405 indiquant soit :
 81 
	/** Code HTTP 405 indiquant soit :
82 
	 *  - que le service web ne possède pas d'accès la ressource correspondant à la méthode HTTP employée.
 82 
	 *  - que le service web ne possède pas d'accès la ressource correspondant à la méthode HTTP employée.
83 
	 *  - que la méthode HTTP enployée n'est pas en accord avec la ressource indiquée par l'url. */
 83 
	 *  - que la méthode HTTP enployée n'est pas en accord avec la ressource indiquée par l'url. */
84 
	const HTTP_CODE_METHODE_NON_AUTORISE = '405';
 84 
	const HTTP_CODE_METHODE_NON_AUTORISE = '405';
85
85
86 
	/** Code d'erreur HTTP 409 indiquant qu'un conflit est survenu vis à vis de la ressource.
 86 
	/** Code d'erreur HTTP 409 indiquant qu'un conflit est survenu vis à vis de la ressource.
87 
	 * Par exemple, essayer de créer deux fois la même ressource ou bien tenter de modifier une ressource qui a été modifiée par
87 
	 * Par exemple, essayer de créer deux fois la même ressource ou bien tenter de modifier une ressource qui a été modifiée par
88 
	 * ailleurs. */
 88 
	 * ailleurs. */
89 
	const HTTP_CODE_CONFLIT = '409';
 89 
	const HTTP_CODE_CONFLIT = '409';
90
90
91 
	/** Code HTTP 411 indiquant que des paramètres passés dans le contenu de la requête sont nécessaires au service. */
 91 
	/** Code HTTP 411 indiquant que des paramètres passés dans le contenu de la requête sont nécessaires au service. */
92 
	const HTTP_CODE_CONTENU_REQUIS = '411';
 92 
	const HTTP_CODE_CONTENU_REQUIS = '411';
93
93
94 
	/** Code d'erreur HTTP 500 Internal Server Error.
 94 
	/** Code d'erreur HTTP 500 Internal Server Error.
95 
	 * L'utiliser quand le serveur ou un service soulève une erreur ou une exception. */
 95 
	 * L'utiliser quand le serveur ou un service soulève une erreur ou une exception. */
96 
	const HTTP_CODE_ERREUR = '500';
 96 
	const HTTP_CODE_ERREUR = '500';
- 
 
 97
- 
 
 98 
	/** Motif de l'epression régulière vérfiant la version de l'API. */
- 
 
 99 
	const MOTIF_API_VERSION = '/^[0-9]+(?:[.][0-9]+)*$/';
- 
 
 100
- 
 
 101 
	/** Motif de l'epression régulière vérfiant le nom du service. */
- 
 
 102 
	const MOTIF_SERVICE_NOM = '/^[a-z0-9]+(?:[-][a-z0-9]+)*$/';
97
103
98 
	/** Mettre à true pour activer l'affichage des messages d'erreurs et de débogage.
104 
	/** Mettre à true pour activer l'affichage des messages d'erreurs et de débogage.
99 
	 * @var boolean */
 105 
	 * @var boolean */
100 
	private static $debogageActivation = false;
 106 
	private static $debogageActivation = false;
101
107
102 
	/** Indiquer le mode de débogage à utiliser (@see Debug).
108 
	/** Indiquer le mode de débogage à utiliser (@see Debug).
103 
	 * @var string */
 109 
	 * @var string */
104 
	private static $debogageMode = '';
 110 
	private static $debogageMode = '';
105
111
106 
	/** La méthode de la requête HTTP utilisée.
112 
	/** La méthode de la requête HTTP utilisée.
107 
	 * @var string */
 113 
	 * @var string */
108 
	private $methode = 'GET';
 114 
	private $methode = 'GET';
109 
 
 115 
 
110 
	/** Le contenu brut du corps de la requête HTTP (s'il y en a).
 116 
	/** Le contenu brut du corps de la requête HTTP (s'il y en a).
111 
	 * @var array */
 117 
	 * @var array */
112 
	private $requeteDonnees = null;
 118 
	private $requeteDonnees = null;
113
119
114 
	/** Le contenu sous forme de tableau de paires clés-valeurs du corps de la requête HTTP (s'il y en a).
120 
	/** Le contenu sous forme de tableau de paires clés-valeurs du corps de la requête HTTP (s'il y en a).
115 
	 * @var array */
 121 
	 * @var array */
116 
	private $requeteDonneesParsees = null;
 122 
	private $requeteDonneesParsees = null;
117 
 
 123 
 
118 
	/** Version de l'API demandée.
 124 
	/** Version de l'API demandée.
119 
	 * Ex. http://www.mondomaine.org/services/[apiVersion]/mon-service/
 125 
	 * Ex. http://www.mondomaine.org/services/[apiVersion]/mon-service/
120 
	 * @var mixed Généralement deux nombres séparés par un point. Ex. : 1.0
 126 
	 * @var mixed Généralement deux nombres séparés par un point. Ex. : 1.0
121 
	 */
 127 
	 */
122 
	private $apiVersion = null;
 128 
	private $apiVersion = null;
123 
 
 129 
 
124 
	/** Nom du service demandé.
130 
	/** Nom du service demandé.
125 
	 * Ex. http://www.mondomaine.org/services/apiVersion/[mon-service]/
 131 
	 * Ex. http://www.mondomaine.org/services/apiVersion/[mon-service]/
126 
	 * @var string par défaut vaut null.
 132 
	 * @var string par défaut vaut null.
127 
	 */
 133 
	 */
128 
	private $service = null;
 134 
	private $service = null;
129
135
130 
	/** Morceaux de l'url servant à préciser la ressource concerné pour le service demandé.
 136 
	/** Morceaux de l'url servant à préciser la ressource concerné pour le service demandé.
131 
	 * Ex. http://www.mondomaine.org/services/apiVersion/mon-service/[maRessource/maSousResource...]
 137 
	 * Ex. http://www.mondomaine.org/services/apiVersion/mon-service/[maRessource/maSousResource...]
132 
	 * @var array
 138 
	 * @var array
133 
	 */
 139 
	 */
134 
	private $ressources = array();
 140 
	private $ressources = array();
135
141
136 
	/** Partie de l'url situé après le '?' servant à paramétrer le service demandé.
 142 
	/** Partie de l'url situé après le '?' servant à paramétrer le service demandé.
137 
	 * Ex. http://www.mondomaine.org/services/apiVersion/mon-service?monParametre1=maValeur1&monParametre2=maValeur2
 143 
	 * Ex. http://www.mondomaine.org/services/apiVersion/mon-service?monParametre1=maValeur1&monParametre2=maValeur2
138 
	 * @var array
 144 
	 * @var array
139 
	 */
 145 
	 */
140 
	private $parametres = array();
 146 
	private $parametres = array();
141
147
142 
	/** Tableau contenant les paramètres de configuration du serveur.
 148 
	/** Tableau contenant les paramètres de configuration du serveur.
143 
	 * @var array
 149 
	 * @var array
144 
	 */
 150 
	 */
145 
	private static $config = array();
 151 
	private static $config = array();
- 
 
 152 
 
- 
 
 153 
	/** Tableau contenant les messages d'erreur et/ou d'avertissement du Serveur.
- 
 
 154 
	 * @var array
- 
 
 155 
	 * */
- 
 
 156 
	private static $messages = array();
146
157
147 
	/** Codes HTTP. */
 158 
	/** Codes HTTP. */
148 
	private static $http10 = array(
 159 
	private static $http10 = array(
149 
		self::HTTP_CODE_OK => 'OK',
160 
		self::HTTP_CODE_OK => 'OK',
150 
		self::HTTP_CODE_CREATION_OK => 'Created',
 161 
		self::HTTP_CODE_CREATION_OK => 'Created',
151 
		self::HTTP_CODE_SUPPRESSION_OK => 'No Content',
 162 
		self::HTTP_CODE_SUPPRESSION_OK => 'No Content',
152 
		self::HTTP_CODE_MAUVAISE_REQUETE => 'Bad Request',
 163 
		self::HTTP_CODE_MAUVAISE_REQUETE => 'Bad Request',
153 
		self::HTTP_CODE_ACCES_NON_AUTORISE => 'Unauthorized',
 164 
		self::HTTP_CODE_ACCES_NON_AUTORISE => 'Unauthorized',
154 
		self::HTTP_CODE_RESSOURCE_INTROUVABLE => 'Not Found',
 165 
		self::HTTP_CODE_RESSOURCE_INTROUVABLE => 'Not Found',
155 
		self::HTTP_CODE_METHODE_NON_AUTORISE => 'Method Not Allowed',
 166 
		self::HTTP_CODE_METHODE_NON_AUTORISE => 'Method Not Allowed',
156 
		self::HTTP_CODE_CONFLIT => 'Conflict',
 167 
		self::HTTP_CODE_CONFLIT => 'Conflict',
157 
		self::HTTP_CODE_CONTENU_REQUIS => 'Length Required',
 168 
		self::HTTP_CODE_CONTENU_REQUIS => 'Length Required',
158 
		self::HTTP_CODE_ERREUR => 'Internal Server Error'
 169 
		self::HTTP_CODE_ERREUR => 'Internal Server Error'
159 
	);
 170 
	);
160
171
161 
	/** Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.*/
 172 
	/** Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.*/
162 
	private $parametres_obligatoires = array('debogage', 'debogage_mode', 'serveur.baseURL', 'chemin_modules');
 173 
	private $parametres_obligatoires = array('debogage', 'debogage_mode', 'serveur.baseURL', 'chemin_modules');
163 
 
 174 
 
164 
	/**
 175 
	/**
165 
	 * Analyse les données envoyées au serveur, enregistre la méthode HTTP utilisée pour appeler le serveur et parse
 176 
	 * Analyse les données envoyées au serveur, enregistre la méthode HTTP utilisée pour appeler le serveur et parse
166 
	 * l'url appelée pour trouver le service demandé.
 177 
	 * l'url appelée pour trouver le service demandé.
167 
	 */
 178 
	 */
168 
	public function __construct() {
 179 
	public function __construct() {
169 
		Config::verifierPresenceParametres($this->parametres_obligatoires);
 180 
		Config::verifierPresenceParametres($this->parametres_obligatoires);
170
181
171 
		self::$debogageActivation = Config::get('debogage');
 182 
		self::$debogageActivation = Config::get('debogage');
172 
		self::$debogageMode = Config::get('debogage_mode');
 183 
		self::$debogageMode = Config::get('debogage_mode');
173 
 
 184 
 
174 
		if (isset($_SERVER['REQUEST_URI']) && isset($_SERVER['REQUEST_METHOD']) && isset($_SERVER['QUERY_STRING'])) {
 185 
		if (isset($_SERVER['REQUEST_URI']) && isset($_SERVER['REQUEST_METHOD']) && isset($_SERVER['QUERY_STRING'])) {
175 
			$this->initialiserMethode();
 186 
			$this->initialiserMethode();
176 
			$this->initialiserRequeteDonnees();
 187 
			$this->initialiserRequeteDonnees();
177
188
178 
			$urlParts = $this->decouperUrlChemin();
 189 
			$urlParts = $this->decouperUrlChemin();
- 
 
 190
179 
			$this->initialiserApiVersion(array_shift($urlParts));
 191 
			$this->initialiserApiVersion(array_shift($urlParts));
180 
			$this->initialiserServiceNom(array_shift($urlParts));
 192 
			$this->initialiserServiceNom(array_shift($urlParts));
181 
			$this->initialiserRessource($urlParts);
 193 
			$this->initialiserRessource($urlParts);
182
194
183 
			$this->initialiserParametres();
 195 
			$this->initialiserParametres();
184 
			// Enregistrement en première position des autoload de la méthode gérant les classes des services
196 
			// Enregistrement en première position des autoload de la méthode gérant les classes des services
185 
			spl_autoload_register(array(get_class(), 'chargerClasse'));
 197 
			spl_autoload_register(array(get_class(), 'chargerClasse'));
186 
		} else {
 198 
		} else {
- 
 
 199 
			self::envoyerEnteteStatutHttp(self::HTTP_CODE_ERREUR);
187 
			$e = "La classe Serveur du TBFRamework nécessite, pour fonctionner, l'accès aux variables serveurs REQUEST_URI, REQUEST_METHOD et QUERY_STRING.";
 200 
			$e = "La classe Serveur du TBFRamework nécessite, pour fonctionner, l'accès aux variables serveurs REQUEST_URI, REQUEST_METHOD et QUERY_STRING.";
188 
			trigger_error($e, E_USER_ERROR);
 201 
			self::ajouterMessage($e);
189 
		}
 202 
		}
190 
	}
 203 
	}
191
204
192 
	private function initialiserMethode() {
 205 
	private function initialiserMethode() {
193 
		if (isset($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE']) && count(trim($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE'])) > 0) {
 206 
		if (isset($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE']) && count(trim($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE'])) > 0) {
194 
			$this->methode = trim($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE']);
 207 
			$this->methode = trim($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE']);
195 
		} else {
 208 
		} else {
196 
			$this->methode = $_SERVER['REQUEST_METHOD'];
 209 
			$this->methode = $_SERVER['REQUEST_METHOD'];
197 
		}
 210 
		}
198 
	}
 211 
	}
199
212
200 
	private function initialiserRequeteDonnees() {
 213 
	private function initialiserRequeteDonnees() {
201 
		if (isset($_SERVER['CONTENT_LENGTH']) && $_SERVER['CONTENT_LENGTH'] > 0) {
 214 
		if (isset($_SERVER['CONTENT_LENGTH']) && $_SERVER['CONTENT_LENGTH'] > 0) {
202 
			$this->requeteDonnees = '';
 215 
			$this->requeteDonnees = '';
203 
			$httpContent = fopen('php://input', 'r');
 216 
			$httpContent = fopen('php://input', 'r');
204 
			while ($data = fread($httpContent, 1024)) {
 217 
			while ($data = fread($httpContent, 1024)) {
205 
				$this->requeteDonnees .= $data;
 218 
				$this->requeteDonnees .= $data;
206 
			}
 219 
			}
207 
			fclose($httpContent);
 220 
			fclose($httpContent);
208 
		}
 221 
		}
209 
	}
 222 
	}
210
223
211 
	private function decouperUrlChemin() {
 224 
	private function decouperUrlChemin() {
212 
		if (isset($_SERVER['REDIRECT_URL']) && $_SERVER['REDIRECT_URL'] != '') {
 225 
		if (isset($_SERVER['REDIRECT_URL']) && $_SERVER['REDIRECT_URL'] != '') {
213 
			if (isset($_SERVER['REDIRECT_QUERY_STRING']) && !empty($_SERVER['REDIRECT_QUERY_STRING'])) {
 226 
			if (isset($_SERVER['REDIRECT_QUERY_STRING']) && !empty($_SERVER['REDIRECT_QUERY_STRING'])) {
214 
				$url = $_SERVER['REDIRECT_URL'].'?'.$_SERVER['REDIRECT_QUERY_STRING'];
 227 
				$url = $_SERVER['REDIRECT_URL'].'?'.$_SERVER['REDIRECT_QUERY_STRING'];
215 
			} else {
 228 
			} else {
216 
				$url = $_SERVER['REDIRECT_URL'];
 229 
				$url = $_SERVER['REDIRECT_URL'];
217 
			}
 230 
			}
218 
		} else {
 231 
		} else {
219 
			$url = $_SERVER['REQUEST_URI'];
 232 
			$url = $_SERVER['REQUEST_URI'];
220 
		}
 233 
		}
221 
		//echo '<pre>'; print_r($_SERVER); echo '</pre>';
 - 
 
- 
 
 234
222 
		if (strlen($_SERVER['QUERY_STRING']) == 0) {
 235 
		if (strlen($_SERVER['QUERY_STRING']) == 0) {
223 
			$tailleURL = strlen($url);
 236 
			$tailleURL = strlen($url);
224 
		} else {
 237 
		} else {
225 
			$tailleURL = -(strlen($_SERVER['QUERY_STRING']) + 1);
 238 
			$tailleURL = -(strlen($_SERVER['QUERY_STRING']) + 1);
226 
		}
 239 
		}
227 
		//echo '<br/>url : '.$url;
 - 
 
- 
 
 240
228 
		$urlChaine = '';
 241 
		$urlChaine = '';
229 
		if (strpos($url, Config::get('serveur.baseURL')) !== false) {
 242 
		if (strpos($url, Config::get('serveur.baseURL')) !== false) {
230 
			$urlChaine = substr($url, strlen(Config::get('serveur.baseURL')), $tailleURL);
 243 
			$urlChaine = substr($url, strlen(Config::get('serveur.baseURL')), $tailleURL);
231 
		} else if (strpos($url, Config::get('serveur.baseAlternativeURL')) !== false) {
 244 
		} else if (strpos($url, Config::get('serveur.baseAlternativeURL')) !== false) {
232 
			$urlChaine = substr($url, strlen(Config::get('serveur.baseAlternativeURL')), $tailleURL);
 245 
			$urlChaine = substr($url, strlen(Config::get('serveur.baseAlternativeURL')), $tailleURL);
233 
		}
 246 
		}
234 
		return explode('/', $urlChaine);
 247 
		return explode('/', $urlChaine);
235 
	}
 248 
	}
236
249
237 
	private function initialiserApiVersion($apiVersion) {
 250 
	private function initialiserApiVersion($apiVersion) {
238 
		if (isset($apiVersion) && !empty($apiVersion)) {
 251 
		if ($this->verifierApiVersion($apiVersion)) {
239 
			$this->apiVersion = $apiVersion;
 252 
			$this->apiVersion = $apiVersion;
240 
			self::$config['chemins']['api'] = Config::get('chemin_modules').$this->apiVersion.DS;
 253 
			self::$config['chemins']['api'] = Config::get('chemin_modules').$this->apiVersion.DS;
241 
		} else {
 254 
		} else {
- 
 
 255 
			self::envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
- 
 
 256 
			$e = "Aucune version d'API n'a été spécifiée.\n".
- 
 
 257 
				"La version doit respecter l'expression régulière suivante : ".self::MOTIF_API_VERSION.".\n".
242 
			$e = "Aucune version d'API n'a été spécifié dans l'url qui doit avoir la forme suivante http://www.mondomaine.org/services/apiVersion/monService/";
 258 
			  	"L'url doit avoir la forme suivante : http://www.mondomaine.org/services/apiVersion/monService/";
- 
 
 259 
			self::ajouterMessage($e);
243 
			trigger_error($e, E_USER_ERROR);
 260 
			self::cloreAccesServeur();
- 
 
 261 
		}
- 
 
 262 
	}
- 
 
 263
- 
 
 264 
	private function verifierApiVersion($apiVersion) {
- 
 
 265 
		$apiOk = false;
- 
 
 266 
		if (isset($apiVersion) && !empty($apiVersion) && preg_match(self::MOTIF_API_VERSION, $apiVersion)) {
- 
 
 267 
			$apiOk = true;
244 
		}
 268 
		}
- 
 
 269 
		return $apiOk;
245 
	}
 270 
	}
246
271
247 
	private function initialiserServiceNom($serviceNom) {
 272 
	private function initialiserServiceNom($serviceNom) {
248 
		if (isset($serviceNom) && !empty($serviceNom)) {
 273 
		if ($this->verifierServiceNom($serviceNom)) {
249 
			$this->service = $this->traiterNomService($serviceNom);
 274 
			$this->service = $this->traiterNomService($serviceNom);
250 
		} else {
 275 
		} else {
- 
 
 276 
			self::envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
- 
 
 277 
			$e = "Aucune nom de service n'a été spécifié.\n".
- 
 
 278 
				"La nom du service doit respecter l'expression régulière suivante : ".self::MOTIF_SERVICE_NOM.".\n".
251 
			$e = "Aucun service n'a été spécifié dans l'url qui doit avoir la forme suivante http://www.mondomaine.org/services/apiVersion/monService/";
 279 
			  	"L'url doit avoir la forme suivante : http://www.mondomaine.org/services/apiVersion/monService/";
- 
 
 280 
			self::ajouterMessage($e);
252 
			trigger_error($e, E_USER_ERROR);
 281 
			self::cloreAccesServeur();
- 
 
 282 
		}
- 
 
 283 
	}
- 
 
 284
- 
 
 285 
	private function verifierServiceNom($serviceNom) {
- 
 
 286 
		$serviceNomOk = false;
- 
 
 287 
		if (isset($serviceNom) && !empty($serviceNom) && preg_match(self::MOTIF_SERVICE_NOM, $serviceNom)) {
- 
 
 288 
			$serviceNomOk = true;
253 
		}
 289 
		}
- 
 
 290 
		return $serviceNomOk;
254 
	}
 291 
	}
255
292
256 
	private function traiterNomService($serviceNom) {
 293 
	private function traiterNomService($serviceNom) {
257 
		return str_replace(' ', '', ucwords(str_replace('-', ' ', strtolower($serviceNom))));
 294 
		return str_replace(' ', '', ucwords(str_replace('-', ' ', strtolower($serviceNom))));
258 
	}
 295 
	}
259
296
260 
	private function initialiserRessource($urlParts) {
 297 
	private function initialiserRessource($urlParts) {
261 
		if (is_array($urlParts) && count($urlParts) > 0) {
 298 
		if (is_array($urlParts) && count($urlParts) > 0) {
262 
			foreach ($urlParts as $ressource) {
 299 
			foreach ($urlParts as $ressource) {
263 
				// Ne pas utiliser empty() car valeur 0 acceptée
 300 
				// Ne pas utiliser empty() car valeur 0 acceptée
264 
				if ($ressource != '') {
 301 
				if ($ressource != '') {
265 
					$this->ressources[] = urldecode($ressource);
 302 
					$this->ressources[] = urldecode($ressource);
266 
				}
 303 
				}
267 
			}
 304 
			}
268 
		}
 305 
		}
269 
	}
 306 
	}
270
307
271 
	private function initialiserParametres() {
 308 
	private function initialiserParametres() {
272 
		$this->nettoyerGet();
 309 
		$this->nettoyerGet();
273 
		$this->parametres = $_GET;
 310 
		$this->parametres = $_GET;
274 
	}
 311 
	}
275
312
276 
	private function nettoyerGet() {
 313 
	private function nettoyerGet() {
277 
		// Pas besoin d'utiliser urldecode car déjà fait par php pour les clés et valeur de $_GET
314 
		// Pas besoin d'utiliser urldecode car déjà fait par php pour les clés et valeur de $_GET
278 
		if (isset($_GET) && count($_GET) > 0) {
 315 
		if (isset($_GET) && count($_GET) > 0) {
279 
			foreach ($_GET as $cle => $valeur) {
 316 
			foreach ($_GET as $cle => $valeur) {
280 
				$verifier = array('NULL', "\n", "\r", "\\", "'", '"', "\x00", "\x1a", ';');
 317 
				$verifier = array('NULL', "\n", "\r", "\\", "'", '"', "\x00", "\x1a", ';');
281 
				$_GET[$cle] = strip_tags(str_replace($verifier, '', $valeur));
 318 
				$_GET[$cle] = strip_tags(str_replace($verifier, '', $valeur));
282 
			}
 319 
			}
283 
		}
 320 
		}
284 
	}
 321 
	}
285
322
286 
	/**
 323 
	/**
287 
	* La méthode __autoload() charge dynamiquement les classes trouvées dans le code.
 324 
	* La méthode __autoload() charge dynamiquement les classes trouvées dans le code.
288 
	* Cette fonction est appelée par php5 quand il trouve une instanciation de classe dans le code.
 325 
	* Cette fonction est appelée par php5 quand il trouve une instanciation de classe dans le code.
289 
	*
 326 
	*
290 
	*@param string le nom de la classe appelée.
 327 
	*@param string le nom de la classe appelée.
291 
	*@return void le fichier contenant la classe doit être inclu par la fonction.
 328 
	*@return void le fichier contenant la classe doit être inclu par la fonction.
292 
	*/
 329 
	*/
293 
	public static function chargerClasse($classe) {
 330 
	public static function chargerClasse($classe) {
294 
		if (class_exists($classe)) {
 331 
		if (class_exists($classe)) {
295 
			return null;
 332 
			return null;
296 
		}
 333 
		}
297 
 
 - 
 
- 
 
 334 
		$classeTrouvee = false;
298 
		$chemins = array('', self::$config['chemins']['api']);
 335 
		$chemins = array('', self::$config['chemins']['api']);
299 
		foreach ($chemins as $chemin) {
 336 
		foreach ($chemins as $chemin) {
300 
			$chemin = $chemin.$classe.'.php';
 337 
			$chemin = $chemin.$classe.'.php';
301 
			if (file_exists($chemin)) {
 338 
			if (file_exists($chemin)) {
302 
				require_once $chemin;
 339 
				require_once $chemin;
- 
 
 340 
				$classeTrouvee = true;
303 
			}
 341 
			}
304 
		}
 342 
		}
- 
 
 343 
		if ($classeTrouvee === false) {
- 
 
 344 
			self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
- 
 
 345 
			$e = "La classe '$classe' du service n'a pas été trouvée par le serveur.\n".
- 
 
 346 
				"Cela peut signifier que le nom du service saisi comporte une erreur.";
- 
 
 347 
			self::ajouterMessage($e);
- 
 
 348 
			self::cloreAccesServeur();
- 
 
 349 
		}
305 
	}
 350 
	}
306
351
307 
	/**
 352 
	/**
308 
	 * Execute la requête.
 353 
	 * Execute la requête.
309 
	 */
 354 
	 */
310 
	function executer() {
 355 
	public function executer() {
311 
		switch ($this->methode) {
 356 
		switch ($this->methode) {
312 
			case 'GET':
 357 
			case 'GET':
313 
				$this->get();
 358 
				$this->get();
314 
				break;
 359 
				break;
315 
			case 'POST':
 360 
			case 'POST':
316 
				$this->post();
 361 
				$this->post();
317 
				break;
 362 
				break;
318 
			case 'DELETE':
 363 
			case 'DELETE':
319 
				$this->delete();
 364 
				$this->delete();
320 
				break;
 365 
				break;
321 
			case 'PUT':
 366 
			case 'PUT':
322 
				$this->put();
 367 
				$this->put();
323 
				break;
 368 
				break;
324 
			default :
 369 
			default :
- 
 
 370 
				self::envoyerEnteteStatutHttp(self::HTTP_CODE_METHODE_NON_AUTORISE);
- 
 
 371 
				header('Allow: GET, POST, DELETE, PUT');
325 
				$e = "La méthode HTTP '{$this->methode}' n'est pas prise en compte par ce serveur REST.";
 372 
				$e = "La méthode HTTP '{$this->methode}' n'est pas prise en compte par ce serveur REST.\n".
- 
 
 373 
					"Consulter l'entête Allow pour connaître les méthodes autorisées.";
326 
				trigger_error($e, E_USER_WARNING);
 374 
				self::ajouterMessage($e);
327 
		}
 375 
		}
328 
		// 	Affichage des exceptions et erreurs générées par les services
 - 
 
329 
		$this->gererErreurs();
 376 
		$this->cloreAccesServeur();
330 
	}
 377 
	}
331 
 
 378 
 
332 
	/**
 379 
	/**
333 
	 * Execute a GET request. A GET request fetches a list of resource when no resource name is given, a list of element
 380 
	 * Execute a GET request. A GET request fetches a list of resource when no resource name is given, a list of element
334 
	 * when a resource name is given, or a resource element when a resource and resource unique identifier are given. It does not change the
 381 
	 * when a resource name is given, or a resource element when a resource and resource unique identifier are given. It does not change the
335 
	 * database contents.
 382 
	 * database contents.
336 
	 */
 383 
	 */
337 
	private function get() {
 384 
	private function get() {
338 
		if ($this->service != null) {
 385 
		if ($this->service != null) {
339 
			$Service = new $this->service(self::$config);
 386 
			$Service = new $this->service(self::$config);
340 
			if (method_exists($Service, self::METHODE_GET)) {
 387 
			if (method_exists($Service, self::METHODE_GET)) {
341 
				$methodeGet = self::METHODE_GET;
 388 
				$methodeGet = self::METHODE_GET;
342 
				$Service->$methodeGet($this->ressources, $this->parametres);
 389 
				$Service->$methodeGet($this->ressources, $this->parametres);
343 
			} else {
 390 
			} else {
- 
 
 391 
				self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
344 
				$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_GET."' nécessaire ".
 392 
				$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_GET."' nécessaire ".
345 
					"lors de l'appel du service via la méthode HTTP GET.";
 393 
					"lors de l'appel du service via la méthode HTTP GET.";
346 
				trigger_error($e, E_USER_ERROR);
 394 
				self::ajouterMessage($e);
347 
			}
 395 
			}
348 
		}
 396 
		}
349 
	}
 397 
	}
350 
 
 398 
 
351 
	private function post() {
 399 
	private function post() {
352 
		$paires = $this->parserDonneesRequete();
 400 
		$paires = $this->parserDonneesRequete();
353 
 
 - 
 
354 
		if (count($paires) != 0) {
 401 
		if (count($paires) != 0) {
355 
			if (isset($paires['action']) && $paires['action'] == 'DELETE') {// Altnative à l'utilisation de DELETE
 402 
			if (isset($paires['action']) && $paires['action'] == 'DELETE') {// Altnative à l'utilisation de DELETE
356 
				$this->delete();
 403 
				$this->delete();
357 
			} else if (count($this->ressources) == 0) {// Altnative à l'utilisation de PUT
 404 
			} else if (count($this->ressources) == 0) {// Altnative à l'utilisation de PUT
358 
				$this->put();
 405 
				$this->put();
359 
			} else {
 406 
			} else {
360 
				if ($this->service != null) {
 407 
				if ($this->service != null) {
361 
					$Service = new $this->service(self::$config);
 408 
					$Service = new $this->service(self::$config);
362 
					if (method_exists($Service, self::METHODE_POST)) {
 409 
					if (method_exists($Service, self::METHODE_POST)) {
363 
						$methodePost = self::METHODE_POST;
 410 
						$methodePost = self::METHODE_POST;
364 
						if ($Service->$methodePost($this->ressources, $paires)) {
 411 
						$info = $Service->$methodePost($this->ressources, $paires);
- 
 
 412 
						if ($info === true) {
365 
							$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CREATION_OK);
 413 
							$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CREATION_OK);
366 
						}
 414 
						}
367 
					} else {
 415 
					} else {
- 
 
 416 
						self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
368 
						$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_POST."' nécessaire ".
 417 
						$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_POST."' nécessaire ".
369 
							"lors de l'appel du service via la méthode HTTP POST.";
 418 
							"lors de l'appel du service via la méthode HTTP GET.";
370 
						trigger_error($e, E_USER_ERROR);
 419 
						self::ajouterMessage($e);
371 
					}
 420 
					}
372 
				}
 421 
				}
373 
			}
422 
			}
374 
		} else {
 423 
		} else {
375 
			$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CONTENU_REQUIS);
 424 
			$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CONTENU_REQUIS);
- 
 
 425 
			$e = "Le service '{$this->service}' requiert de fournir le contenu à modifier dans le corps ".
- 
 
 426 
				"de la requête avec la méthode HTTP POST.";
- 
 
 427 
			self::ajouterMessage($e);
376 
		}
 428 
		}
377 
	}
 429 
	}
378 
 
 430 
 
379 
	private function put() {
 431 
	private function put() {
380 
		$paires = $this->parserDonneesRequete();
 432 
		$paires = $this->parserDonneesRequete();
381 
 
 - 
 
382 
		if (count($paires) != 0) {
 433 
		if (count($paires) != 0) {
383 
			if ($this->service != null) {
 434 
			if ($this->service != null) {
384 
				$Service = new $this->service(self::$config);
 435 
				$Service = new $this->service(self::$config);
385 
				if (method_exists($Service, self::METHODE_PUT)) {
 436 
				if (method_exists($Service, self::METHODE_PUT)) {
386 
					$methodePut = self::METHODE_PUT;
 437 
					$methodePut = self::METHODE_PUT;
387 
					if ($Service->$methodePut($this->ressources, $paires)) {
 438 
					$info = $Service->$methodePut($this->ressources, $paires);
- 
 
 439 
					if ($info === true) {
388 
						$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CREATION_OK);
 440 
						$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CREATION_OK);
389 
					}
 441 
					}
390 
				} else {
 442 
				} else {
- 
 
 443 
					self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
391 
					$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_PUT."' nécessaire ".
 444 
					$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_PUT."' nécessaire ".
392 
						"lors de l'appel du service via la méthode HTTP PUT (ou équivalant).";
 445 
						"lors de l'appel du service via la méthode HTTP GET.";
393 
					trigger_error($e, E_USER_ERROR);
 446 
					self::ajouterMessage($e);
394 
				}
 447 
				}
395 
			}
 448 
			}
396 
		} else {
 449 
		} else {
397 
			$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CONTENU_REQUIS);
 450 
			$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CONTENU_REQUIS);
- 
 
 451 
			$e = "Il est nécessaire de fournir du contenu dans le corps de la requête pour créer une nouvelle ressource.";
- 
 
 452 
			self::ajouterMessage($e);
398 
		}
 453 
		}
399 
	}
 454 
	}
400 
 
 455 
 
401 
	private function delete() {
 456 
	private function delete() {
402 
		if (count($this->ressources) != 0) {
 457 
		if (count($this->ressources) != 0) {
403 
			if ($this->service != null) {
 458 
			if ($this->service != null) {
404 
				$Service = new $this->service(self::$config);
 459 
				$Service = new $this->service(self::$config);
405 
				if (method_exists($Service, self::METHODE_DELETE)) {
 460 
				if (method_exists($Service, self::METHODE_DELETE)) {
406 
					$methodeDelete = self::METHODE_DELETE;
 461 
					$methodeDelete = self::METHODE_DELETE;
407 
					if ($Service->$methodeDelete($this->ressources, $paires)) {
 462 
					$info = $Service->$methodeDelete($this->ressources);
- 
 
 463 
					if ($info === true) {
408 
						$this->envoyerEnteteStatutHttp(self::HTTP_CODE_SUPPRESSION_OK);
 464 
						$this->envoyerEnteteStatutHttp(self::HTTP_CODE_SUPPRESSION_OK);
409 
					} else {
 465 
					} else if ($info === false) {
410 
						$this->envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
 466 
						$this->envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
- 
 
 467 
						$e = "La ressource à supprimer est introuvable. Il se peut qu'elle ait été préalablement supprimé.";
- 
 
 468 
						self::ajouterMessage($e);
411 
					}
 469 
					}
412 
				} else {
 470 
				} else {
- 
 
 471 
					self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
413 
					$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_DELETE."' nécessaire ".
 472 
					$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_DELETE."' nécessaire ".
414 
						"lors de l'appel du service via la méthode HTTP DELETE (ou équivalant).";
 473 
						"lors de l'appel du service via la méthode HTTP GET.";
415 
					trigger_error($e, E_USER_ERROR);
 474 
					self::ajouterMessage($e);
416 
				}
 475 
				}
417 
			}
 476 
			}
418 
		} else {
 477 
		} else {
419 
			$this->envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
 478 
			$this->envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
- 
 
 479 
			$e = "Il est nécessaire d'indiquer dans l'url la ressource à supprimer.";
- 
 
 480 
			self::ajouterMessage($e);
420 
		}
 481 
		}
421 
	}
 482 
	}
422
483
423 
	/**
 484 
	/**
424 
	 * Parse les données contenu dans le corps de la requête HTTP (= POST) en :
 485 
	 * Parse les données contenu dans le corps de la requête HTTP (= POST) en :
425 
	 *  - décodant les clés et valeurs.
 486 
	 *  - décodant les clés et valeurs.
426 
	 *  - supprimant les espaces en début et fin des clés et des valeurs.
 487 
	 *  - supprimant les espaces en début et fin des clés et des valeurs.
427 
	 *
488 
	 *
428 
	 * @return array Tableau de paires clé et valeur.
 489 
	 * @return array Tableau de paires clé et valeur.
429 
	 */
 490 
	 */
430 
	private function parserDonneesRequete() {
 491 
	private function parserDonneesRequete() {
431 
		$donnees = array();
 492 
		$donnees = array();
432 
		if ($this->requeteDonneesParsees != null) {
 493 
		if ($this->requeteDonneesParsees != null) {
433 
			$donnees = $this->requeteDonneesParsees;
 494 
			$donnees = $this->requeteDonneesParsees;
434 
		} else if ($this->requeteDonnees != null) {
 495 
		} else if ($this->requeteDonnees != null) {
435 
			$paires = explode('&', $this->requeteDonnees);
 496 
			$paires = explode('&', $this->requeteDonnees);
436 
			foreach ($paires as $paire) {
 497 
			foreach ($paires as $paire) {
437 
				list($cle, $valeur) = explode('=', $paire);
 498 
				list($cle, $valeur) = explode('=', $paire);
438 
				$cle = (isset($cle)) ? trim(urldecode($cle)) : '';
 499 
				$cle = (isset($cle)) ? trim(urldecode($cle)) : '';
439 
				$valeur = (isset($valeur)) ? trim(urldecode($valeur)) : '';
 500 
				$valeur = (isset($valeur)) ? trim(urldecode($valeur)) : '';
440 
				$donnees[$cle] = $valeur;
 501 
				$donnees[$cle] = $valeur;
441 
			}
 502 
			}
442 
			$this->requeteDonneesParsees = $donnees;
 503 
			$this->requeteDonneesParsees = $donnees;
443 
		}
 504 
		}
444 
		return $donnees;
 505 
		return $donnees;
445 
	}
 506 
	}
446
507
447 
	/**
 508 
	/**
448 
	 * Envoyer un entête HTTP (version 1.0) de statut.
 509 
	 * Envoyer un entête HTTP (version 1.0) de statut.
449 
	 * Il remplacera systématiquement tout entête HTTP de statut précédement envoyé.
 510 
	 * Il remplacera systématiquement tout entête HTTP de statut précédement envoyé.
450 
	 * @param int $code entier indiquant le code du statut de l'entête HTTP à envoyer.
511 
	 * @param int $code entier indiquant le code du statut de l'entête HTTP à envoyer.
451 
	 */
 512 
	 */
452 
	public static function envoyerEnteteStatutHttp($code) {
 513 
	public static function envoyerEnteteStatutHttp($code) {
453 
		if (isset(self::$http10[$code])) {
 514 
		if (isset(self::$http10[$code])) {
454 
			$txt = self::$http10[$code];
 515 
			$txt = self::$http10[$code];
455 
			header("HTTP/1.0 $code $txt", true);
 516 
			header("HTTP/1.0 $code $txt", true);
456 
		}
 517 
		}
457 
	}
 518 
	}
458
519
459 
	/**
 520 
	/**
- 
 
 521 
	 * Termine l'accès au serveur après envoir envoyer les messages.
- 
 
 522 
	 */
- 
 
 523 
	private static function cloreAccesServeur() {
- 
 
 524 
		// 	Gestion des exceptions et erreurs générées par les services
- 
 
 525 
		self::gererErreurs();
- 
 
 526 
		// Envoie des messages d'erreur et d'avertissement du serveur
- 
 
 527 
		self::envoyerMessages();
- 
 
 528 
		// Nous terminons le script
- 
 
 529 
		exit(0);
- 
 
 530 
	}
- 
 
 531
- 
 
 532 
	/**
460 
	 * Si des exceptions ou des erreurs sont soulevées par le serveur ou les services, elles sont gérées par cette méthode.
 533 
	 * Si des exceptions ou des erreurs sont soulevées par le serveur ou les services, elles sont gérées par cette méthode.
461 
	 * Si nous avec des erreurs d'un type différent d'E_USER_NOTICE (réservé au débogage), elle sont renvoyées sur la sortie
534 
	 * Si nous avec des erreurs d'un type différent d'E_USER_NOTICE (réservé au débogage), elle sont renvoyées sur la sortie
462 
	 * standard (via echo).
 535 
	 * standard (via echo).
463 
	 * Si seulement des erreurs de type E_USER_NOTICE, sont présentes, elle sont envoyées en fonction du contenu du paramètre de
536 
	 * Si seulement des erreurs de type E_USER_NOTICE, sont présentes, elle sont envoyées en fonction du contenu du paramètre de
464 
	 * config "debogage_mode" :
 537 
	 * config "debogage_mode" :
465 
	 *  - Debug::MODE_ECHO : les messages sont affichés en utilisant echo au moment où ils sont déclenchés dans le code.
538 
	 *  - Debug::MODE_ECHO : les messages sont affichés en utilisant echo au moment où ils sont déclenchés dans le code.
466 
	 *  - Debug::MODE_NOTICE : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type
539 
	 *  - Debug::MODE_NOTICE : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type
467 
	 *  E_USER_NOTICE et sont renvoyés sur la sortie standard à la fin de l'execution du programme (via echo).
 540 
	 *  E_USER_NOTICE et sont renvoyés sur la sortie standard à la fin de l'execution du programme (via echo).
468 
	 *  - Debug::MODE_ENTETE_HTTP : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type
541 
	 *  - Debug::MODE_ENTETE_HTTP : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type
469 
	 *  E_USER_NOTICE et sont renvoyés dans un entête HTTP (X_REST_DEBOGAGE_MESSAGES) à la fin de l'execution du programme.
 542 
	 *  E_USER_NOTICE et sont renvoyés dans un entête HTTP (X_REST_DEBOGAGE_MESSAGES) à la fin de l'execution du programme.
470 
	 *  - Autre valeur : les messages sont formatés puis retournés par la fonction de débogage (à vous de les afficher).
 543 
	 *  - Autre valeur : les messages sont formatés puis retournés par la fonction de débogage (à vous de les afficher).
471 
	 */
 544 
	 */
472 
	public static function gererErreurs() {
 545 
	public static function gererErreurs() {
473 
		if (self::$debogageActivation && GestionnaireException::getExceptionsNbre() > 0) {
 546 
		if (self::$debogageActivation && GestionnaireException::getExceptionsNbre() > 0) {
474 
			$exceptionsTriees = GestionnaireException::getExceptionsTriees();
 547 
			$exceptionsTriees = GestionnaireException::getExceptionsTriees();
475 
			reset($exceptionsTriees);
 548 
			reset($exceptionsTriees);
476 
			$debogageSeulement = true;
 549 
			$debogageSeulement = true;
477 
			if (array_key_exists(E_USER_ERROR, $exceptionsTriees)) {
 550 
			if (array_key_exists(E_USER_ERROR, $exceptionsTriees)) {
478 
				self::envoyerEnteteStatutHttp(self::HTTP_CODE_ERREUR);
 551 
				self::envoyerEnteteStatutHttp(self::HTTP_CODE_ERREUR);
479 
				$debogageSeulement = false;
 552 
				$debogageSeulement = false;
480 
			}
 553 
			}
481
554
482 
			$exceptionsFormatees = array();
 555 
			$exceptionsFormatees = array();
483 
			foreach ($exceptionsTriees as $exceptions) {
 556 
			foreach ($exceptionsTriees as $exceptions) {
484 
				foreach ($exceptions as $e) {
 557 
				foreach ($exceptions as $e) {
485 
					if ($debogageSeulement && self::$debogageMode == Debug::MODE_ENTETE_HTTP) {
 558 
					if ($debogageSeulement && self::$debogageMode == Debug::MODE_ENTETE_HTTP) {
486 
						$exceptionsFormatees[] = GestionnaireException::formaterExceptionTxt($e);
 559 
						$exceptionsFormatees[] = GestionnaireException::formaterExceptionTxt($e);
487 
					} else {
 560 
					} else {
488 
						echo GestionnaireException::formaterExceptionXhtml($e);
 561 
						echo GestionnaireException::formaterExceptionXhtml($e);
489 
					}
 562 
					}
490 
				}
 563 
				}
491 
			}
 564 
			}
492
565
493 
			if ($debogageSeulement && self::$debogageMode == Debug::MODE_ENTETE_HTTP) {
 566 
			if ($debogageSeulement && self::$debogageMode == Debug::MODE_ENTETE_HTTP) {
494 
				header('X_REST_DEBOGAGE_MESSAGES: '.json_encode($exceptionsFormatees));
 567 
				header('X_REST_DEBOGAGE_MESSAGES: '.json_encode($exceptionsFormatees));
495 
			}
 568 
			}
496 
		}
 569 
		}
- 
 
 570 
	}
- 
 
 571
- 
 
 572
- 
 
 573 
	/**
- 
 
 574 
	 * Permet d'ajouter un message d'erreur ou d'avertissement qui sera envoyé au client.
- 
 
 575 
	 * Le message doit être au format texte et en UTF-8.
- 
 
 576 
	 * @param string $message le message à envoyer.
- 
 
 577 
	 */
- 
 
 578 
	public static function ajouterMessage($message) {
- 
 
 579 
		if (isset($message) && !empty($message)) {
- 
 
 580 
			self::$messages[] = $message;
- 
 
 581 
		}
- 
 
 582 
	}
- 
 
 583
- 
 
 584 
	/**
- 
 
 585 
	 * Envoie au client les éventuels messages d'erreur et d'avertissement du Serveur.
- 
 
 586 
	 * Le format d'envoie est text/plain encodé en UTF-8.
- 
 
 587 
	 */
- 
 
 588 
	private static function envoyerMessages() {
- 
 
 589 
		if (count(self::$messages) > 0) {
- 
 
 590 
			header("Content-Type: text/plain; charset=utf-8");
- 
 
 591 
			print implode("\n", self::$messages);
- 
 
 592 
		}
497 
	}
 593 
	}
498 
}
 594 
}
499 
?>
 595 
?>