WebSVN – eFlore/Applications.cel – Diff – /trunk/jrest/bibliotheque/CelRestClient.php



<?php
// declare(encoding='UTF-8');
/**
 * Client REST chargé depuis la classe CEL.
 *
 * @internal   Mininum PHP version : 5.2
 * @category   CEL
 * @package    Services
 * @subpackage Bibliothèques
 * @version    0.1
 * @author     Mathias CHOUET <mathias@tela-botanica.org>
 * @author     Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @author     Aurelien PERONNET <aurelien@tela-botanica.org>
 * @license    GPL v3 <http://www.gnu.org/licenses/gpl.txt>
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
 */
// TODO : remplacer les trigger_error par des exceptions qui pourrait être attrapées...
class CelRestClient {
	const HTTP_URL_REQUETE_SEPARATEUR = '&';
	const HTTP_URL_REQUETE_CLE_VALEUR_SEPARATEUR = '=';
	private $http_methodes = array('GET', 'POST', 'PUT', 'DELETE', 'HEAD', 'OPTIONS', 'CONNECT', 'TRACE');
	protected $parametres = null;
	private $url = null;
	private $reponse_entetes = null;
 
	//+----------------------------------------------------------------------------------------------------------------+
	// ACCESSEURS
 
	public function getReponseEntetes($cle) {
		return $this->reponse_entetes;
	}
 
	public function getParametre($cle) {
		$valeur = (isset($this->parametres[$cle])) ? $this->parametres[$cle] : null;
		return $valeur;
	}
 
	public function ajouterParametre($cle, $valeur) {
		$this->parametres[$cle] = $valeur;
	}
 
	public function supprimerParametre($cle) {
		unset($this->parametres[$cle]);
	}
 
	public function nettoyerParametres() {
		$this->parametres = null;
	}
 
	//+----------------------------------------------------------------------------------------------------------------+
	// MÉTHODES
 
	public function consulter($url) {
		$retour = $this->envoyerRequete($url, 'GET');
		return $retour;
	}
 
	public function ajouter($url, Array $donnees) {
		$retour = $this->envoyerRequete($url, 'PUT', $donnees);
		return $retour;
	}
 
	public function modifier($url, Array $donnees) {
		$retour = $this->envoyerRequete($url, 'POST', $donnees);
		return $retour;
	}
 
	public function supprimer($url) {
		$retour = $this->envoyerRequete($url, 'DELETE');
		return $retour;
	}
 
	public function envoyerRequete($url, $mode, Array $donnees = array()) {
		$this->url = $url;
		$contenu = false;
		if (! in_array($mode, $this->http_methodes)) {
			$e = "Le mode de requête '$mode' n'est pas accepté!";

				$e = "L'ouverture de l'url '{$this->url}' par la méthode HTTP '$mode' a échoué!";
				trigger_error($e, E_USER_WARNING);
			} else {
				// Informations sur les en-têtes et métadonnées du flux
				$this->reponse_entetes = stream_get_meta_data($flux);
 
				// Contenu actuel de $url
				$contenu = stream_get_contents($flux);
 
				fclose($flux);
			}
			$this->traiterEntete();
		}
		$this->reinitialiser();
		return $contenu;
	}
 
	private function traiterUrlParametres() {
		$parametres = array();
		if (count($this->parametres) > 0) {
			foreach ($this->parametres as $cle => $valeur) {
				$cle = rawurlencode($cle);

			}
			$url_parametres = implode(self::HTTP_URL_REQUETE_SEPARATEUR, $parametres);
			$this->url = $this->url.'?'.$url_parametres;
		}
	}
 
	private function traiterEntete() {
		$infos = $this->analyserEntete();
		$this->traiterEnteteDebogage($infos);
	}
 
	private function analyserEntete() {
		$entetes = $this->reponse_entetes;
		$infos = array('date' => null, 'uri' => $this->url, 'debogages' => null);
		if (isset($entetes)) {
			if (isset($entetes['wrapper_data'])) {
				$entetes = $entetes['wrapper_data'];
			}

				}
			}
		}
		return $infos;
	}
 
	private function traiterEnteteDebogage($entetes_analyses) {
		if (isset($entetes['debogages'])) {
			$date = $entetes['date'];
			$uri = $entetes['uri'];
			$debogages = $entetes['debogages'];

				$e = "DEBOGAGE : $date - $uri :\n$debogage";
				trigger_error($e, E_USER_NOTICE);
			}
		}
	}
 
	private function reinitialiser() {
		$this->nettoyerParametres();
	}
}


