Subversion Repositories Applications.framework

Rev

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

Rev 399 Rev 409
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 399 2011-11-18 10:41:59Z jpm $
 38 
 * @version		$Id: RestServeur.php 409 2012-02-28 10:06:45Z 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 
 
 97 
 
98 
	/** Motif de l'epression régulière vérfiant la version de l'API. */
 98 
	/** Motif de l'epression régulière vérfiant la version de l'API. */
99 
	const MOTIF_API_VERSION = '/^[0-9]+(?:[.][0-9]+)*$/';
 99 
	const MOTIF_API_VERSION = '/^[0-9]+(?:[.][0-9]+)*$/';
100 
 
 100 
 
101 
	/** Motif de l'epression régulière vérfiant le nom du service. */
 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]+)*$/';
 102 
	const MOTIF_SERVICE_NOM = '/^[a-z0-9]+(?:[-][a-z0-9]+)*$/';
103 
 
 103 
 
104 
	/** 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.
105 
	 * @var boolean */
 105 
	 * @var boolean */
106 
	private static $debogageActivation = false;
 106 
	private static $debogageActivation = false;
107 
 
 107 
 
108 
	/** Indiquer le mode de débogage à utiliser (@see Debug).
 108 
	/** Indiquer le mode de débogage à utiliser (@see Debug).
109 
	 * @var string */
 109 
	 * @var string */
110 
	private static $debogageMode = '';
 110 
	private static $debogageMode = '';
111 
 
 111 
 
112 
	/** La méthode de la requête HTTP utilisée.
 112 
	/** La méthode de la requête HTTP utilisée.
113 
	 * @var string */
 113 
	 * @var string */
114 
	private $methode = 'GET';
 114 
	private $methode = 'GET';
115 
 
 115 
 
116 
	/** 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).
117 
	 * @var array */
 117 
	 * @var array */
118 
	private $requeteDonnees = null;
 118 
	private $requeteDonnees = null;
119 
 
 119 
 
120 
	/** 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).
121 
	 * @var array */
 121 
	 * @var array */
122 
	private $requeteDonneesParsees = null;
 122 
	private $requeteDonneesParsees = null;
123 
 
 123 
 
124 
	/** Version de l'API demandée.
 124 
	/** Version de l'API demandée.
125 
	 * Ex. http://www.mondomaine.org/services/[apiVersion]/mon-service/
 125 
	 * Ex. http://www.mondomaine.org/services/[apiVersion]/mon-service/
126 
	 * @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
127 
	 */
 127 
	 */
128 
	private $apiVersion = null;
 128 
	private $apiVersion = null;
129 
 
 129 
 
130 
	/** Nom du service demandé.
 130 
	/** Nom du service demandé.
131 
	 * Ex. http://www.mondomaine.org/services/apiVersion/[mon-service]/
 131 
	 * Ex. http://www.mondomaine.org/services/apiVersion/[mon-service]/
132 
	 * @var string par défaut vaut null.
 132 
	 * @var string par défaut vaut null.
133 
	 */
 133 
	 */
134 
	private $service = null;
 134 
	private $service = null;
135 
 
 135 
 
136 
	/** 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é.
137 
	 * Ex. http://www.mondomaine.org/services/apiVersion/mon-service/[maRessource/maSousResource...]
 137 
	 * Ex. http://www.mondomaine.org/services/apiVersion/mon-service/[maRessource/maSousResource...]
138 
	 * @var array
 138 
	 * @var array
139 
	 */
 139 
	 */
140 
	private $ressources = array();
 140 
	private $ressources = array();
141 
 
 141 
 
142 
	/** 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é.
143 
	 * Les données proviennent de $_GET où les caractères suivant ont été transformé en '_' undescrore dans les clés :
 143 
	 * Les données proviennent de $_GET où les caractères suivant ont été transformé en '_' undescrore dans les clés :
144 
	 * - chr(32) ( ) (space)
 144 
	 * - chr(32) ( ) (space)
145 
	 * - chr(46) (.) (dot)
 145 
	 * - chr(46) (.) (dot)
146 
	 * - chr(91) ([) (open square bracket)
 146 
	 * - chr(91) ([) (open square bracket)
147 
	 * - chr(128) - chr(159) (various)
 147 
	 * - chr(128) - chr(159) (various)
148 
	 * En outre nous appliquons la méthode nettoyerGet() qui effectue d'autres remplacement dans les valeurs.
 148 
	 * En outre nous appliquons la méthode nettoyerGet() qui effectue d'autres remplacement dans les valeurs.
149 
	 * Ex. http://www.mondomaine.org/services/apiVersion/mon-service?monParametre1=maValeur1&monParametre2=maValeur2
 149 
	 * Ex. http://www.mondomaine.org/services/apiVersion/mon-service?monParametre1=maValeur1&monParametre2=maValeur2
150 
	 * @see parametresBruts
 150 
	 * @see parametresBruts
151 
	 * @var array
 151 
	 * @var array
152 
	 */
 152 
	 */
153 
	private $parametres = array();
 153 
	private $parametres = array();
154 
 
 154 
 
155 
	/** Partie de l'url situé après le '?' servant à paramétrer le service demandé.
 155 
	/** Partie de l'url situé après le '?' servant à paramétrer le service demandé.
156 
	 * Les données proviennent de $_SERVER['QUERY_STRING'] et n'ont subies aucune transformation au niveau des clés.
 156 
	 * Les données proviennent de $_SERVER['QUERY_STRING'] et n'ont subies aucune transformation au niveau des clés.
157 
	 * Cependant nous appliquons la méthode nettoyerGet() qui effectue d'autres remplacement dans les valeurs.
 157 
	 * Cependant nous appliquons la méthode nettoyerGet() qui effectue d'autres remplacement dans les valeurs.
158 
	 * Ex. http://www.mondomaine.org/services/apiVersion/mon-service?monParametre1=maValeur1&monParametre2=maValeur2
 158 
	 * Ex. http://www.mondomaine.org/services/apiVersion/mon-service?monParametre1=maValeur1&monParametre2=maValeur2
159 
	 * @see parametres
 159 
	 * @see parametres
160 
	 * @var array
 160 
	 * @var array
161 
	 */
 161 
	 */
162 
	private $parametresBruts = array();
 162 
	private $parametresBruts = array();
163 
 
 163 
 
164 
	/** Tableau contenant les paramètres de configuration du serveur.
 164 
	/** Tableau contenant les paramètres de configuration du serveur.
165 
	 * @var array
 165 
	 * @var array
166 
	 */
 166 
	 */
