WebSVN – Applications.referentiel – Diff – /trunk/services/modules/Ref.php


<?php
/**
 * Classe mère abstraite contenant les méthodes génériques des services des Référentiels.
 * Encodage en entrée : utf8
 * Encodage en sortie : utf8
 * 
 * @category	Php 5.2
 * @package		Referentiel
 * @author		Jean-Pascal MILCENT <jpm@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	2010 Tela-Botanica
 * @version		$Id$
 */
abstract class Ref {
	
	public $config;
	protected $bdd;
	protected $messages = array();
	protected $debug = array();
	protected $distinct = false;
	protected $orderby = null;
	protected $formatRetour = 'objet';
	protected $start = 0; 
	protected $limit = 150;
	
	public function __construct($config, $demarrer_session = true) {
		// Tableau contenant la config de Jrest
		$this->config = $config;
		
		// Connection à la base de données
		$this->bdd = $this->connecterPDO($this->config, 'database');
		
		// Nettoyage du $_GET (sécurité)
		if (isset($_GET)) {
			$get_params = array('orderby', 'distinct', 'start', 'limit', 'formatRetour');
			foreach ($get_params as $get) {
				if (isset($_GET[$get])) {
					$verifier = array('NULL', "\n", "\r", "\\", "'", '"', "\x00", "\x1a", ';');
					$_GET[$get] = strip_tags(str_replace($verifier, '', $_GET[$get]));
					if ($_GET[$get] != '') {
						$this->$get = $_GET[$get];
					} else {
						$_GET[$get] = null;
					}
				}
			}
		}
	}
 
	/**
	 * Méthode appelée quand aucun paramètre n'est passé dans l'url et avec une requête de type GET.
	 */
	public function getRessource() {
		$this->getElement(array());
	}
	
	protected function envoyer($donnees = null, $mime = 'text/html', $encodage = 'utf-8', $json = true) {
		// Traitements des messages d'erreurs et données
		if (count($this->messages) != 0) {
			header('HTTP/1.1 424 Method failure');
 
 
			$sortie = $this->messages;
			// En plus de la réponse, nous passons les messages dans l'entete car la réponse ne peut pas être récupérée
			// avec ce type d'erreur HTTP en php..
			// FIXME : comment récupérer en php le contenu de la réponse portant le code HTTP 424 ou 500
			$this->envoyerEnteteMessage();
		} else {
			$sortie = $donnees;
		}
 
		// Gestion de l'envoie du déboguage
		$this->envoyerEnteteDebogage();
		
		// Encodage au format et JSON et envoie sur la sortie standard
		$contenu = $json ? json_encode($sortie) : $sortie;
		$mime = $json ? 'application/json' : $mime;
		$this->envoyerContenu($encodage, $mime, $contenu);
	}
	
	protected function envoyerEnteteMessage() {
		if (!is_array($this->messages)) {
			$this->messages[] = $this->messages;
		}
		if (count($this->messages) != 0) {
			foreach ($this->messages as $cle => $val) {
				if (is_array($val)) {
					$this->messages[$cle] = print_r($val, true);
				}
			}
			header('X-MessageJrest-Data: '.json_encode($this->messages));
		}
	}
	
	protected function envoyerEnteteDebogage() {
		if (!is_array($this->debug)) {
			$this->debug[] = $this->debug;
		}
		if (count($this->debug) != 0) {
			foreach ($this->debug as $cle => $val) {
				if (is_array($val)) {
					$this->debug[$cle] = print_r($val, true);
				}
			}
			header('X-DebugJrest-Data: '.json_encode($this->debug));
		}
	}
	
	protected function envoyerContenu($encodage, $mime, $contenu) {
		header("Content-Type: $mime; charset=$encodage");
		print $contenu;
	}
	
	private function connecterPDO($config, $base = 'database') {
        $cfg = $config[$base];
		$dsn = $cfg['phptype'].':dbname='.$cfg['database'].';host='.$cfg['hostspec'];
		try {
    		$PDO = new PDO($dsn, $cfg['username'], $cfg['password']);
		} catch (PDOException $e) {
    		echo 'La connexion à la base de donnée via PDO a échouée : ' . $e->getMessage();
		}
		// Passe en UTF-8 la connexion à la BDD
		$PDO->exec("SET NAMES 'utf8'");
		// Affiche les erreurs détectées par PDO (sinon mode silencieux => aucune erreur affiché)
		$PDO->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
        return $PDO;
	}
	