Rev 946	Rev 2462
Line 1...	Line 1...
1	`<?php`	1	`<?php`
2	`// declare(encoding='UTF-8');`	2	`// declare(encoding='UTF-8');`
3	`/**`	3	`/**`
4	`* Classe modèle spécifique à l'application, donc d'accés au données, elle ne devrait pas être appelée de l'extérieur.`	4	`* Client REST chargé depuis la classe CEL.`
5	`*`	5	`*`
-		6	`* @internal Mininum PHP version : 5.2`
6	`* @category php5`	7	`* @category CEL`
7	`* @package Cel`	8	`* @package Services`
-		9	`* @subpackage Bibliothèques`
-		10	`* @version 0.1`
-		11	`* @author Mathias CHOUET <mathias@tela-botanica.org>`
8	`* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>`	12	`* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>`
9	`* @copyright 2010 Tela-Botanica`	13	`* @author Aurelien PERONNET <aurelien@tela-botanica.org>`
10	`* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL`	14	`* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>`
11	`* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL`	15	`* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>`
12	`* @version SVN: $Id$`	16	`* @copyright 1999-2014 Tela Botanica <accueil@tela-botanica.org>`
13	`*/`	17	`*/`
14	`// TODO : remplacer les trigger_error par des exceptions qui pourrait être attrapées...`	18	`// TODO : remplacer les trigger_error par des exceptions qui pourrait être attrapées...`
15	`class CelRestClient {`	19	`class CelRestClient {`
16	`const HTTP_URL_REQUETE_SEPARATEUR = '&';`	20	`const HTTP_URL_REQUETE_SEPARATEUR = '&';`
17	`const HTTP_URL_REQUETE_CLE_VALEUR_SEPARATEUR = '=';`	21	`const HTTP_URL_REQUETE_CLE_VALEUR_SEPARATEUR = '=';`
18	`private $http_methodes = array('GET', 'POST', 'PUT', 'DELETE', 'HEAD', 'OPTIONS', 'CONNECT', 'TRACE');`	22	`private $http_methodes = array('GET', 'POST', 'PUT', 'DELETE', 'HEAD', 'OPTIONS', 'CONNECT', 'TRACE');`
19	`protected $parametres = null;`	23	`protected $parametres = null;`
20	`private $url = null;`	24	`private $url = null;`
21	`private $reponse_entetes = null;`	25	`private $reponse_entetes = null;`
22		26
23	`//+----------------------------------------------------------------------------------------------------------------+`	27	`//+----------------------------------------------------------------------------------------------------------------+`
24	`// ACCESSEURS`	28	`// ACCESSEURS`
25		29
26	`public function getReponseEntetes($cle) {`	30	`public function getReponseEntetes($cle) {`
27	`return $this->reponse_entetes;`	31	`return $this->reponse_entetes;`
28	`}`	32	`}`
29		33
30	`public function getParametre($cle) {`	34	`public function getParametre($cle) {`
31	`$valeur = (isset($this->parametres[$cle])) ? $this->parametres[$cle] : null;`	35	`$valeur = (isset($this->parametres[$cle])) ? $this->parametres[$cle] : null;`
32	`return $valeur;`	36	`return $valeur;`
33	`}`	37	`}`
34		38
35	`public function ajouterParametre($cle, $valeur) {`	39	`public function ajouterParametre($cle, $valeur) {`
36	`$this->parametres[$cle] = $valeur;`	40	`$this->parametres[$cle] = $valeur;`
37	`}`	41	`}`
38		42
39	`public function supprimerParametre($cle) {`	43	`public function supprimerParametre($cle) {`
40	`unset($this->parametres[$cle]);`	44	`unset($this->parametres[$cle]);`
41	`}`	45	`}`
42		46
43	`public function nettoyerParametres() {`	47	`public function nettoyerParametres() {`
44	`$this->parametres = null;`	48	`$this->parametres = null;`
45	`}`	49	`}`
46		50
47	`//+----------------------------------------------------------------------------------------------------------------+`	51	`//+----------------------------------------------------------------------------------------------------------------+`
48	`// MÉTHODES`	52	`// MÉTHODES`
49		53
50	`public function consulter($url) {`	54	`public function consulter($url) {`
51	`$retour = $this->envoyerRequete($url, 'GET');`	55	`$retour = $this->envoyerRequete($url, 'GET');`
52	`return $retour;`	56	`return $retour;`
53	`}`	57	`}`
54		58
55	`public function ajouter($url, Array $donnees) {`	59	`public function ajouter($url, Array $donnees) {`
56	`$retour = $this->envoyerRequete($url, 'PUT', $donnees);`	60	`$retour = $this->envoyerRequete($url, 'PUT', $donnees);`
57	`return $retour;`	61	`return $retour;`
58	`}`	62	`}`
59		63
60	`public function modifier($url, Array $donnees) {`	64	`public function modifier($url, Array $donnees) {`
61	`$retour = $this->envoyerRequete($url, 'POST', $donnees);`	65	`$retour = $this->envoyerRequete($url, 'POST', $donnees);`
62	`return $retour;`	66	`return $retour;`
63	`}`	67	`}`
64		68
65	`public function supprimer($url) {`	69	`public function supprimer($url) {`
66	`$retour = $this->envoyerRequete($url, 'DELETE');`	70	`$retour = $this->envoyerRequete($url, 'DELETE');`
67	`return $retour;`	71	`return $retour;`
68	`}`	72	`}`
69		73
70	`public function envoyerRequete($url, $mode, Array $donnees = array()) {`	74	`public function envoyerRequete($url, $mode, Array $donnees = array()) {`
71	`$this->url = $url;`	75	`$this->url = $url;`
72	`$contenu = false;`	76	`$contenu = false;`
73	`if (! in_array($mode, $this->http_methodes)) {`	77	`if (! in_array($mode, $this->http_methodes)) {`
74	`$e = "Le mode de requête '$mode' n'est pas accepté!";`	78	`$e = "Le mode de requête '$mode' n'est pas accepté!";`
Line 88...	Line 92...
88	`$e = "L'ouverture de l'url '{$this->url}' par la méthode HTTP '$mode' a échoué!";`	92	`$e = "L'ouverture de l'url '{$this->url}' par la méthode HTTP '$mode' a échoué!";`
89	`trigger_error($e, E_USER_WARNING);`	93	`trigger_error($e, E_USER_WARNING);`
90	`} else {`	94	`} else {`
91	`// Informations sur les en-têtes et métadonnées du flux`	95	`// Informations sur les en-têtes et métadonnées du flux`
92	`$this->reponse_entetes = stream_get_meta_data($flux);`	96	`$this->reponse_entetes = stream_get_meta_data($flux);`
93		97
94	`// Contenu actuel de $url`	98	`// Contenu actuel de $url`
95	`$contenu = stream_get_contents($flux);`	99	`$contenu = stream_get_contents($flux);`
96		100
97	`fclose($flux);`	101	`fclose($flux);`
98	`}`	102	`}`
99	`$this->traiterEntete();`	103	`$this->traiterEntete();`
100	`}`	104	`}`
101	`$this->reinitialiser();`	105	`$this->reinitialiser();`
102	`return $contenu;`	106	`return $contenu;`
103	`}`	107	`}`
104		108
105	`private function traiterUrlParametres() {`	109	`private function traiterUrlParametres() {`
106	`$parametres = array();`	110	`$parametres = array();`
107	`if (count($this->parametres) > 0) {`	111	`if (count($this->parametres) > 0) {`
108	`foreach ($this->parametres as $cle => $valeur) {`	112	`foreach ($this->parametres as $cle => $valeur) {`
109	`$cle = rawurlencode($cle);`	113	`$cle = rawurlencode($cle);`
Line 112...	Line 116...
112	`}`	116	`}`
113	`$url_parametres = implode(self::HTTP_URL_REQUETE_SEPARATEUR, $parametres);`	117	`$url_parametres = implode(self::HTTP_URL_REQUETE_SEPARATEUR, $parametres);`
114	`$this->url = $this->url.'?'.$url_parametres;`	118	`$this->url = $this->url.'?'.$url_parametres;`
115	`}`	119	`}`
116	`}`	120	`}`
117		121
118	`private function traiterEntete() {`	122	`private function traiterEntete() {`
119	`$infos = $this->analyserEntete();`	123	`$infos = $this->analyserEntete();`
120	`$this->traiterEnteteDebogage($infos);`	124	`$this->traiterEnteteDebogage($infos);`
121	`}`	125	`}`
122		126
123	`private function analyserEntete() {`	127	`private function analyserEntete() {`
124	`$entetes = $this->reponse_entetes;`	128	`$entetes = $this->reponse_entetes;`
125	`$infos = array('date' => null, 'uri' => $this->url, 'debogages' => null);`	129	`$infos = array('date' => null, 'uri' => $this->url, 'debogages' => null);`
126	`if (isset($entetes)) {`	130	`if (isset($entetes)) {`
127	`if (isset($entetes['wrapper_data'])) {`	131	`if (isset($entetes['wrapper_data'])) {`
128	`$entetes = $entetes['wrapper_data'];`	132	`$entetes = $entetes['wrapper_data'];`
129	`}`	133	`}`
Line 136...	Line 140...
136	`}`	140	`}`
137	`}`	141	`}`
138	`}`	142	`}`
139	`return $infos;`	143	`return $infos;`
140	`}`	144	`}`
141		145
142	`private function traiterEnteteDebogage($entetes_analyses) {`	146	`private function traiterEnteteDebogage($entetes_analyses) {`
143	`if (isset($entetes['debogages'])) {`	147	`if (isset($entetes['debogages'])) {`
144	`$date = $entetes['date'];`	148	`$date = $entetes['date'];`
145	`$uri = $entetes['uri'];`	149	`$uri = $entetes['uri'];`
146	`$debogages = $entetes['debogages'];`	150	`$debogages = $entetes['debogages'];`
Line 148...	Line 152...
148	`$e = "DEBOGAGE : $date - $uri :\n$debogage";`	152	`$e = "DEBOGAGE : $date - $uri :\n$debogage";`
149	`trigger_error($e, E_USER_NOTICE);`	153	`trigger_error($e, E_USER_NOTICE);`
150	`}`	154	`}`
151	`}`	155	`}`
152	`}`	156	`}`
153		157
154	`private function reinitialiser() {`	158	`private function reinitialiser() {`
155	`$this->nettoyerParametres();`	159	`$this->nettoyerParametres();`
156	`}`	160	`}`
157	`}`	161	`}`
158		162

Subversion Repositories eFlore/Applications.cel

(root)/trunk/jrest/bibliotheque/CelRestClient.php – Rev 946 → 2462