167 
	private static $config = array();
 167 
	private static $config = array();
168 
 
 168 
 
169 
	/** Tableau contenant les messages d'erreur et/ou d'avertissement du Serveur.
 169 
	/** Tableau contenant les messages d'erreur et/ou d'avertissement du Serveur.
170 
	 * @var array
 170 
	 * @var array
171 
	 * */
 171 
	 * */
172 
	private static $messages = array();
 172 
	private static $messages = array();
173 
 
 173 
 
174 
	/** Codes HTTP. */
 174 
	/** Codes HTTP. */
175 
	private static $http10 = array(
 175 
	private static $http10 = array(
176 
		self::HTTP_CODE_OK => 'OK',
 176 
		self::HTTP_CODE_OK => 'OK',
177 
		self::HTTP_CODE_CREATION_OK => 'Created',
 177 
		self::HTTP_CODE_CREATION_OK => 'Created',
178 
		self::HTTP_CODE_SUPPRESSION_OK => 'No Content',
 178 
		self::HTTP_CODE_SUPPRESSION_OK => 'No Content',
179 
		self::HTTP_CODE_MAUVAISE_REQUETE => 'Bad Request',
 179 
		self::HTTP_CODE_MAUVAISE_REQUETE => 'Bad Request',
180 
		self::HTTP_CODE_ACCES_NON_AUTORISE => 'Unauthorized',
 180 
		self::HTTP_CODE_ACCES_NON_AUTORISE => 'Unauthorized',
181 
		self::HTTP_CODE_RESSOURCE_INTROUVABLE => 'Not Found',
 181 
		self::HTTP_CODE_RESSOURCE_INTROUVABLE => 'Not Found',
182 
		self::HTTP_CODE_METHODE_NON_AUTORISE => 'Method Not Allowed',
 182 
		self::HTTP_CODE_METHODE_NON_AUTORISE => 'Method Not Allowed',
183 
		self::HTTP_CODE_CONFLIT => 'Conflict',
 183 
		self::HTTP_CODE_CONFLIT => 'Conflict',
184 
		self::HTTP_CODE_CONTENU_REQUIS => 'Length Required',
 184 
		self::HTTP_CODE_CONTENU_REQUIS => 'Length Required',
185 
		self::HTTP_CODE_ERREUR => 'Internal Server Error'
 185 
		self::HTTP_CODE_ERREUR => 'Internal Server Error'
186 
	);
 186 
	);
187 
 
 187 
 
188 
	/** Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.*/
 188 
	/** Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.*/
189 
	private $parametres_obligatoires = array('debogage', 'debogage_mode', 'serveur.baseURL', 'chemin_modules');
 189 
	private $parametres_obligatoires = array('debogage', 'debogage_mode', 'serveur.baseURL', 'chemin_modules');
190 
 
 190 
 
191 
	/**
 191 
	/**
192 
	 * Analyse les données envoyées au serveur, enregistre la méthode HTTP utilisée pour appeler le serveur et parse
 192 
	 * Analyse les données envoyées au serveur, enregistre la méthode HTTP utilisée pour appeler le serveur et parse
193 
	 * l'url appelée pour trouver le service demandé.
 193 
	 * l'url appelée pour trouver le service demandé.
194 
	 */
 194 
	 */
195 
	public function __construct() {
 195 
	public function __construct() {
196 
		Config::verifierPresenceParametres($this->parametres_obligatoires);
 196 
		Config::verifierPresenceParametres($this->parametres_obligatoires);
197 
 
 197 
 
198 
		self::$debogageActivation = Config::get('debogage');
 198 
		self::$debogageActivation = Config::get('debogage');
199 
		self::$debogageMode = Config::get('debogage_mode');
 199 
		self::$debogageMode = Config::get('debogage_mode');
200 
 
 200 
 
201 
		if (isset($_SERVER['REQUEST_URI']) && isset($_SERVER['REQUEST_METHOD']) && isset($_SERVER['QUERY_STRING'])) {
 201 
		if (isset($_SERVER['REQUEST_URI']) && isset($_SERVER['REQUEST_METHOD']) && isset($_SERVER['QUERY_STRING'])) {
202 
			$this->initialiserMethode();
 202 
			$this->initialiserMethode();
203 
			$this->initialiserRequeteDonnees();
 203 
			$this->initialiserRequeteDonnees();
204 
 
 204 
 
205 
			$urlParts = $this->decouperUrlChemin();
 205 
			$urlParts = $this->decouperUrlChemin();
206 
 
 206 
 
207 
			$this->initialiserApiVersion(array_shift($urlParts));
 207 
			$this->initialiserApiVersion(array_shift($urlParts));
208 
			$this->initialiserServiceNom(array_shift($urlParts));
 208 
			$this->initialiserServiceNom(array_shift($urlParts));
209 
			$this->initialiserRessource($urlParts);
 209 
			$this->initialiserRessource($urlParts);
210 
 
 210 
 
211 
			$this->initialiserParametres();
 211 
			$this->initialiserParametres();
212 
			// Enregistrement en première position des autoload de la méthode gérant les classes des services
 212 
			// Enregistrement en première position des autoload de la méthode gérant les classes des services
213 
			spl_autoload_register(array(get_class(), 'chargerClasse'));
 213 
			spl_autoload_register(array(get_class(), 'chargerClasse'));
214 
		} else {
 214 
		} else {
215 
			self::envoyerEnteteStatutHttp(self::HTTP_CODE_ERREUR);
 215 
			self::envoyerEnteteStatutHttp(self::HTTP_CODE_ERREUR);
216 
			$e = "La classe Serveur du TBFRamework nécessite, pour fonctionner, l'accès aux variables serveurs REQUEST_URI, REQUEST_METHOD et QUERY_STRING.";
 216 
			$e = "La classe Serveur du TBFRamework nécessite, pour fonctionner, l'accès aux variables serveurs REQUEST_URI, REQUEST_METHOD et QUERY_STRING.";
217 
			self::ajouterMessage($e);
 217 
			self::ajouterMessage($e);
218 
		}
 218 
		}
219 
	}
 219 
	}
220 
 
 220 
 
