Subversion Repositories eFlore/Applications.cel

Rev

Rev 946 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

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