	protected function executerRequete($requete, $message_echec) {
		try {
			$infos = $this->bdd->query($requete)->fetchAll(PDO::FETCH_ASSOC);
			if ($infos === false) {
				$this->messages[] = $message_echec;
			}
		} catch (PDOException $e) {
			$this->messages[] = sprintf($this->getTxt('sql_erreur_requete'), $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
		}
		return $infos;
	}
	
	protected function getTxt($id) {
		$sortie = '';
		switch ($id) {
			case 'sql_erreur' : $sortie = 'Requête echec. Fichier : "%s". Ligne : "%s". Message : %s'; break;
			case 'sql_erreur_requete' : $sortie = "Requête echec.\nFichier : %s.\nLigne : %s.\nMessage : %s.\nRequête : %s"; break;
			default : $sortie = $id; 
		}
		return $sortie;
	}
	
	protected function traiterParametresUrl($params_attendu, $params, $pourBDD = true) {
		$sortie = array();
		foreach ($params_attendu as $num => $nom) {
			if (isset($params[$num]) && $params[$num] != '*') {
				if ($pourBDD) {
					$params[$num] = $this->bdd->quote($params[$num]);
				}
				$sortie[$nom] = $params[$num];
			}
		}
		return $sortie;
	}
	
	protected function traiterParametresPost($params_attendu, $params, $pourBDD = true) {
		$sortie = array();
		foreach ($params_attendu as $num => $nom) {
			if (isset($params[$nom]) && $params[$nom] != '') {
				if ($pourBDD) {
					$params[$nom] = $this->bdd->quote($params[$nom]);
				}
				$sortie[$nom] = $params[$nom];
			} else {
				if ($pourBDD) {
					$sortie[$nom] = 'NULL';
				} else {
					$sortie[$nom] = '';
				}
			}
		}
		return $sortie;
	}
	
	protected function traiterBddClauseIn($chaine) {
		$sortie = '';
		$chaine = trim($chaine, " '");
		if ($chaine != '') {
			$valeurs = explode(',', $chaine);
			foreach ($valeurs as $id => $valeur) {
				$valeurs[$id] = $this->bdd->quote($valeur);
			}
			$sortie = implode(',', $valeurs);
		}
		return $sortie;
	}
}
?>

Rev 51	Rev 141
1	`<?php`	1	`<?php`
2	`/**`	2	`/**`
3	`* Classe mère abstraite contenant les méthodes génériques des services des Référentiels.`	3	`* Classe mère abstraite contenant les méthodes génériques des services des Référentiels.`
4	`* Encodage en entrée : utf8`	4	`* Encodage en entrée : utf8`
5	`* Encodage en sortie : utf8`	5	`* Encodage en sortie : utf8`
6	`*`	6	`*`
7	`* @category Php 5.2`	7	`* @category Php 5.2`
8	`* @package Referentiel`	8	`* @package Referentiel`
9	`* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>`	9	`* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>`
10	`* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>`	10	`* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>`
11	`* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>`	11	`* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>`
12	`* @copyright 2010 Tela-Botanica`	12	`* @copyright 2010 Tela-Botanica`
13	`* @version $Id$`	13	`* @version $Id$`
14	`*/`	14	`*/`
15	`abstract class Ref {`	15	`abstract class Ref {`
16		16
17	`public $config;`	17	`public $config;`
18	`protected $bdd;`	18	`protected $bdd;`
19	`protected $messages = array();`	19	`protected $messages = array();`
20	`protected $debug = array();`	20	`protected $debug = array();`
21	`protected $distinct = false;`	21	`protected $distinct = false;`
22	`protected $orderby = null;`	22	`protected $orderby = null;`
23	`protected $formatRetour = 'objet';`	23	`protected $formatRetour = 'objet';`
24	`protected $start = 0;`	24	`protected $start = 0;`
25	`protected $limit = 150;`	25	`protected $limit = 150;`
26		26
27	`public function __construct($config, $demarrer_session = true) {`	27	`public function __construct($config, $demarrer_session = true) {`
28	`// Tableau contenant la config de Jrest`	28	`// Tableau contenant la config de Jrest`
29	`$this->config = $config;`	29	`$this->config = $config;`
30		30
31	`// Connection à la base de données`	31	`// Connection à la base de données`
32	`$this->bdd = $this->connecterPDO($this->config, 'database');`	32	`$this->bdd = $this->connecterPDO($this->config, 'database');`
33		33
34	`// Nettoyage du $_GET (sécurité)`	34	`// Nettoyage du $_GET (sécurité)`
35	`if (isset($_GET)) {`	35	`if (isset($_GET)) {`
36	`$get_params = array('orderby', 'distinct', 'start', 'limit', 'formatRetour');`	36	`$get_params = array('orderby', 'distinct', 'start', 'limit', 'formatRetour');`
37	`foreach ($get_params as $get) {`	37	`foreach ($get_params as $get) {`
38	`if (isset($_GET[$get])) {`	38	`if (isset($_GET[$get])) {`
39	`$verifier = array('NULL', "\n", "\r", "\\", "'", '"', "\x00", "\x1a", ';');`	39	`$verifier = array('NULL', "\n", "\r", "\\", "'", '"', "\x00", "\x1a", ';');`
40	`$_GET[$get] = strip_tags(str_replace($verifier, '', $_GET[$get]));`	40	`$_GET[$get] = strip_tags(str_replace($verifier, '', $_GET[$get]));`
41	`if ($_GET[$get] != '') {`	41	`if ($_GET[$get] != '') {`
42	`$this->$get = $_GET[$get];`	42	`$this->$get = $_GET[$get];`
43	`} else {`	43	`} else {`
44	`$_GET[$get] = null;`	44	`$_GET[$get] = null;`
45	`}`	45	`}`
46	`}`	46	`}`
47	`}`	47	`}`
48	`}`	48	`}`
49	`}`	49	`}`
50		50
51	`/**`	51	`/**`
52	`* Méthode appelée quand aucun paramètre n'est passé dans l'url et avec une requête de type GET.`	52	`* Méthode appelée quand aucun paramètre n'est passé dans l'url et avec une requête de type GET.`
53	`*/`	53	`*/`
54	`public function getRessource() {`	54	`public function getRessource() {`
55	`$this->getElement(array());`	55	`$this->getElement(array());`
56	`}`	56	`}`
57		57
58	`protected function envoyer($donnees = null, $mime = 'text/html', $encodage = 'utf-8', $json = true) {`	58	`protected function envoyer($donnees = null, $mime = 'text/html', $encodage = 'utf-8', $json = true) {`
59	`// Traitements des messages d'erreurs et données`	59	`// Traitements des messages d'erreurs et données`
60	`if (count($this->messages) != 0) {`	60	`if (count($this->messages) != 0) {`
61	`header('HTTP/1.1 424 Method failure');`	61	`header('HTTP/1.1 424 Method failure');`
62	`$mime = 'text/html';`	-
63	`$encodage = 'utf-8';`	-
64	`$sortie = $this->messages;`	62	`$sortie = $this->messages;`
65	`// En plus de la réponse, nous passons les messages dans l'entete car la réponse ne peut pas être récupérée`	63	`// En plus de la réponse, nous passons les messages dans l'entete car la réponse ne peut pas être récupérée`
66	`// avec ce type d'erreur HTTP en php..`	64	`// avec ce type d'erreur HTTP en php..`
67	`// FIXME : comment récupérer en php le contenu de la réponse portant le code HTTP 424 ou 500`	65	`// FIXME : comment récupérer en php le contenu de la réponse portant le code HTTP 424 ou 500`
68	`$this->envoyerEnteteMessage();`	66	`$this->envoyerEnteteMessage();`
69	`} else {`	67	`} else {`
70	`$sortie = $donnees;`	68	`$sortie = $donnees;`
71	`}`	69	`}`
72		70
73	`// Gestion de l'envoie du déboguage`	71	`// Gestion de l'envoie du déboguage`
74	`$this->envoyerEnteteDebogage();`	72	`$this->envoyerEnteteDebogage();`
75		73
76	`// Encodage au format et JSON et envoie sur la sortie standard`	74	`// Encodage au format et JSON et envoie sur la sortie standard`
77	`$contenu = $json ? json_encode($sortie) : $sortie;`	75	`$contenu = $json ? json_encode($sortie) : $sortie;`
-		76	`$mime = $json ? 'application/json' : $mime;`
78	`$this->envoyerContenu($encodage, $mime, $contenu);`	77	`$this->envoyerContenu($encodage, $mime, $contenu);`
79	`}`	78	`}`
80		79
81	`protected function envoyerEnteteMessage() {`	80	`protected function envoyerEnteteMessage() {`
82	`if (!is_array($this->messages)) {`	81	`if (!is_array($this->messages)) {`
83	`$this->messages[] = $this->messages;`	82	`$this->messages[] = $this->messages;`
84	`}`	83	`}`
85	`if (count($this->messages) != 0) {`	84	`if (count($this->messages) != 0) {`
86	`foreach ($this->messages as $cle => $val) {`	85	`foreach ($this->messages as $cle => $val) {`
87	`if (is_array($val)) {`	86	`if (is_array($val)) {`
88	`$this->messages[$cle] = print_r($val, true);`	87	`$this->messages[$cle] = print_r($val, true);`
89	`}`	88	`}`
90	`}`	89	`}`
91	`header('X-MessageJrest-Data: '.json_encode($this->messages));`	90	`header('X-MessageJrest-Data: '.json_encode($this->messages));`
92	`}`	91	`}`
93	`}`	92	`}`
94		93
95	`protected function envoyerEnteteDebogage() {`	94	`protected function envoyerEnteteDebogage() {`
96	`if (!is_array($this->debug)) {`	95	`if (!is_array($this->debug)) {`
97	`$this->debug[] = $this->debug;`	96	`$this->debug[] = $this->debug;`
98	`}`	97	`}`
99	`if (count($this->debug) != 0) {`	98	`if (count($this->debug) != 0) {`
100	`foreach ($this->debug as $cle => $val) {`	99	`foreach ($this->debug as $cle => $val) {`
101	`if (is_array($val)) {`	100	`if (is_array($val)) {`
102	`$this->debug[$cle] = print_r($val, true);`	101	`$this->debug[$cle] = print_r($val, true);`
103	`}`	102	`}`
104	`}`	103	`}`
105	`header('X-DebugJrest-Data: '.json_encode($this->debug));`	104	`header('X-DebugJrest-Data: '.json_encode($this->debug));`
106	`}`	105	`}`
107	`}`	106	`}`
108		107
109	`protected function envoyerContenu($encodage, $mime, $contenu) {`	108	`protected function envoyerContenu($encodage, $mime, $contenu) {`
110	`header("Content-Type: $mime; charset=$encodage");`	109	`header("Content-Type: $mime; charset=$encodage");`
111	`print $contenu;`	110	`print $contenu;`
112	`}`	111	`}`
113		112
114	`private function connecterPDO($config, $base = 'database') {`	113	`private function connecterPDO($config, $base = 'database') {`
115	`$cfg = $config[$base];`	114	`$cfg = $config[$base];`
116	`$dsn = $cfg['phptype'].':dbname='.$cfg['database'].';host='.$cfg['hostspec'];`	115	`$dsn = $cfg['phptype'].':dbname='.$cfg['database'].';host='.$cfg['hostspec'];`
117	`try {`	116	`try {`
118	`$PDO = new PDO($dsn, $cfg['username'], $cfg['password']);`	117	`$PDO = new PDO($dsn, $cfg['username'], $cfg['password']);`
119	`} catch (PDOException $e) {`	118	`} catch (PDOException $e) {`
120	`echo 'La connexion à la base de donnée via PDO a échouée : ' . $e->getMessage();`	119	`echo 'La connexion à la base de donnée via PDO a échouée : ' . $e->getMessage();`
121	`}`	120	`}`
122	`// Passe en UTF-8 la connexion à la BDD`	121	`// Passe en UTF-8 la connexion à la BDD`
123	`$PDO->exec("SET NAMES 'utf8'");`	122	`$PDO->exec("SET NAMES 'utf8'");`
124	`// Affiche les erreurs détectées par PDO (sinon mode silencieux => aucune erreur affiché)`	123	`// Affiche les erreurs détectées par PDO (sinon mode silencieux => aucune erreur affiché)`
125	`$PDO->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);`	124	`$PDO->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);`
126	`return $PDO;`	125	`return $PDO;`
127	`}`	126	`}`
128		127
129	`protected function executerRequete($requete, $message_echec) {`	128	`protected function executerRequete($requete, $message_echec) {`
130	`try {`	129	`try {`
131	`$infos = $this->bdd->query($requete)->fetchAll(PDO::FETCH_ASSOC);`	130	`$infos = $this->bdd->query($requete)->fetchAll(PDO::FETCH_ASSOC);`
132	`if ($infos === false) {`	131	`if ($infos === false) {`
133	`$this->messages[] = $message_echec;`	132	`$this->messages[] = $message_echec;`
134	`}`	133	`}`
135	`} catch (PDOException $e) {`	134	`} catch (PDOException $e) {`
136	`$this->messages[] = sprintf($this->getTxt('sql_erreur_requete'), $e->getFile(), $e->getLine(), $e->getMessage(), $requete);`	135	`$this->messages[] = sprintf($this->getTxt('sql_erreur_requete'), $e->getFile(), $e->getLine(), $e->getMessage(), $requete);`
137	`}`	136	`}`
138	`return $infos;`	137	`return $infos;`
139	`}`	138	`}`
140		139
141	`protected function getTxt($id) {`	140	`protected function getTxt($id) {`
142	`$sortie = '';`	141	`$sortie = '';`
143	`switch ($id) {`	142	`switch ($id) {`
144	`case 'sql_erreur' : $sortie = 'Requête echec. Fichier : "%s". Ligne : "%s". Message : %s'; break;`	143	`case 'sql_erreur' : $sortie = 'Requête echec. Fichier : "%s". Ligne : "%s". Message : %s'; break;`
145	`case 'sql_erreur_requete' : $sortie = "Requête echec.\nFichier : %s.\nLigne : %s.\nMessage : %s.\nRequête : %s"; break;`	144	`case 'sql_erreur_requete' : $sortie = "Requête echec.\nFichier : %s.\nLigne : %s.\nMessage : %s.\nRequête : %s"; break;`
146	`default : $sortie = $id;`	145	`default : $sortie = $id;`
147	`}`	146	`}`
148	`return $sortie;`	147	`return $sortie;`
149	`}`	148	`}`
150		149
151	`protected function traiterParametresUrl($params_attendu, $params, $pourBDD = true) {`	150	`protected function traiterParametresUrl($params_attendu, $params, $pourBDD = true) {`
152	`$sortie = array();`	151	`$sortie = array();`
153	`foreach ($params_attendu as $num => $nom) {`	152	`foreach ($params_attendu as $num => $nom) {`
154	`if (isset($params[$num]) && $params[$num] != '*') {`	153	`if (isset($params[$num]) && $params[$num] != '*') {`
155	`if ($pourBDD) {`	154	`if ($pourBDD) {`
156	`$params[$num] = $this->bdd->quote($params[$num]);`	155	`$params[$num] = $this->bdd->quote($params[$num]);`
157	`}`	156	`}`
158	`$sortie[$nom] = $params[$num];`	157	`$sortie[$nom] = $params[$num];`
159	`}`	158	`}`
160	`}`	159	`}`
161	`return $sortie;`	160	`return $sortie;`
162	`}`	161	`}`
163		162
164	`protected function traiterParametresPost($params_attendu, $params, $pourBDD = true) {`	163	`protected function traiterParametresPost($params_attendu, $params, $pourBDD = true) {`
165	`$sortie = array();`	164	`$sortie = array();`
166	`foreach ($params_attendu as $num => $nom) {`	165	`foreach ($params_attendu as $num => $nom) {`
167	`if (isset($params[$nom]) && $params[$nom] != '') {`	166	`if (isset($params[$nom]) && $params[$nom] != '') {`
168	`if ($pourBDD) {`	167	`if ($pourBDD) {`
169	`$params[$nom] = $this->bdd->quote($params[$nom]);`	168	`$params[$nom] = $this->bdd->quote($params[$nom]);`
170	`}`	169	`}`
171	`$sortie[$nom] = $params[$nom];`	170	`$sortie[$nom] = $params[$nom];`
172	`} else {`	171	`} else {`
173	`if ($pourBDD) {`	172	`if ($pourBDD) {`
174	`$sortie[$nom] = 'NULL';`	173	`$sortie[$nom] = 'NULL';`
175	`} else {`	174	`} else {`
176	`$sortie[$nom] = '';`	175	`$sortie[$nom] = '';`
177	`}`	176	`}`
178	`}`	177	`}`
179	`}`	178	`}`
180	`return $sortie;`	179	`return $sortie;`
181	`}`	180	`}`
182		181
183	`protected function traiterBddClauseIn($chaine) {`	182	`protected function traiterBddClauseIn($chaine) {`
184	`$sortie = '';`	183	`$sortie = '';`
185	`$chaine = trim($chaine, " '");`	184	`$chaine = trim($chaine, " '");`
186	`if ($chaine != '') {`	185	`if ($chaine != '') {`
187	`$valeurs = explode(',', $chaine);`	186	`$valeurs = explode(',', $chaine);`
188	`foreach ($valeurs as $id => $valeur) {`	187	`foreach ($valeurs as $id => $valeur) {`
189	`$valeurs[$id] = $this->bdd->quote($valeur);`	188	`$valeurs[$id] = $this->bdd->quote($valeur);`
190	`}`	189	`}`
191	`$sortie = implode(',', $valeurs);`	190	`$sortie = implode(',', $valeurs);`
192	`}`	191	`}`
193	`return $sortie;`	192	`return $sortie;`
194	`}`	193	`}`
195	`}`	194	`}`
196	`?>`	195	`?>`

Subversion Repositories Applications.referentiel

(root)/trunk/services/modules/Ref.php @ 191 – Rev 51 → 141