221 
	private function initialiserMethode() {
 221 
	private function initialiserMethode() {
222 
		if (isset($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE']) && count(trim($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE'])) > 0) {
 222 
		if (isset($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE']) && count(trim($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE'])) > 0) {
223 
			$this->methode = trim($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE']);
 223 
			$this->methode = trim($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE']);
224 
		} else {
 224 
		} else {
225 
			$this->methode = $_SERVER['REQUEST_METHOD'];
 225 
			$this->methode = $_SERVER['REQUEST_METHOD'];
226 
		}
 226 
		}
227 
	}
 227 
	}
228 
 
 228 
 
229 
	private function initialiserRequeteDonnees() {
 229 
	private function initialiserRequeteDonnees() {
230 
		if (isset($_SERVER['CONTENT_LENGTH']) && $_SERVER['CONTENT_LENGTH'] > 0) {
 230 
		if (isset($_SERVER['CONTENT_LENGTH']) && $_SERVER['CONTENT_LENGTH'] > 0) {
231 
			$this->requeteDonnees = '';
 231 
			$this->requeteDonnees = '';
232 
			$httpContent = fopen('php://input', 'r');
 232 
			$httpContent = fopen('php://input', 'r');
233 
			while ($data = fread($httpContent, 1024)) {
 233 
			while ($data = fread($httpContent, 1024)) {
234 
				$this->requeteDonnees .= $data;
 234 
				$this->requeteDonnees .= $data;
235 
			}
 235 
			}
236 
			fclose($httpContent);
 236 
			fclose($httpContent);
237 
		}
 237 
		}
238 
	}
 238 
	}
239 
 
 239 
 
240 
	private function decouperUrlChemin() {
 240 
	private function decouperUrlChemin() {
241 
		if (isset($_SERVER['REDIRECT_URL']) && $_SERVER['REDIRECT_URL'] != '') {
 241 
		if (isset($_SERVER['REDIRECT_URL']) && $_SERVER['REDIRECT_URL'] != '') {
242 
			if (isset($_SERVER['REDIRECT_QUERY_STRING']) && !empty($_SERVER['REDIRECT_QUERY_STRING'])) {
 242 
			if (isset($_SERVER['REDIRECT_QUERY_STRING']) && !empty($_SERVER['REDIRECT_QUERY_STRING'])) {
243 
				$url = $_SERVER['REDIRECT_URL'].'?'.$_SERVER['REDIRECT_QUERY_STRING'];
 243 
				$url = $_SERVER['REDIRECT_URL'].'?'.$_SERVER['REDIRECT_QUERY_STRING'];
244 
			} else {
 244 
			} else {
245 
				$url = $_SERVER['REDIRECT_URL'];
 245 
				$url = $_SERVER['REDIRECT_URL'];
246 
			}
 246 
			}
247 
		} else {
 247 
		} else {
248 
			$url = $_SERVER['REQUEST_URI'];
 248 
			$url = $_SERVER['REQUEST_URI'];
249 
		}
 249 
		}
250 
 
 250 
 
251 
		if (strlen($_SERVER['QUERY_STRING']) == 0) {
 251 
		if (strlen($_SERVER['QUERY_STRING']) == 0) {
252 
			$tailleURL = strlen($url);
 252 
			$tailleURL = strlen($url);
253 
		} else {
 253 
		} else {
254 
			$tailleURL = -(strlen($_SERVER['QUERY_STRING']) + 1);
 254 
			$tailleURL = -(strlen($_SERVER['QUERY_STRING']) + 1);
255 
		}
 255 
		}
256 
 
 256 
 
257 
		$urlChaine = '';
 257 
		$urlChaine = '';
258 
		if (strpos($url, Config::get('serveur.baseURL')) !== false) {
 258 
		if (strpos($url, Config::get('serveur.baseURL')) !== false) {
259 
			$urlChaine = substr($url, strlen(Config::get('serveur.baseURL')), $tailleURL);
 259 
			$urlChaine = substr($url, strlen(Config::get('serveur.baseURL')), $tailleURL);
260 
		} else if (strpos($url, Config::get('serveur.baseAlternativeURL')) !== false) {
 260 
		} else if (strpos($url, Config::get('serveur.baseAlternativeURL')) !== false) {
261 
			$urlChaine = substr($url, strlen(Config::get('serveur.baseAlternativeURL')), $tailleURL);
 261 
			$urlChaine = substr($url, strlen(Config::get('serveur.baseAlternativeURL')), $tailleURL);
262 
		}
 262 
		}
263 
		return explode('/', $urlChaine);
 263 
		return explode('/', $urlChaine);
264 
	}
 264 
	}
265 
 
 265 
 
266 
	private function initialiserApiVersion($apiVersion) {
 266 
	private function initialiserApiVersion($apiVersion) {
267 
		if ($this->verifierApiVersion($apiVersion)) {
 267 
		if ($this->verifierApiVersion($apiVersion)) {
268 
			$this->apiVersion = $apiVersion;
 268 
			$this->apiVersion = $apiVersion;
269 
			self::$config['chemins']['api'] = Config::get('chemin_modules').$this->apiVersion.DS;
 269 
			self::$config['chemins']['api'] = Config::get('chemin_modules').$this->apiVersion.DS;
270 
		} else {
 270 
		} else {
271 
			self::envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
 271 
			self::envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
272 
			$e = "Aucune version d'API n'a été spécifiée.\n".
 272 
			$e = "Aucune version d'API n'a été spécifiée.\n".
273 
				"La version doit respecter l'expression régulière suivante : ".self::MOTIF_API_VERSION.".\n".
 273 
				"La version doit respecter l'expression régulière suivante : ".self::MOTIF_API_VERSION.".\n".
274 
			  	"L'url doit avoir la forme suivante : http://www.mondomaine.org/services/apiVersion/monService/";
 274 
			  	"L'url doit avoir la forme suivante : http://www.mondomaine.org/services/apiVersion/monService/";
275 
			self::ajouterMessage($e);
 275 
			self::ajouterMessage($e);
276 
			self::cloreAccesServeur();
 276 
			self::cloreAccesServeur();
277 
		}
 277 
		}
278 
	}
 278 
	}
279 
 
 279 
 
280 
	private function verifierApiVersion($apiVersion) {
 280 
	private function verifierApiVersion($apiVersion) {
281 
		$apiOk = false;
 281 
		$apiOk = false;
282 
		if (isset($apiVersion) && !empty($apiVersion) && preg_match(self::MOTIF_API_VERSION, $apiVersion)) {
 282 
		if (isset($apiVersion) && !empty($apiVersion) && preg_match(self::MOTIF_API_VERSION, $apiVersion)) {
283 
			$apiOk = true;
 283 
			$apiOk = true;
284 
		}
 284 
		}
285 
		return $apiOk;
 285 
		return $apiOk;
286 
	}
 286 
	}
