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 421 2013-04-11 14:43:49Z jpm $
|
38 |
* @version $Id: RestServeur.php 421 2013-04-11 14:43:49Z 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 |
self::$config['chemins']['api_bibliotheque'] = self::$config['chemins']['api'].Config::get('dossier_bibliotheque').DS;
|
270 |
self::$config['chemins']['api_bibliotheque'] = self::$config['chemins']['api'].Config::get('dossier_bibliotheque').DS;
|
271 |
} else {
|
271 |
} else {
|
272 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
|
272 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
|
273 |
$e = "Aucune version d'API n'a été spécifiée.\n".
|
273 |
$e = "Aucune version d'API n'a été spécifiée.\n".
|
274 |
"La version doit respecter l'expression régulière suivante : ".self::MOTIF_API_VERSION.".\n".
|
274 |
"La version doit respecter l'expression régulière suivante : ".self::MOTIF_API_VERSION.".\n".
|
275 |
"L'url doit avoir la forme suivante : http://www.mondomaine.org/services/apiVersion/monService/";
|
275 |
"L'url doit avoir la forme suivante : http://www.mondomaine.org/services/apiVersion/monService/";
|
276 |
self::ajouterMessage($e);
|
276 |
self::ajouterMessage($e);
|
277 |
self::cloreAccesServeur();
|
277 |
self::cloreAccesServeur();
|
278 |
}
|
278 |
}
|
279 |
}
|
279 |
}
|
280 |
|
280 |
|
281 |
private function verifierApiVersion($apiVersion) {
|
281 |
private function verifierApiVersion($apiVersion) {
|
282 |
$apiOk = false;
|
282 |
$apiOk = false;
|
283 |
if (isset($apiVersion) && !empty($apiVersion) && preg_match(self::MOTIF_API_VERSION, $apiVersion)) {
|
283 |
if (isset($apiVersion) && !empty($apiVersion) && preg_match(self::MOTIF_API_VERSION, $apiVersion)) {
|
284 |
$apiOk = true;
|
284 |
$apiOk = true;
|
285 |
}
|
285 |
}
|
286 |
return $apiOk;
|
286 |
return $apiOk;
|
287 |
}
|
287 |
}
|
288 |
|
288 |
|
289 |
private function initialiserServiceNom($serviceNom) {
|
289 |
private function initialiserServiceNom($serviceNom) {
|
290 |
if ($this->verifierServiceNom($serviceNom)) {
|
290 |
if ($this->verifierServiceNom($serviceNom)) {
|
291 |
$this->service = $this->traiterNomService($serviceNom);
|
291 |
$this->service = $this->traiterNomService($serviceNom);
|
292 |
} else {
|
292 |
} else {
|
293 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
|
293 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
|
294 |
$e = "Aucune nom de service n'a été spécifié.\n".
|
294 |
$e = "Aucune nom de service n'a été spécifié.\n".
|
295 |
"La nom du service doit respecter l'expression régulière suivante : ".self::MOTIF_SERVICE_NOM.".\n".
|
295 |
"La nom du service doit respecter l'expression régulière suivante : ".self::MOTIF_SERVICE_NOM.".\n".
|
296 |
"L'url doit avoir la forme suivante : http://www.mondomaine.org/services/apiVersion/monService/";
|
296 |
"L'url doit avoir la forme suivante : http://www.mondomaine.org/services/apiVersion/monService/";
|
297 |
self::ajouterMessage($e);
|
297 |
self::ajouterMessage($e);
|
298 |
self::cloreAccesServeur();
|
298 |
self::cloreAccesServeur();
|
299 |
}
|
299 |
}
|
300 |
}
|
300 |
}
|
301 |
|
301 |
|
302 |
private function verifierServiceNom($serviceNom) {
|
302 |
private function verifierServiceNom($serviceNom) {
|
303 |
$serviceNomOk = false;
|
303 |
$serviceNomOk = false;
|
304 |
if (isset($serviceNom) && !empty($serviceNom) && preg_match(self::MOTIF_SERVICE_NOM, $serviceNom)) {
|
304 |
if (isset($serviceNom) && !empty($serviceNom) && preg_match(self::MOTIF_SERVICE_NOM, $serviceNom)) {
|
305 |
$serviceNomOk = true;
|
305 |
$serviceNomOk = true;
|
306 |
}
|
306 |
}
|
307 |
return $serviceNomOk;
|
307 |
return $serviceNomOk;
|
308 |
}
|
308 |
}
|
309 |
|
309 |
|
310 |
private function traiterNomService($serviceNom) {
|
310 |
private function traiterNomService($serviceNom) {
|
311 |
return str_replace(' ', '', ucwords(str_replace('-', ' ', strtolower($serviceNom))));
|
311 |
return str_replace(' ', '', ucwords(str_replace('-', ' ', strtolower($serviceNom))));
|
312 |
}
|
312 |
}
|
313 |
|
313 |
|
314 |
private function initialiserRessource($urlParts) {
|
314 |
private function initialiserRessource($urlParts) {
|
315 |
if (is_array($urlParts) && count($urlParts) > 0) {
|
315 |
if (is_array($urlParts) && count($urlParts) > 0) {
|
316 |
foreach ($urlParts as $ressource) {
|
316 |
foreach ($urlParts as $ressource) {
|
317 |
// Ne pas utiliser empty() car valeur 0 acceptée
|
317 |
// Ne pas utiliser empty() car valeur 0 acceptée
|
318 |
if ($ressource != '') {
|
318 |
if ($ressource != '') {
|
319 |
$this->ressources[] = urldecode($ressource);
|
319 |
$this->ressources[] = urldecode($ressource);
|
320 |
}
|
320 |
}
|
321 |
}
|
321 |
}
|
322 |
}
|
322 |
}
|
323 |
}
|
323 |
}
|
324 |
|
324 |
|
325 |
private function initialiserParametres() {
|
325 |
private function initialiserParametres() {
|
326 |
$this->parametres = $this->recupererParametresGet();
|
326 |
$this->parametres = $this->recupererParametresGet();
|
327 |
$this->parametresBruts = $this->recupererParametresBruts();
|
327 |
$this->parametresBruts = $this->recupererParametresBruts();
|
328 |
}
|
328 |
}
|
329 |
|
329 |
|
330 |
private function recupererParametresGet() {
|
330 |
private function recupererParametresGet() {
|
331 |
$_GET = $this->nettoyerParametres($_GET);
|
331 |
$_GET = $this->nettoyerParametres($_GET);
|
332 |
return $_GET;
|
332 |
return $_GET;
|
333 |
}
|
333 |
}
|
334 |
|
334 |
|
335 |
private function nettoyerParametres(Array $parametres) {
|
335 |
private function nettoyerParametres(Array $parametres) {
|
336 |
// Pas besoin d'utiliser urldecode car déjà fait par php pour les clés et valeur de $_GET
|
336 |
// Pas besoin d'utiliser urldecode car déjà fait par php pour les clés et valeur de $_GET
|
337 |
if (isset($parametres) && count($parametres) > 0) {
|
337 |
if (isset($parametres) && count($parametres) > 0) {
|
338 |
foreach ($parametres as $cle => $valeur) {
|
338 |
foreach ($parametres as $cle => $valeur) {
|
339 |
// les quotes, guillements et points-virgules ont été retirés des caractères à vérifier car
|
339 |
// les quotes, guillements et points-virgules ont été retirés des caractères à vérifier car
|
340 |
//ça n'a plus lieu d'être maintenant que l'on utilise protéger à peu près partout
|
340 |
//ça n'a plus lieu d'être maintenant que l'on utilise protéger à peu près partout
|
341 |
$verifier = array('NULL', "\\", "\x00", "\x1a");
|
341 |
$verifier = array('NULL', "\\", "\x00", "\x1a");
|
342 |
$parametres[$cle] = strip_tags(str_replace($verifier, '', $valeur));
|
342 |
$parametres[$cle] = strip_tags(str_replace($verifier, '', $valeur));
|
343 |
}
|
343 |
}
|
344 |
}
|
344 |
}
|
345 |
return $parametres;
|
345 |
return $parametres;
|
346 |
}
|
346 |
}
|
347 |
|
347 |
|
348 |
private function recupererParametresBruts() {
|
348 |
private function recupererParametresBruts() {
|
349 |
$parametres_bruts = array();
|
349 |
$parametres_bruts = array();
|
350 |
if (!empty($_SERVER['QUERY_STRING'])) {
|
350 |
if (!empty($_SERVER['QUERY_STRING'])) {
|
351 |
$paires = explode('&', $_SERVER['QUERY_STRING']);
|
351 |
$paires = explode('&', $_SERVER['QUERY_STRING']);
|
352 |
foreach ($paires as $paire) {
|
352 |
foreach ($paires as $paire) {
|
353 |
$nv = explode('=', $paire);
|
353 |
$nv = explode('=', $paire);
|
354 |
$nom = urldecode($nv[0]);
|
354 |
$nom = urldecode($nv[0]);
|
355 |
$valeur = urldecode($nv[1]);
|
355 |
$valeur = urldecode($nv[1]);
|
356 |
$parametres_bruts[$nom] = $valeur;
|
356 |
$parametres_bruts[$nom] = $valeur;
|
357 |
}
|
357 |
}
|
358 |
$parametres_bruts = $this->nettoyerParametres($parametres_bruts);
|
358 |
$parametres_bruts = $this->nettoyerParametres($parametres_bruts);
|
359 |
}
|
359 |
}
|
360 |
return $parametres_bruts;
|
360 |
return $parametres_bruts;
|
361 |
}
|
361 |
}
|
362 |
|
362 |
|
363 |
/**
|
363 |
/**
|
364 |
* La méthode __autoload() charge dynamiquement les classes trouvées dans le code.
|
364 |
* La méthode __autoload() charge dynamiquement les classes trouvées dans le code.
|
365 |
* Cette fonction est appelée par php5 quand il trouve une instanciation de classe dans le code.
|
365 |
* Cette fonction est appelée par php5 quand il trouve une instanciation de classe dans le code.
|
366 |
*
|
366 |
*
|
367 |
*@param string le nom de la classe appelée.
|
367 |
*@param string le nom de la classe appelée.
|
368 |
*@return void le fichier contenant la classe doit être inclu par la fonction.
|
368 |
*@return void le fichier contenant la classe doit être inclu par la fonction.
|
369 |
*/
|
369 |
*/
|
370 |
public static function chargerClasse($classe) {
|
370 |
public static function chargerClasse($classe) {
|
371 |
if (class_exists($classe)) {
|
371 |
if (class_exists($classe)) {
|
372 |
return null;
|
372 |
return null;
|
373 |
}
|
373 |
}
|
374 |
$chemins = array('', self::$config['chemins']['api'], self::$config['chemins']['api_bibliotheque']);
|
374 |
$chemins = array('', self::$config['chemins']['api'], self::$config['chemins']['api_bibliotheque']);
|
375 |
foreach ($chemins as $chemin) {
|
375 |
foreach ($chemins as $chemin) {
|
376 |
$chemin = $chemin.$classe.'.php';
|
376 |
$chemin = $chemin.$classe.'.php';
|
377 |
if (file_exists($chemin)) {
|
377 |
if (file_exists($chemin)) {
|
378 |
require_once $chemin;
|
378 |
require_once $chemin;
|
379 |
}
|
379 |
}
|
380 |
}
|
380 |
}
|
381 |
}
|
381 |
}
|
382 |
|
382 |
|
383 |
/**
|
383 |
/**
|
384 |
* Execute la requête.
|
384 |
* Execute la requête.
|
385 |
*/
|
385 |
*/
|
386 |
public function executer() {
|
386 |
public function executer() {
|
387 |
$retour = '';
|
387 |
$retour = '';
|
388 |
switch ($this->methode) {
|
388 |
switch ($this->methode) {
|
389 |
case 'GET':
|
389 |
case 'GET':
|
390 |
$retour = $this->get();
|
390 |
$retour = $this->get();
|
391 |
break;
|
391 |
break;
|
392 |
case 'POST':
|
392 |
case 'POST':
|
393 |
$retour = $this->post();// Retour pour l'alternative PUT
|
393 |
$retour = $this->post();// Retour pour l'alternative PUT
|
394 |
break;
|
394 |
break;
|
395 |
case 'DELETE':
|
395 |
case 'DELETE':
|
396 |
$this->delete();
|
396 |
$this->delete();
|
397 |
break;
|
397 |
break;
|
398 |
case 'PUT':
|
398 |
case 'PUT':
|
399 |
$retour = $this->put();
|
399 |
$retour = $this->put();
|
400 |
break;
|
400 |
break;
|
401 |
// Autorise l'accès depuis des serveurs tiers
|
401 |
// Autorise l'accès depuis des serveurs tiers
|
402 |
case 'OPTIONS':
|
402 |
case 'OPTIONS':
|
403 |
/*header('Access-Control-Allow-Origin: *');
|
403 |
/*header('Access-Control-Allow-Origin: *');
|
404 |
header('Access-Control-Allow-Headers:origin, content-type');
|
404 |
header('Access-Control-Allow-Headers:origin, content-type');
|
405 |
header('Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS');
|
405 |
header('Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS');
|
406 |
header('Access-Control-Allow-Content-Type: application/json');
|
406 |
header('Access-Control-Allow-Content-Type: application/json');
|
407 |
header('Access-Control-Max-Age: 3628800');
|
407 |
header('Access-Control-Max-Age: 3628800');
|
408 |
header('Access-Control-Allow-Credentials: false');*/
|
408 |
header('Access-Control-Allow-Credentials: false');*/
|
409 |
break;
|
409 |
break;
|
410 |
default :
|
410 |
default :
|
411 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_METHODE_NON_AUTORISE);
|
411 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_METHODE_NON_AUTORISE);
|
412 |
header('Allow: GET, POST, DELETE, PUT');
|
412 |
header('Allow: GET, POST, DELETE, PUT');
|
413 |
$e = "La méthode HTTP '{$this->methode}' n'est pas prise en compte par ce serveur REST.\n".
|
413 |
$e = "La méthode HTTP '{$this->methode}' n'est pas prise en compte par ce serveur REST.\n".
|
414 |
"Consulter l'entête Allow pour connaître les méthodes autorisées.";
|
414 |
"Consulter l'entête Allow pour connaître les méthodes autorisées.";
|
415 |
self::ajouterMessage($e);
|
415 |
self::ajouterMessage($e);
|
416 |
}
|
416 |
}
|
417 |
$this->cloreAccesServeur($retour);
|
417 |
$this->cloreAccesServeur($retour);
|
418 |
}
|
418 |
}
|
419 |
|
419 |
|
420 |
/**
|
420 |
/**
|
421 |
* Execute a GET request. A GET request fetches a list of resource when no resource name is given, a list of element
|
421 |
* Execute a GET request. A GET request fetches a list of resource when no resource name is given, a list of element
|
422 |
* when a resource name is given, or a resource element when a resource and resource unique identifier are given. It does not change the
|
422 |
* when a resource name is given, or a resource element when a resource and resource unique identifier are given. It does not change the
|
423 |
* database contents.
|
423 |
* database contents.
|
424 |
*/
|
424 |
*/
|
425 |
private function get() {
|
425 |
private function get() {
|
426 |
$retour = '';
|
426 |
$retour = '';
|
427 |
if ($this->service != null) {
|
427 |
if ($this->service != null) {
|
428 |
$Service = new $this->service(self::$config);
|
428 |
$Service = new $this->service(self::$config);
|
429 |
if (method_exists($Service, self::METHODE_GET)) {
|
429 |
if (method_exists($Service, self::METHODE_GET)) {
|
430 |
$methodeGet = self::METHODE_GET;
|
430 |
$methodeGet = self::METHODE_GET;
|
431 |
$parametres = $Service->utiliserParametresBruts() ? $this->parametresBruts : $this->parametres;
|
431 |
$parametres = $Service->utiliserParametresBruts() ? $this->parametresBruts : $this->parametres;
|
432 |
$retour = $Service->$methodeGet($this->ressources, $parametres);
|
432 |
$retour = $Service->$methodeGet($this->ressources, $parametres);
|
433 |
} else {
|
433 |
} else {
|
434 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
|
434 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
|
435 |
$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_GET."' nécessaire ".
|
435 |
$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_GET."' nécessaire ".
|
436 |
"lors de l'appel du service via la méthode HTTP GET.";
|
436 |
"lors de l'appel du service via la méthode HTTP GET.";
|
437 |
self::ajouterMessage($e);
|
437 |
self::ajouterMessage($e);
|
438 |
}
|
438 |
}
|
439 |
}
|
439 |
}
|
440 |
return $retour;
|
440 |
return $retour;
|
441 |
}
|
441 |
}
|
442 |
|
442 |
|
443 |
private function post() {
|
443 |
private function post() {
|
444 |
$retour = '';
|
444 |
$retour = '';
|
445 |
$paires = $this->parserDonneesRequete();
|
445 |
$paires = $this->parserDonneesRequete();
|
446 |
if (count($paires) != 0) {
|
446 |
if (count($paires) != 0) {
|
447 |
if (isset($paires['action']) && $paires['action'] == 'DELETE') {// Alternative à l'utilisation de DELETE
|
447 |
if (isset($paires['action']) && $paires['action'] == 'DELETE') {// Alternative à l'utilisation de DELETE
|
448 |
$this->delete();
|
448 |
$this->delete();
|
449 |
} else if (count($this->ressources) == 0) {// Alternative à l'utilisation de PUT
|
449 |
} else if (count($this->ressources) == 0) {// Alternative à l'utilisation de PUT
|
450 |
$retour = $this->put();
|
450 |
$retour = $this->put();
|
451 |
} else {
|
451 |
} else {
|
452 |
if ($this->service != null) {
|
452 |
if ($this->service != null) {
|
453 |
$Service = new $this->service(self::$config);
|
453 |
$Service = new $this->service(self::$config);
|
454 |
if (method_exists($Service, self::METHODE_POST)) {
|
454 |
if (method_exists($Service, self::METHODE_POST)) {
|
455 |
$methodePost = self::METHODE_POST;
|
455 |
$methodePost = self::METHODE_POST;
|
456 |
$info = $Service->$methodePost($this->ressources, $paires);
|
456 |
$info = $Service->$methodePost($this->ressources, $paires);
|
457 |
if ($info === true) {
|
457 |
if ($info === true) {
|
458 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CREATION_OK);
|
458 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CREATION_OK);
|
459 |
}
|
459 |
}
|
460 |
} else {
|
460 |
} else {
|
461 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
|
461 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
|
462 |
$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_POST."' nécessaire ".
|
462 |
$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_POST."' nécessaire ".
|
463 |
"lors de l'appel du service via la méthode HTTP GET.";
|
463 |
"lors de l'appel du service via la méthode HTTP GET.";
|
464 |
self::ajouterMessage($e);
|
464 |
self::ajouterMessage($e);
|
465 |
}
|
465 |
}
|
466 |
}
|
466 |
}
|
467 |
}
|
467 |
}
|
468 |
} else {
|
468 |
} else {
|
469 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CONTENU_REQUIS);
|
469 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CONTENU_REQUIS);
|
470 |
$e = "Le service '{$this->service}' requiert de fournir le contenu à modifier dans le corps ".
|
470 |
$e = "Le service '{$this->service}' requiert de fournir le contenu à modifier dans le corps ".
|
471 |
"de la requête avec la méthode HTTP POST.";
|
471 |
"de la requête avec la méthode HTTP POST.";
|
472 |
self::ajouterMessage($e);
|
472 |
self::ajouterMessage($e);
|
473 |
}
|
473 |
}
|
474 |
return $retour;
|
474 |
return $retour;
|
475 |
}
|
475 |
}
|
476 |
|
476 |
|
477 |
private function put() {
|
477 |
private function put() {
|
478 |
$retour = '';
|
478 |
$retour = '';
|
479 |
$paires = $this->parserDonneesRequete();
|
479 |
$paires = $this->parserDonneesRequete();
|
480 |
if (count($paires) != 0) {
|
480 |
if (count($paires) != 0) {
|
481 |
if ($this->service != null) {
|
481 |
if ($this->service != null) {
|
482 |
$Service = new $this->service(self::$config);
|
482 |
$Service = new $this->service(self::$config);
|
483 |
if (method_exists($Service, self::METHODE_PUT)) {
|
483 |
if (method_exists($Service, self::METHODE_PUT)) {
|
484 |
$methodePut = self::METHODE_PUT;
|
484 |
$methodePut = self::METHODE_PUT;
|
485 |
$retour = $Service->$methodePut($this->ressources, $paires);
|
485 |
$retour = $Service->$methodePut($this->ressources, $paires);
|
486 |
if ($retour !== false) {
|
486 |
if ($retour !== false) {
|
487 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CREATION_OK);
|
487 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CREATION_OK);
|
488 |
}
|
488 |
}
|
489 |
} else {
|
489 |
} else {
|
490 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
|
490 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
|
491 |
$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_PUT."' nécessaire ".
|
491 |
$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_PUT."' nécessaire ".
|
492 |
"lors de l'appel du service via la méthode HTTP GET.";
|
492 |
"lors de l'appel du service via la méthode HTTP GET.";
|
493 |
self::ajouterMessage($e);
|
493 |
self::ajouterMessage($e);
|
494 |
}
|
494 |
}
|
495 |
}
|
495 |
}
|
496 |
} else {
|
496 |
} else {
|
497 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CONTENU_REQUIS);
|
497 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_CONTENU_REQUIS);
|
498 |
$e = "Il est nécessaire de fournir du contenu dans le corps de la requête pour créer une nouvelle ressource.";
|
498 |
$e = "Il est nécessaire de fournir du contenu dans le corps de la requête pour créer une nouvelle ressource.";
|
499 |
self::ajouterMessage($e);
|
499 |
self::ajouterMessage($e);
|
500 |
}
|
500 |
}
|
501 |
return $retour;
|
501 |
return $retour;
|
502 |
}
|
502 |
}
|
503 |
|
503 |
|
504 |
private function delete() {
|
504 |
private function delete() {
|
- |
|
505 |
$retour = '';
|
505 |
if (count($this->ressources) != 0) {
|
506 |
if (count($this->ressources) != 0) {
|
506 |
$paires = $this->parserDonneesRequete();
|
507 |
$paires = $this->parserDonneesRequete();
|
507 |
if ($this->service != null) {
|
508 |
if ($this->service != null) {
|
508 |
$Service = new $this->service(self::$config);
|
509 |
$Service = new $this->service(self::$config);
|
509 |
if (method_exists($Service, self::METHODE_DELETE)) {
|
510 |
if (method_exists($Service, self::METHODE_DELETE)) {
|
510 |
$methodeDelete = self::METHODE_DELETE;
|
511 |
$methodeDelete = self::METHODE_DELETE;
|
511 |
$info = $Service->$methodeDelete($this->ressources, $paires);
|
512 |
$info = $Service->$methodeDelete($this->ressources, $paires);
|
512 |
if ($info === true) {
|
513 |
if ($info === true) {
|
513 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_SUPPRESSION_OK);
|
514 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_SUPPRESSION_OK);
|
514 |
} else if ($info === false) {
|
515 |
} else if ($info === false) {
|
515 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
|
516 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
|
516 |
$e = "La ressource à supprimer est introuvable. Il se peut qu'elle ait été préalablement supprimé.";
|
517 |
$e = "La ressource à supprimer est introuvable. Il se peut qu'elle ait été préalablement supprimé.";
|
517 |
self::ajouterMessage($e);
|
518 |
self::ajouterMessage($e);
|
518 |
}
|
519 |
}
|
519 |
} else {
|
520 |
} else {
|
520 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
|
521 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_RESSOURCE_INTROUVABLE);
|
521 |
$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_DELETE."' nécessaire ".
|
522 |
$e = "Le service '{$this->service}' ne contient pas la méthode '".self::METHODE_DELETE."' nécessaire ".
|
522 |
"lors de l'appel du service via la méthode HTTP GET.";
|
523 |
"lors de l'appel du service via la méthode HTTP GET.";
|
523 |
self::ajouterMessage($e);
|
524 |
self::ajouterMessage($e);
|
524 |
}
|
525 |
}
|
525 |
}
|
526 |
}
|
526 |
} else {
|
527 |
} else {
|
527 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
|
528 |
$this->envoyerEnteteStatutHttp(self::HTTP_CODE_MAUVAISE_REQUETE);
|
528 |
$e = "Il est nécessaire d'indiquer dans l'url la ressource à supprimer.";
|
529 |
$e = "Il est nécessaire d'indiquer dans l'url la ressource à supprimer.";
|
529 |
self::ajouterMessage($e);
|
530 |
self::ajouterMessage($e);
|
530 |
}
|
531 |
}
|
531 |
}
|
532 |
}
|
532 |
|
533 |
|
533 |
/**
|
534 |
/**
|
534 |
* Parse les données contenu dans le corps de la requête HTTP (= POST) en :
|
535 |
* Parse les données contenu dans le corps de la requête HTTP (= POST) en :
|
535 |
* - décodant les clés et valeurs.
|
536 |
* - décodant les clés et valeurs.
|
536 |
* - supprimant les espaces en début et fin des clés et des valeurs.
|
537 |
* - supprimant les espaces en début et fin des clés et des valeurs.
|
537 |
*
|
538 |
*
|
538 |
* @return array Tableau de paires clé et valeur.
|
539 |
* @return array Tableau de paires clé et valeur.
|
539 |
*/
|
540 |
*/
|
540 |
private function parserDonneesRequete() {
|
541 |
private function parserDonneesRequete() {
|
541 |
$donnees = array();
|
542 |
$donnees = array();
|
542 |
if ($this->requeteDonneesParsees != null) {
|
543 |
if ($this->requeteDonneesParsees != null) {
|
543 |
$donnees = $this->requeteDonneesParsees;
|
544 |
$donnees = $this->requeteDonneesParsees;
|
544 |
} else if ($this->requeteDonnees != null) {
|
545 |
} else if ($this->requeteDonnees != null) {
|
545 |
if (preg_match('/application\/json/', $_SERVER['CONTENT_TYPE'])) {
|
546 |
if (preg_match('/application\/json/', $_SERVER['CONTENT_TYPE'])) {
|
546 |
$donnees = json_decode($this->requeteDonnees, true);
|
547 |
$donnees = json_decode($this->requeteDonnees, true);
|
547 |
} else {
|
548 |
} else {
|
548 |
$paires = explode('&', $this->requeteDonnees);
|
549 |
$paires = explode('&', $this->requeteDonnees);
|
549 |
foreach ($paires as $paire) {
|
550 |
foreach ($paires as $paire) {
|
550 |
list($cle, $valeur) = explode('=', $paire);
|
551 |
list($cle, $valeur) = explode('=', $paire);
|
551 |
$cle = (isset($cle)) ? trim(urldecode($cle)) : '';
|
552 |
$cle = (isset($cle)) ? trim(urldecode($cle)) : '';
|
552 |
$valeur = (isset($valeur)) ? trim(urldecode($valeur)) : '';
|
553 |
$valeur = (isset($valeur)) ? trim(urldecode($valeur)) : '';
|
553 |
$donnees[$cle] = $valeur;
|
554 |
$donnees[$cle] = $valeur;
|
554 |
}
|
555 |
}
|
555 |
}
|
556 |
}
|
556 |
$this->requeteDonneesParsees = $donnees;
|
557 |
$this->requeteDonneesParsees = $donnees;
|
557 |
}
|
558 |
}
|
558 |
return $donnees;
|
559 |
return $donnees;
|
559 |
}
|
560 |
}
|
560 |
|
561 |
|
561 |
/**
|
562 |
/**
|
562 |
* Envoyer un entête HTTP (version 1.0) de statut.
|
563 |
* Envoyer un entête HTTP (version 1.0) de statut.
|
563 |
* Il remplacera systématiquement tout entête HTTP de statut précédement envoyé.
|
564 |
* Il remplacera systématiquement tout entête HTTP de statut précédement envoyé.
|
564 |
* @param int $code entier indiquant le code du statut de l'entête HTTP à envoyer.
|
565 |
* @param int $code entier indiquant le code du statut de l'entête HTTP à envoyer.
|
565 |
*/
|
566 |
*/
|
566 |
public static function envoyerEnteteStatutHttp($code) {
|
567 |
public static function envoyerEnteteStatutHttp($code) {
|
567 |
if (isset(self::$http10[$code])) {
|
568 |
if (isset(self::$http10[$code])) {
|
568 |
$txt = self::$http10[$code];
|
569 |
$txt = self::$http10[$code];
|
569 |
header("HTTP/1.0 $code $txt", true);
|
570 |
header("HTTP/1.0 $code $txt", true);
|
570 |
}
|
571 |
}
|
571 |
}
|
572 |
}
|
572 |
|
573 |
|
573 |
/**
|
574 |
/**
|
574 |
* Termine l'accès au serveur après envoir envoyer les messages.
|
575 |
* Termine l'accès au serveur après envoir envoyer les messages.
|
575 |
*/
|
576 |
*/
|
576 |
private static function cloreAccesServeur($retour = '') {
|
577 |
private static function cloreAccesServeur($retour = '') {
|
577 |
// Gestion des exceptions et erreurs générées par les services
|
578 |
// Gestion des exceptions et erreurs générées par les services
|
578 |
$retour .= self::gererErreurs();
|
579 |
$retour .= self::gererErreurs();
|
579 |
|
580 |
|
580 |
// Envoie des messages d'erreur et d'avertissement du serveur
|
581 |
// Envoie des messages d'erreur et d'avertissement du serveur
|
581 |
$retour .= self::envoyerMessages();
|
582 |
$retour .= self::envoyerMessages();
|
582 |
|
583 |
|
583 |
// Autorise l'accès depuis des serveurs tiers
|
584 |
// Autorise l'accès depuis des serveurs tiers
|
584 |
//header('Access-Control-Allow-Origin: *');
|
585 |
//header('Access-Control-Allow-Origin: *');
|
585 |
|
586 |
|
586 |
// Envoie sur la sortie standard le contenu de la réponse HTTP
|
587 |
// Envoie sur la sortie standard le contenu de la réponse HTTP
|
587 |
print $retour;
|
588 |
print $retour;
|
588 |
|
589 |
|
589 |
// Nous terminons le script
|
590 |
// Nous terminons le script
|
590 |
exit(0);
|
591 |
exit(0);
|
591 |
}
|
592 |
}
|
592 |
|
593 |
|
593 |
/**
|
594 |
/**
|
594 |
* Si des exceptions ou des erreurs sont soulevées par le serveur ou les services, elles sont gérées par cette méthode.
|
595 |
* Si des exceptions ou des erreurs sont soulevées par le serveur ou les services, elles sont gérées par cette méthode.
|
595 |
* 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
|
596 |
* 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
|
596 |
* standard (via echo).
|
597 |
* standard (via echo).
|
597 |
* Si seulement des erreurs de type E_USER_NOTICE, sont présentes, elle sont envoyées en fonction du contenu du paramètre de
|
598 |
* Si seulement des erreurs de type E_USER_NOTICE, sont présentes, elle sont envoyées en fonction du contenu du paramètre de
|
598 |
* config "debogage_mode" :
|
599 |
* config "debogage_mode" :
|
599 |
* - Debug::MODE_ECHO : les messages sont affichés en utilisant echo au moment où ils sont déclenchés dans le code.
|
600 |
* - Debug::MODE_ECHO : les messages sont affichés en utilisant echo au moment où ils sont déclenchés dans le code.
|
600 |
* - Debug::MODE_NOTICE : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type
|
601 |
* - Debug::MODE_NOTICE : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type
|
601 |
* E_USER_NOTICE et sont renvoyés sur la sortie standard à la fin de l'execution du programme (via echo).
|
602 |
* E_USER_NOTICE et sont renvoyés sur la sortie standard à la fin de l'execution du programme (via echo).
|
602 |
* - Debug::MODE_ENTETE_HTTP : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type
|
603 |
* - Debug::MODE_ENTETE_HTTP : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type
|
603 |
* E_USER_NOTICE et sont renvoyés dans un entête HTTP (X_REST_DEBOGAGE_MESSAGES) à la fin de l'execution du programme.
|
604 |
* E_USER_NOTICE et sont renvoyés dans un entête HTTP (X_REST_DEBOGAGE_MESSAGES) à la fin de l'execution du programme.
|
604 |
* - Autre valeur : les messages sont formatés puis retournés par la fonction de débogage (à vous de les afficher).
|
605 |
* - Autre valeur : les messages sont formatés puis retournés par la fonction de débogage (à vous de les afficher).
|
605 |
*/
|
606 |
*/
|
606 |
public static function gererErreurs() {
|
607 |
public static function gererErreurs() {
|
607 |
$retour = '';
|
608 |
$retour = '';
|
608 |
if (self::$debogageActivation && GestionnaireException::getExceptionsNbre() > 0) {
|
609 |
if (self::$debogageActivation && GestionnaireException::getExceptionsNbre() > 0) {
|
609 |
|
610 |
|
610 |
$exceptionsTriees = GestionnaireException::getExceptionsTriees();
|
611 |
$exceptionsTriees = GestionnaireException::getExceptionsTriees();
|
611 |
reset($exceptionsTriees);
|
612 |
reset($exceptionsTriees);
|
612 |
$debogageSeulement = true;
|
613 |
$debogageSeulement = true;
|
613 |
if (array_key_exists(E_USER_ERROR, $exceptionsTriees)) {
|
614 |
if (array_key_exists(E_USER_ERROR, $exceptionsTriees)) {
|
614 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_ERREUR);
|
615 |
self::envoyerEnteteStatutHttp(self::HTTP_CODE_ERREUR);
|
615 |
$debogageSeulement = false;
|
616 |
$debogageSeulement = false;
|
616 |
}
|
617 |
}
|
617 |
|
618 |
|
618 |
$exceptionsFormatees = array();
|
619 |
$exceptionsFormatees = array();
|
619 |
foreach ($exceptionsTriees as $exceptions) {
|
620 |
foreach ($exceptionsTriees as $exceptions) {
|
620 |
foreach ($exceptions as $e) {
|
621 |
foreach ($exceptions as $e) {
|
621 |
if ($debogageSeulement && self::$debogageMode == Debug::MODE_ENTETE_HTTP) {
|
622 |
if ($debogageSeulement && self::$debogageMode == Debug::MODE_ENTETE_HTTP) {
|
622 |
$exceptionsFormatees[] = GestionnaireException::formaterExceptionDebug($e);
|
623 |
$exceptionsFormatees[] = GestionnaireException::formaterExceptionDebug($e);
|
623 |
} else {
|
624 |
} else {
|
624 |
$retour = GestionnaireException::formaterExceptionXhtml($e);
|
625 |
$retour = GestionnaireException::formaterExceptionXhtml($e);
|
625 |
}
|
626 |
}
|
626 |
}
|
627 |
}
|
627 |
}
|
628 |
}
|
628 |
|
629 |
|
629 |
if ($debogageSeulement && self::$debogageMode == Debug::MODE_ENTETE_HTTP) {
|
630 |
if ($debogageSeulement && self::$debogageMode == Debug::MODE_ENTETE_HTTP) {
|
630 |
header('X_REST_DEBOGAGE_MESSAGES: '.json_encode($exceptionsFormatees));
|
631 |
header('X_REST_DEBOGAGE_MESSAGES: '.json_encode($exceptionsFormatees));
|
631 |
}
|
632 |
}
|
632 |
}
|
633 |
}
|
633 |
return $retour;
|
634 |
return $retour;
|
634 |
}
|
635 |
}
|
635 |
|
636 |
|
636 |
|
637 |
|
637 |
/**
|
638 |
/**
|
638 |
* Permet d'ajouter un message d'erreur ou d'avertissement qui sera envoyé au client.
|
639 |
* Permet d'ajouter un message d'erreur ou d'avertissement qui sera envoyé au client.
|
639 |
* Le message doit être au format texte et en UTF-8.
|
640 |
* Le message doit être au format texte et en UTF-8.
|
640 |
* @param string $message le message à envoyer.
|
641 |
* @param string $message le message à envoyer.
|
641 |
*/
|
642 |
*/
|
642 |
public static function ajouterMessage($message) {
|
643 |
public static function ajouterMessage($message) {
|
643 |
if (isset($message) && !empty($message)) {
|
644 |
if (isset($message) && !empty($message)) {
|
644 |
self::$messages[] = $message;
|
645 |
self::$messages[] = $message;
|
645 |
}
|
646 |
}
|
646 |
}
|
647 |
}
|
647 |
|
648 |
|
648 |
/**
|
649 |
/**
|
649 |
* Envoie au client les éventuels messages d'erreur et d'avertissement du Serveur.
|
650 |
* Envoie au client les éventuels messages d'erreur et d'avertissement du Serveur.
|
650 |
* Le format d'envoie est text/plain encodé en UTF-8.
|
651 |
* Le format d'envoie est text/plain encodé en UTF-8.
|
651 |
*/
|
652 |
*/
|
652 |
private static function envoyerMessages() {
|
653 |
private static function envoyerMessages() {
|
653 |
if (count(self::$messages) > 0) {
|
654 |
if (count(self::$messages) > 0) {
|
654 |
header("Content-Type: text/plain; charset=utf-8");
|
655 |
header("Content-Type: text/plain; charset=utf-8");
|
655 |
return implode("\n", self::$messages);
|
656 |
return implode("\n", self::$messages);
|
656 |
}
|
657 |
}
|
657 |
}
|
658 |
}
|
658 |
}
|
659 |
}
|
659 |
?>
|
660 |
?>
|