287 
 
 287 
 
288 
	private function initialiserServiceNom($serviceNom) {
 288 
	private function initialiserServiceNom($serviceNom) {
289 
		if ($this->verifierServiceNom($serviceNom)) {
 289 
		if ($this->verifierServiceNom($serviceNom)) {
290 
			$this->service = $this->traiterNomService($serviceNom);
 290 
			$this->service = $this->traiterNomService($serviceNom);
291 
		} else {
 291 
		} else {
292 
			self::envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
 292 
			self::envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
293 
			$e = "Aucune nom de service n'a été spécifié.\n".
 293 
			$e = "Aucune nom de service n'a été spécifié.\n".
294 
				"La nom du service doit respecter l'expression régulière suivante : ".self::MOTIF_SERVICE_NOM.".\n".
 294 
				"La nom du service doit respecter l'expression régulière suivante : ".self::MOTIF_SERVICE_NOM.".\n".
295 
			  	"L'url doit avoir la forme suivante : http://www.mondomaine.org/services/apiVersion/monService/";
 295 
			  	"L'url doit avoir la forme suivante : http://www.mondomaine.org/services/apiVersion/monService/";
296 
			self::ajouterMessage($e);
 296 
			self::ajouterMessage($e);
297 
			self::cloreAccesServeur();
 297 
			self::cloreAccesServeur();
298 
		}
 298 
		}
299 
	}
 299 
	}
300 
 
 300 
 
301 
	private function verifierServiceNom($serviceNom) {
 301 
	private function verifierServiceNom($serviceNom) {
302 
		$serviceNomOk = false;
 302 
		$serviceNomOk = false;
303 
		if (isset($serviceNom) && !empty($serviceNom) && preg_match(self::MOTIF_SERVICE_NOM, $serviceNom)) {
 303 
		if (isset($serviceNom) && !empty($serviceNom) && preg_match(self::MOTIF_SERVICE_NOM, $serviceNom)) {
304 
			$serviceNomOk = true;
 304 
			$serviceNomOk = true;
305 
		}
 305 
		}
306 
		return $serviceNomOk;
 306 
		return $serviceNomOk;
307 
	}
 307 
	}
308 
 
 308 
 
309 
	private function traiterNomService($serviceNom) {
 309 
	private function traiterNomService($serviceNom) {
310 
		return str_replace(' ', '', ucwords(str_replace('-', ' ', strtolower($serviceNom))));
 310 
		return str_replace(' ', '', ucwords(str_replace('-', ' ', strtolower($serviceNom))));
311 
	}
 311 
	}
312 
 
 312 
 
313 
	private function initialiserRessource($urlParts) {
 313 
	private function initialiserRessource($urlParts) {
314 
		if (is_array($urlParts) && count($urlParts) > 0) {
 314 
		if (is_array($urlParts) && count($urlParts) > 0) {
315 
			foreach ($urlParts as $ressource) {
 315 
			foreach ($urlParts as $ressource) {
316 
				// Ne pas utiliser empty() car valeur 0 acceptée
 316 
				// Ne pas utiliser empty() car valeur 0 acceptée
317 
				if ($ressource != '') {
 317 
				if ($ressource != '') {
318 
					$this->ressources[] = urldecode($ressource);
 318 
					$this->ressources[] = urldecode($ressource);
319 
				}
 319 
				}
320 
			}
 320 
			}
321 
		}
 321 
		}
322 
	}
 322 
	}
323 
 
 323 
 
324 
	private function initialiserParametres() {
 324 
	private function initialiserParametres() {
325 
		$this->parametres = $this->recupererParametresGet();
 325 
		$this->parametres = $this->recupererParametresGet();
326 
		$this->parametresBruts = $this->recupererParametresBruts();
 326 
		$this->parametresBruts = $this->recupererParametresBruts();
327 
	}
 327 
	}
328 
 
 328 
 
329 
	private function recupererParametresGet() {
 329 
	private function recupererParametresGet() {
330 
		$_GET = $this->nettoyerParametres($_GET);
 330 
		$_GET = $this->nettoyerParametres($_GET);
331 
		return $_GET;
 331 
		return $_GET;
332 
	}
 332 
	}
333 
 
 333 
 
334 
	private function nettoyerParametres(Array $parametres) {
 334 
	private function nettoyerParametres(Array $parametres) {
335 
		// Pas besoin d'utiliser urldecode car déjà fait par php pour les clés et valeur de $_GET
 335 
		// Pas besoin d'utiliser urldecode car déjà fait par php pour les clés et valeur de $_GET
336 
		if (isset($parametres) && count($parametres) > 0) {
 336 
		if (isset($parametres) && count($parametres) > 0) {
337 
			foreach ($parametres as $cle => $valeur) {
 337 
			foreach ($parametres as $cle => $valeur) {
338 
				$verifier = array('NULL', "\n", "\r", "\\", "'", '"', "\x00", "\x1a", ';');
 338 
				$verifier = array('NULL', "\n", "\r", "\\", "'", '"', "\x00", "\x1a", ';');
339 
				$parametres[$cle] = strip_tags(str_replace($verifier, '', $valeur));
 339 
				$parametres[$cle] = strip_tags(str_replace($verifier, '', $valeur));
340 
			}
 340 
			}
341 
		}
 341 
		}
342 
		return $parametres;
 342 
		return $parametres;
343 
	}
 343 
	}
344 
 
 344 
 
345 
	private function recupererParametresBruts() {
 345 
	private function recupererParametresBruts() {
346 
		$parametres_bruts = array();
 346 
		$parametres_bruts = array();
347 
		if (!empty($_SERVER['QUERY_STRING'])) {
 347 
		if (!empty($_SERVER['QUERY_STRING'])) {
348 
			$paires = explode('&', $_SERVER['QUERY_STRING']);
 348 
			$paires = explode('&', $_SERVER['QUERY_STRING']);
349 
			foreach ($paires as $paire) {
 349 
			foreach ($paires as $paire) {
350 
				$nv = explode('=', $paire);
 350 
				$nv = explode('=', $paire);
351 
				$nom = urldecode($nv[0]);
 351 
				$nom = urldecode($nv[0]);
352 
				$valeur = urldecode($nv[1]);
 352 
				$valeur = urldecode($nv[1]);
353 
				$parametres_bruts[$nom] = $valeur;
 353 
				$parametres_bruts[$nom] = $valeur;
354 
			}
 354 
			}
355 
			$parametres_bruts = $this->nettoyerParametres($parametres_bruts);
 355 
			$parametres_bruts = $this->nettoyerParametres($parametres_bruts);
356 
		}
 356 
		}
357 
		return $parametres_bruts;
 357 
		return $parametres_bruts;
358 
	}
 358 
	}
359 
 
 359 
 
360 
	/**
 360 
	/**
361 
	* La méthode __autoload() charge dynamiquement les classes trouvées dans le code.
 361 
	* La méthode __autoload() charge dynamiquement les classes trouvées dans le code.
362 
	* Cette fonction est appelée par php5 quand il trouve une instanciation de classe dans le code.
 362 
	* Cette fonction est appelée par php5 quand il trouve une instanciation de classe dans le code.
363 
	*
 363 
	*
364 
	*@param string le nom de la classe appelée.
 364 
	*@param string le nom de la classe appelée.
365 
	*@return void le fichier contenant la classe doit être inclu par la fonction.
 365 
	*@return void le fichier contenant la classe doit être inclu par la fonction.
366 
	*/
 366 
	*/
367 
	public static function chargerClasse($classe) {
 367 
	public static function chargerClasse($classe) {
368 
		if (class_exists($classe)) {
 368 
		if (class_exists($classe)) {
369 
			return null;
 369 
			return null;
370 
		}
 370 
		}
371 
		$classeTrouvee = false;
 - 
 
372 
		$chemins = array('', self::$config['chemins']['api']);
 371 
		$chemins = array('', self::$config['chemins']['api']);
373 
		foreach ($chemins as $chemin) {
 372 
		foreach ($chemins as $chemin) {
374 
			$chemin = $chemin.$classe.'.php';
 373 
			$chemin = $chemin.$classe.'.php';
375 
			if (file_exists($chemin)) {
 374 
			if (file_exists($chemin)) {
376 
				require_once $chemin;
 375 
				require_once $chemin;
377 
				$classeTrouvee = true;
 - 
 
378 
			}
 376 
			}
379 
		}
 377 
		}
380 
		if ($classeTrouvee === false && phpversion() >= 5.3) {
 - 
 
381 
			self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
 - 
 
382 
			$e = "La classe '$classe' du service n'a pas été trouvée par le serveur.\n".
 - 
 
383 
				"Cela peut signifier que le nom du service saisi comporte une erreur.";
 - 
 
384 
			self::ajouterMessage($e);
 - 
 
385 
			self::cloreAccesServeur();
 - 
 
386 
		}
 - 
 
387 
	}
 378 
	}
388 
 
 379 
 
389 
	/**
 380 
	/**
390 
	 * Execute la requête.
 381 
	 * Execute la requête.
391 
	 */
 382 
	 */
392 
	public function executer() {
 383 
	public function executer() {
393 
		$retour = '';
 384 
		$retour = '';
394 
		switch ($this->methode) {
 385 
		switch ($this->methode) {
395 
			case 'GET':
 386 
			case 'GET':
396 
				$retour = $this->get();
 387 
				$retour = $this->get();
397 
				break;
 388 
				break;
398 
			case 'POST':
 389 
			case 'POST':
399 
				$this->post();
 390 
				$this->post();
400 
				break;
 391 
				break;
401 
			case 'DELETE':
 392 
			case 'DELETE':
402 
				$this->delete();
 393 
				$this->delete();
403 
				break;
 394 
				break;
404 
			case 'PUT':
 395 
			case 'PUT':
405 
				$retour = $this->put();
 396 
				$retour = $this->put();
406 
				break;
 397 
				break;
407 
			default :
 398 
			default :
408 
				self::envoyerEnteteStatutHttp(self::HTTP_CODE_METHODE_NON_AUTORISE);
 399 
				self::envoyerEnteteStatutHttp(self::HTTP_CODE_METHODE_NON_AUTORISE);
409 
				header('Allow: GET, POST, DELETE, PUT');
 400 
				header('Allow: GET, POST, DELETE, PUT');
410 
				$e = "La méthode HTTP '{$this->methode}' n'est pas prise en compte par ce serveur REST.\n".
 401 
				$e = "La méthode HTTP '{$this->methode}' n'est pas prise en compte par ce serveur REST.\n".
411 
					"Consulter l'entête Allow pour connaître les méthodes autorisées.";
 402 
					"Consulter l'entête Allow pour connaître les méthodes autorisées.";
412 
				self::ajouterMessage($e);
 403 
				self::ajouterMessage($e);
413 
		}
 404 
		}
414 
		$this->cloreAccesServeur($retour);
 405 
		$this->cloreAccesServeur($retour);
415 
	}
 406 
	}
416 
 
 407 
 
417 
	/**
 408 
	/**
418 
	 * Execute a GET request. A GET request fetches a list of resource when no resource name is given, a list of element
 409 
	 * Execute a GET request. A GET request fetches a list of resource when no resource name is given, a list of element
419 
	 * when a resource name is given, or a resource element when a resource and resource unique identifier are given. It does not change the
 410 
	 * when a resource name is given, or a resource element when a resource and resource unique identifier are given. It does not change the
420 
	 * database contents.
 411 
	 * database contents.
421 
	 */
 412 
	 */
422 
	private function get() {
 413 
	private function get() {
423 
		$retour = '';
 414 
		$retour = '';
424 
		if ($this->service != null) {
 415 
		if ($this->service != null) {
425 
			$Service = new $this->service(self::$config);
 416 
			$Service = new $this->service(self::$config);
426 
			if (method_exists($Service, self::METHODE_GET)) {
 417 
			if (method_exists($Service, self::METHODE_GET)) {
427 
				$methodeGet = self::METHODE_GET;
 418 
				$methodeGet = self::METHODE_GET;
428 
				$parametres = $Service->utiliserParametresBruts() ? $this->parametresBruts : $this->parametres;
 419 
				$parametres = $Service->utiliserParametresBruts() ? $this->parametresBruts : $this->parametres;
429 
				$retour = $Service->$methodeGet($this->ressources, $parametres);
 420 
				$retour = $Service->$methodeGet($this->ressources, $parametres);
430 
			} else {
 421 
			} else {
431 
				self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
 422 
				self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
432 
				$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_GET."' nécessaire ".
 423 
				$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_GET."' nécessaire ".
433 
					"lors de l'appel du service via la méthode HTTP GET.";
 424 
					"lors de l'appel du service via la méthode HTTP GET.";
434 
				self::ajouterMessage($e);
 425 
				self::ajouterMessage($e);
435 
			}
 426 
			}
436 
		}
 427 
		}
437 
		return $retour;
 428 
		return $retour;
438 
	}
 429 
	}
439 
 
 430 
 
440 
	private function post() {
 431 
	private function post() {
441 
		$paires = $this->parserDonneesRequete();
 432 
		$paires = $this->parserDonneesRequete();
442 
		if (count($paires) != 0) {
 433 
		if (count($paires) != 0) {
443 
			if (isset($paires['action']) && $paires['action'] == 'DELETE') {// Altnative à l'utilisation de DELETE
 434 
			if (isset($paires['action']) && $paires['action'] == 'DELETE') {// Altnative à l'utilisation de DELETE
444 
				$retour = $this->delete();
 435 
				$retour = $this->delete();
445 
			} else if (count($this->ressources) == 0) {// Altnative à l'utilisation de PUT
 436 
			} else if (count($this->ressources) == 0) {// Altnative à l'utilisation de PUT
446 
				$retour = $this->put();
 437 
				$retour = $this->put();
447 
			} else {
 438 
			} else {
448 
				if ($this->service != null) {
 439 
				if ($this->service != null) {
449 
					$Service = new $this->service(self::$config);
 440 
					$Service = new $this->service(self::$config);
450 
					if (method_exists($Service, self::METHODE_POST)) {
 441 
					if (method_exists($Service, self::METHODE_POST)) {
451 
						$methodePost = self::METHODE_POST;
 442 
						$methodePost = self::METHODE_POST;
452 
						$info = $Service->$methodePost($this->ressources, $paires);
 443 
						$info = $Service->$methodePost($this->ressources, $paires);
453 
						if ($info === true) {
 444 
						if ($info === true) {
454 
							$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CREATION_OK);
 445 
							$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CREATION_OK);
455 
						}
 446 
						}
456 
					} else {
 447 
					} else {
457 
						self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
 448 
						self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
458 
						$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_POST."' nécessaire ".
 449 
						$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_POST."' nécessaire ".
459 
							"lors de l'appel du service via la méthode HTTP GET.";
 450 
							"lors de l'appel du service via la méthode HTTP GET.";
460 
						self::ajouterMessage($e);
 451 
						self::ajouterMessage($e);
461 
					}
 452 
					}
462 
				}
 453 
				}
463 
			}
 454 
			}
464 
		} else {
 455 
		} else {
465 
			$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CONTENU_REQUIS);
 456 
			$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CONTENU_REQUIS);
466 
			$e = "Le service '{$this->service}' requiert de fournir le contenu à modifier dans le corps ".
 457 
			$e = "Le service '{$this->service}' requiert de fournir le contenu à modifier dans le corps ".
467 
				"de la requête avec la méthode HTTP POST.";
 458 
				"de la requête avec la méthode HTTP POST.";
468 
			self::ajouterMessage($e);
 459 
			self::ajouterMessage($e);
469 
		}
 460 
		}
470 
	}
 461 
	}
471 
 
 462 
 
472 
	private function put() {
 463 
	private function put() {
473 
		$paires = $this->parserDonneesRequete();
 464 
		$paires = $this->parserDonneesRequete();
474 
		if (count($paires) != 0) {
 465 
		if (count($paires) != 0) {
475 
			if ($this->service != null) {
 466 
			if ($this->service != null) {
476 
				$Service = new $this->service(self::$config);
 467 
				$Service = new $this->service(self::$config);
477 
				if (method_exists($Service, self::METHODE_PUT)) {
 468 
				if (method_exists($Service, self::METHODE_PUT)) {
478 
					$methodePut = self::METHODE_PUT;
 469 
					$methodePut = self::METHODE_PUT;
479 
					$info = $Service->$methodePut($this->ressources, $paires);
 470 
					$info = $Service->$methodePut($this->ressources, $paires);
480 
					if ($info === true) {
 471 
					if ($info === true) {
481 
						$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CREATION_OK);
 472 
						$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CREATION_OK);
482 
					}
 473 
					}
483 
				} else {
 474 
				} else {
484 
					self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
 475 
					self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
485 
					$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_PUT."' nécessaire ".
 476 
					$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_PUT."' nécessaire ".
486 
						"lors de l'appel du service via la méthode HTTP GET.";
 477 
						"lors de l'appel du service via la méthode HTTP GET.";
487 
					self::ajouterMessage($e);
 478 
					self::ajouterMessage($e);
488 
				}
 479 
				}
489 
			}
 480 
			}
490 
		} else {
 481 
		} else {
491 
			$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CONTENU_REQUIS);
 482 
			$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CONTENU_REQUIS);
492 
			$e = "Il est nécessaire de fournir du contenu dans le corps de la requête pour créer une nouvelle ressource.";
 483 
			$e = "Il est nécessaire de fournir du contenu dans le corps de la requête pour créer une nouvelle ressource.";
493 
			self::ajouterMessage($e);
 484 
			self::ajouterMessage($e);
494 
		}
 485 
		}
495 
	}
 486 
	}
496 
 
 487 
 
497 
	private function delete() {
 488 
	private function delete() {
498 
		if (count($this->ressources) != 0) {
 489 
		if (count($this->ressources) != 0) {
499 
			if ($this->service != null) {
 490 
			if ($this->service != null) {
500 
				$Service = new $this->service(self::$config);
 491 
				$Service = new $this->service(self::$config);
501 
				if (method_exists($Service, self::METHODE_DELETE)) {
 492 
				if (method_exists($Service, self::METHODE_DELETE)) {
502 
					$methodeDelete = self::METHODE_DELETE;
 493 
					$methodeDelete = self::METHODE_DELETE;
503 
					$info = $Service->$methodeDelete($this->ressources);
 494 
					$info = $Service->$methodeDelete($this->ressources);
504 
					if ($info === true) {
 495 
					if ($info === true) {
505 
						$this->envoyerEnteteStatutHttp(self::HTTP_CODE_SUPPRESSION_OK);
 496 
						$this->envoyerEnteteStatutHttp(self::HTTP_CODE_SUPPRESSION_OK);
506 
					} else if ($info === false) {
 497 
					} else if ($info === false) {
507 
						$this->envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
 498 
						$this->envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
508 
						$e = "La ressource à supprimer est introuvable. Il se peut qu'elle ait été préalablement supprimé.";
 499 
						$e = "La ressource à supprimer est introuvable. Il se peut qu'elle ait été préalablement supprimé.";
509 
						self::ajouterMessage($e);
 500 
						self::ajouterMessage($e);
510 
					}
 501 
					}
511 
				} else {
 502 
				} else {
512 
					self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
 503 
					self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
513 
					$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_DELETE."' nécessaire ".
 504 
					$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_DELETE."' nécessaire ".
514 
						"lors de l'appel du service via la méthode HTTP GET.";
 505 
						"lors de l'appel du service via la méthode HTTP GET.";
515 
					self::ajouterMessage($e);
 506 
					self::ajouterMessage($e);
516 
				}
 507 
				}
517 
			}
 508 
			}
518 
		} else {
 509 
		} else {
519 
			$this->envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
 510 
			$this->envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
520 
			$e = "Il est nécessaire d'indiquer dans l'url la ressource à supprimer.";
 511 
			$e = "Il est nécessaire d'indiquer dans l'url la ressource à supprimer.";
521 
			self::ajouterMessage($e);
 512 
			self::ajouterMessage($e);
522 
		}
 513 
		}
523 
	}
 514 
	}
524 
 
 515 
 
525 
	/**
 516 
	/**
526 
	 * Parse les données contenu dans le corps de la requête HTTP (= POST) en :
 517 
	 * Parse les données contenu dans le corps de la requête HTTP (= POST) en :
527 
	 *  - décodant les clés et valeurs.
 518 
	 *  - décodant les clés et valeurs.
528 
	 *  - supprimant les espaces en début et fin des clés et des valeurs.
 519 
	 *  - supprimant les espaces en début et fin des clés et des valeurs.
529 
	 *
 520 
	 *
530 
	 * @return array Tableau de paires clé et valeur.
 521 
	 * @return array Tableau de paires clé et valeur.
531 
	 */
 522 
	 */
532 
	private function parserDonneesRequete() {
 523 
	private function parserDonneesRequete() {
533 
		$donnees = array();
 524 
		$donnees = array();
534 
		if ($this->requeteDonneesParsees != null) {
 525 
		if ($this->requeteDonneesParsees != null) {
535 
			$donnees = $this->requeteDonneesParsees;
 526 
			$donnees = $this->requeteDonneesParsees;
536 
		} else if ($this->requeteDonnees != null) {
 527 
		} else if ($this->requeteDonnees != null) {
537 
			$paires = explode('&', $this->requeteDonnees);
 528 
			$paires = explode('&', $this->requeteDonnees);
538 
			foreach ($paires as $paire) {
 529 
			foreach ($paires as $paire) {
539 
				list($cle, $valeur) = explode('=', $paire);
 530 
				list($cle, $valeur) = explode('=', $paire);
540 
				$cle = (isset($cle)) ? trim(urldecode($cle)) : '';
 531 
				$cle = (isset($cle)) ? trim(urldecode($cle)) : '';
541 
				$valeur = (isset($valeur)) ? trim(urldecode($valeur)) : '';
 532 
				$valeur = (isset($valeur)) ? trim(urldecode($valeur)) : '';
542 
				$donnees[$cle] = $valeur;
 533 
				$donnees[$cle] = $valeur;
543 
			}
 534 
			}
544 
			$this->requeteDonneesParsees = $donnees;
 535 
			$this->requeteDonneesParsees = $donnees;
545 
		}
 536 
		}
546 
		return $donnees;
 537 
		return $donnees;
547 
	}
 538 
	}
548 
 
 539 
 
549 
	/**
 540 
	/**
550 
	 * Envoyer un entête HTTP (version 1.0) de statut.
 541 
	 * Envoyer un entête HTTP (version 1.0) de statut.
551 
	 * Il remplacera systématiquement tout entête HTTP de statut précédement envoyé.
 542 
	 * Il remplacera systématiquement tout entête HTTP de statut précédement envoyé.
552 
	 * @param int $code entier indiquant le code du statut de l'entête HTTP à envoyer.
 543 
	 * @param int $code entier indiquant le code du statut de l'entête HTTP à envoyer.
553 
	 */
 544 
	 */
554 
	public static function envoyerEnteteStatutHttp($code) {
 545 
	public static function envoyerEnteteStatutHttp($code) {
555 
		if (isset(self::$http10[$code])) {
 546 
		if (isset(self::$http10[$code])) {
556 
			$txt = self::$http10[$code];
 547 
			$txt = self::$http10[$code];
557 
			header("HTTP/1.0 $code $txt", true);
 548 
			header("HTTP/1.0 $code $txt", true);
558 
		}
 549 
		}
559 
	}
 550 
	}
560 
 
 551 
 
561 
	/**
 552 
	/**
562 
	 * Termine l'accès au serveur après envoir envoyer les messages.
 553 
	 * Termine l'accès au serveur après envoir envoyer les messages.
563 
	 */
 554 
	 */
564 
	private static function cloreAccesServeur($retour = '') {
 555 
	private static function cloreAccesServeur($retour = '') {
565 
		// 	Gestion des exceptions et erreurs générées par les services
 556 
		// 	Gestion des exceptions et erreurs générées par les services
566 
		$retour .= self::gererErreurs();
 557 
		$retour .= self::gererErreurs();
567 
 
 558 
 
568 
		// Envoie des messages d'erreur et d'avertissement du serveur
 559 
		// Envoie des messages d'erreur et d'avertissement du serveur
569 
		$retour .= self::envoyerMessages();
 560 
		$retour .= self::envoyerMessages();
570 
 
 561 
 
571 
		// Envoie sur la sortie standard le contenu de la réponse HTTP
 562 
		// Envoie sur la sortie standard le contenu de la réponse HTTP
572 
		print $retour;
 563 
		print $retour;
573 
 
 564 
 
574 
		// Nous terminons le script
 565 
		// Nous terminons le script
575 
		exit(0);
 566 
		exit(0);
576 
	}
 567 
	}
577 
 
 568 
 
578 
	/**
 569 
	/**
579 
	 * Si des exceptions ou des erreurs sont soulevées par le serveur ou les services, elles sont gérées par cette méthode.
 570 
	 * Si des exceptions ou des erreurs sont soulevées par le serveur ou les services, elles sont gérées par cette méthode.
580 
	 * 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
 571 
	 * 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
581 
	 * standard (via echo).
 572 
	 * standard (via echo).
582 
	 * Si seulement des erreurs de type E_USER_NOTICE, sont présentes, elle sont envoyées en fonction du contenu du paramètre de
 573 
	 * Si seulement des erreurs de type E_USER_NOTICE, sont présentes, elle sont envoyées en fonction du contenu du paramètre de
583 
	 * config "debogage_mode" :
 574 
	 * config "debogage_mode" :
584 
	 *  - Debug::MODE_ECHO : les messages sont affichés en utilisant echo au moment où ils sont déclenchés dans le code.
 575 
	 *  - Debug::MODE_ECHO : les messages sont affichés en utilisant echo au moment où ils sont déclenchés dans le code.
585 
	 *  - Debug::MODE_NOTICE : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type
 576 
	 *  - Debug::MODE_NOTICE : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type
586 
	 *  E_USER_NOTICE et sont renvoyés sur la sortie standard à la fin de l'execution du programme (via echo).
 577 
	 *  E_USER_NOTICE et sont renvoyés sur la sortie standard à la fin de l'execution du programme (via echo).
587 
	 *  - Debug::MODE_ENTETE_HTTP : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type
 578 
	 *  - Debug::MODE_ENTETE_HTTP : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type
588 
	 *  E_USER_NOTICE et sont renvoyés dans un entête HTTP (X_REST_DEBOGAGE_MESSAGES) à la fin de l'execution du programme.
 579 
	 *  E_USER_NOTICE et sont renvoyés dans un entête HTTP (X_REST_DEBOGAGE_MESSAGES) à la fin de l'execution du programme.
589 
	 *  - Autre valeur : les messages sont formatés puis retournés par la fonction de débogage (à vous de les afficher).
 580 
	 *  - Autre valeur : les messages sont formatés puis retournés par la fonction de débogage (à vous de les afficher).
590 
	 */
 581 
	 */
591 
	public static function gererErreurs() {
 582 
	public static function gererErreurs() {
592 
		$retour = '';
 583 
		$retour = '';
593 
		if (self::$debogageActivation && GestionnaireException::getExceptionsNbre() > 0) {
 584 
		if (self::$debogageActivation && GestionnaireException::getExceptionsNbre() > 0) {
594 
 
 585 
 
595 
			$exceptionsTriees = GestionnaireException::getExceptionsTriees();
 586 
			$exceptionsTriees = GestionnaireException::getExceptionsTriees();
596 
			reset($exceptionsTriees);
 587 
			reset($exceptionsTriees);
597 
			$debogageSeulement = true;
 588 
			$debogageSeulement = true;
598 
			if (array_key_exists(E_USER_ERROR, $exceptionsTriees)) {
 589 
			if (array_key_exists(E_USER_ERROR, $exceptionsTriees)) {
599 
				self::envoyerEnteteStatutHttp(self::HTTP_CODE_ERREUR);
 590 
				self::envoyerEnteteStatutHttp(self::HTTP_CODE_ERREUR);
600 
				$debogageSeulement = false;
 591 
				$debogageSeulement = false;
601 
			}
 592 
			}
602 
 
 593 
 
603 
			$exceptionsFormatees = array();
 594 
			$exceptionsFormatees = array();
604 
			foreach ($exceptionsTriees as $exceptions) {
 595 
			foreach ($exceptionsTriees as $exceptions) {
605 
				foreach ($exceptions as $e) {
 596 
				foreach ($exceptions as $e) {
606 
					if ($debogageSeulement && self::$debogageMode == Debug::MODE_ENTETE_HTTP) {
 597 
					if ($debogageSeulement && self::$debogageMode == Debug::MODE_ENTETE_HTTP) {
607 
						$exceptionsFormatees[] = GestionnaireException::formaterExceptionDebug($e);
 598 
						$exceptionsFormatees[] = GestionnaireException::formaterExceptionDebug($e);
608 
					} else {
 599 
					} else {
609 
						$retour = GestionnaireException::formaterExceptionXhtml($e);
 600 
						$retour = GestionnaireException::formaterExceptionXhtml($e);
610 
					}
 601 
					}
611 
				}
 602 
				}
612 
			}
 603 
			}
613 
 
 604 
 
614 
			if ($debogageSeulement && self::$debogageMode == Debug::MODE_ENTETE_HTTP) {
 605 
			if ($debogageSeulement && self::$debogageMode == Debug::MODE_ENTETE_HTTP) {
615 
				header('X_REST_DEBOGAGE_MESSAGES: '.json_encode($exceptionsFormatees));
 606 
				header('X_REST_DEBOGAGE_MESSAGES: '.json_encode($exceptionsFormatees));
616 
			}
 607 
			}
617 
		}
 608 
		}
618 
		return $retour;
 609 
		return $retour;
619 
	}
 610 
	}
620 
 
 611 
 
621 
 
 612 
 
622 
	/**
 613 
	/**
623 
	 * Permet d'ajouter un message d'erreur ou d'avertissement qui sera envoyé au client.
 614 
	 * Permet d'ajouter un message d'erreur ou d'avertissement qui sera envoyé au client.
624 
	 * Le message doit être au format texte et en UTF-8.
 615 
	 * Le message doit être au format texte et en UTF-8.
625 
	 * @param string $message le message à envoyer.
 616 
	 * @param string $message le message à envoyer.
626 
	 */
 617 
	 */
627 
	public static function ajouterMessage($message) {
 618 
	public static function ajouterMessage($message) {
628 
		if (isset($message) && !empty($message)) {
 619 
		if (isset($message) && !empty($message)) {
629 
			self::$messages[] = $message;
 620 
			self::$messages[] = $message;
630 
		}
 621 
		}
631 
	}
 622 
	}
632 
 
 623 
 
633 
	/**
 624 
	/**
634 
	 * Envoie au client les éventuels messages d'erreur et d'avertissement du Serveur.
 625 
	 * Envoie au client les éventuels messages d'erreur et d'avertissement du Serveur.
635 
	 * Le format d'envoie est text/plain encodé en UTF-8.
 626 
	 * Le format d'envoie est text/plain encodé en UTF-8.
636 
	 */
 627 
	 */
637 
	private static function envoyerMessages() {
 628 
	private static function envoyerMessages() {
638 
		if (count(self::$messages) > 0) {
 629 
		if (count(self::$messages) > 0) {
639 
			header("Content-Type: text/plain; charset=utf-8");
 630 
			header("Content-Type: text/plain; charset=utf-8");
640 
			return implode("\n", self::$messages);
 631 
			return implode("\n", self::$messages);
641 
		}
 632 
		}
642 
	}
 633 
	}
643 
}
 634 
}
644 
?>
 635 
?>