Subversion Repositories Applications.framework

Rev

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

Rev 133 Rev 140
1
<?php
1
<?php
2
// declare(encoding='UTF-8');
2
// declare(encoding='UTF-8');
3
/**
3
/**
4
* Classe modèle, donc d'accés au données, elle ne devrait pas être appelée de l'extérieur.
4
* Classe modèle, donc d'accés au données, elle ne devrait pas être appelée de l'extérieur.
5
* Elle fait office d'abstraction légère de base de données en utilisant diveres possibilités
5
* Elle fait office d'abstraction légère de base de données en utilisant diveres possibilités
6
* d'abstraction de base de données (PDO, mysql, mysqli, sqlite)
6
* d'abstraction de base de données (PDO, mysql, mysqli, sqlite)
7
* Elle est abstraite donc doit obligatoirement être étendue.
7
* Elle est abstraite donc doit obligatoirement être étendue.
8
*
8
*
9
* PHP Version 5
9
* PHP Version 5
10
*
10
*
11
* @category  Class
11
* @category  Class
12
* @package   Framework
12
* @package   Framework
13
* @author	aurelien <aurelien@tela-botanica.org>
13
* @author	aurelien <aurelien@tela-botanica.org>
14
* @copyright 2009 Tela-Botanica
14
* @copyright 2009 Tela-Botanica
15
* @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
15
* @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
16
* @license   http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
16
* @license   http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
17
* @version   SVN: $$Id: Modele.php 133 2009-11-30 12:44:11Z aurelien $$
17
* @version   SVN: $$Id: Modele.php 140 2010-02-22 16:23:29Z jpm $$
18
* @link	  /doc/framework/
18
* @link	  /doc/framework/
19
*
19
*
20
*/
20
*/
21
abstract class Modele {
21
abstract class Modele {
22
 
22
 
23
	/**
23
	/**
24
	 * Mode de fetch associatif
24
	 * Mode de fetch associatif
25
	 */
25
	 */
26
	private $ASSOC = '';
26
	private $ASSOC = '';
27
	/**
27
	/**
28
	 * Mode de fetch objet
28
	 * Mode de fetch objet
29
	 */
29
	 */
30
	private $OBJECT = '';
30
	private $OBJECT = '';
31
 
31
 
32
	/**
32
	/**
33
	 * abstraction de base de données utilisée
33
	 * abstraction de base de données utilisée
34
	 */
34
	 */
35
	private $abstraction;
35
	private $abstraction;
36
	/**
36
	/**
37
	 * registre global
37
	 * registre global
38
	 */
38
	 */
39
	private $registre;
39
	private $registre;
40
	/**
40
	/**
41
	 * DSN pour accéder à la base de données
41
	 * DSN pour accéder à la base de données
42
	 */
42
	 */
43
	private $dsn;
43
	private $dsn;
44
	/**
44
	/**
45
	 * Type de base de données (mysql, mysqli, etc ...)
45
	 * Type de base de données (mysql, mysqli, etc ...)
46
	 */
46
	 */
47
	private $type;
47
	private $type;
48
	/**
48
	/**
49
	 * Hote herbergeant la base de données
49
	 * Hote herbergeant la base de données
50
	 */
50
	 */
51
	private $hote;
51
	private $hote;
52
	/**
52
	/**
53
	 * Nom de la base de données à laquelle le modèle doit se connecter
53
	 * Nom de la base de données à laquelle le modèle doit se connecter
54
	 */
54
	 */
55
	private $bdd_nom;
55
	private $bdd_nom;
56
	/**
56
	/**
57
	 * Nom d'utilisateur
57
	 * Nom d'utilisateur
58
	 */
58
	 */
59
	private $utilisateur;
59
	private $utilisateur;
60
	/**
60
	/**
61
	 * Mot de passe
61
	 * Mot de passe
62
	 */
62
	 */
63
	private $pass;
63
	private $pass;
64
 
64
 
65
	/**
65
	/**
66
	 * Encodage de la base de données
66
	 * Encodage de la base de données
67
	 */
67
	 */
68
	 private $encodage = null;
68
	 private $encodage = null;
69
	/**
69
	/**
70
	 * Connexion à la base de données
70
	 * Connexion à la base de données
71
	 */
71
	 */
72
	private $connexion = null;
72
	private $connexion = null;
73
 
73
 
74
	/**
74
	/**
75
	 * Constructeur par défaut, appelé à l'initialisation.
75
	 * Constructeur par défaut, appelé à l'initialisation.
76
	 */
76
	 */
77
	final public function __construct() {
77
	final public function __construct() {
78
		// les différents paramètres nécessaires sont lus à partir du registre
78
		// les différents paramètres nécessaires sont lus à partir du registre
79
		$this->registre = Registre::getInstance();
79
		$this->registre = Registre::getInstance();
80
		$this->abstraction = strtolower(Config::get('bdd_abstraction'));
80
		$this->abstraction = strtolower(Config::get('bdd_abstraction'));
81
		$this->type = Config::get('bdd_protocole');
81
		$this->type = Config::get('bdd_protocole');
82
		$this->hote = Config::get('bdd_serveur');
82
		$this->hote = Config::get('bdd_serveur');
83
		$this->bdd_nom = Config::get('bdd_nom');
83
		$this->bdd_nom = Config::get('bdd_nom');
84
		$this->utilisateur = Config::get('bdd_utilisateur');
84
		$this->utilisateur = Config::get('bdd_utilisateur');
85
		$this->pass = Config::get('bdd_mot_de_passe');
85
		$this->pass = Config::get('bdd_mot_de_passe');
86
		$this->encodage = Config::get('bdd_encodage');
86
		$this->encodage = Config::get('bdd_encodage');
87
 
87
 
88
		$this->dsn = $this->type.':dbname='.$this->bdd_nom.';host='.$this->hote;
88
		$this->dsn = $this->type.':dbname='.$this->bdd_nom.';host='.$this->hote;
89
		$this->initialiserProtocole();
89
		$this->initialiserProtocole();
90
	}
90
	}
91
 
91
 
92
	/**
92
	/**
93
	 * Connection à la base de données en utilisant les informations fournies par
93
	 * Connection à la base de données en utilisant les informations fournies par
94
	 * le fichier de configuration.
94
	 * le fichier de configuration.
95
	 * private et final car n'a pas vocation a être appelée par l'utilisateur.
95
	 * private et final car n'a pas vocation a être appelée par l'utilisateur.
96
	 *
96
	 *
97
	 * @throws Exception une exception dans le cas ou là connexion échoue
97
	 * @throws Exception une exception dans le cas ou là connexion échoue
98
	 */
98
	 */
99
	final private function connecter() {
99
	final private function connecter() {
100
 
-
 
101
		switch ($this->abstraction) {
100
		switch ($this->abstraction) {
102
			case 'pdo':
101
			case 'pdo':
103
				$this->connexion = new PDO($this->dsn, $this->utilisateur, $this->pass);
102
				$this->connexion = new PDO($this->dsn, $this->utilisateur, $this->pass);
104
			break;
103
			break;
105
 
104
 
106
			case 'mysql':
105
			case 'mysql':
107
				$this->connexion = mysql_connect($this->hote,$this->utilisateur,$this->pass);
106
				$this->connexion = mysql_connect($this->hote,$this->utilisateur,$this->pass);
108
				if($this->connexion != null) {
107
				if ($this->connexion != null) {
109
					mysql_select_db($this->bdd_nom, $this->connexion);
108
					mysql_select_db($this->bdd_nom, $this->connexion);
110
				} else {
109
				} else {
111
					throw new Exception('Erreur de connexion à la base de données, vérifiez les paramètres du fichier de configuration');
110
					throw new Exception('Erreur de connexion à la base de données, vérifiez les paramètres du fichier de configuration');
112
				}
111
				}
113
			break;
112
			break;
114
 
113
 
115
			case 'mysqli':
114
			case 'mysqli':
116
				$this->connexion = new mysqli($this->hote,$this->utilisateur,$this->pass, $this->bdd_nom);
115
				$this->connexion = new mysqli($this->hote,$this->utilisateur,$this->pass, $this->bdd_nom);
117
				if(!$this->connexion) {
116
				if (!$this->connexion) {
118
					throw new Exception('Erreur de connexion à la base de données, vérifiez les paramètres du fichier de configuration');
117
					throw new Exception('Erreur de connexion à la base de données, vérifiez les paramètres du fichier de configuration');
119
					return;
118
					return;
120
				}
119
				}
121
			break;
120
			break;
122
 
121
 
123
			case 'sqlite3':
122
			case 'sqlite3':
124
				// cas particulier de sqllite, on considère que le nom de la base de données correspond au fichier à ouvrir
123
				// cas particulier de sqllite, on considère que le nom de la base de données correspond au fichier à ouvrir
125
				$this->connexion = new SQLite3($this->bdd_nom);
124
				$this->connexion = new SQLite3($this->bdd_nom);
126
				if(!$this->connexion) {
125
				if (!$this->connexion) {
127
					throw new Exception('Erreur de connexion à la base de données, vérifiez les paramètres du fichier de configuration');
126
					throw new Exception('Erreur de connexion à la base de données, vérifiez les paramètres du fichier de configuration');
128
					return;
127
					return;
129
				}
128
				}
130
			break;
129
			break;
131
 
130
 
132
			default:
131
			default:
133
				$this->connexion = null;
132
				$this->connexion = null;
134
		}
133
		}
135
 
134
 
136
		if($this->encodage != null) {
135
		if ($this->encodage != null) {
137
			$this->requete("SET names '".$this->encodage."'");
136
			$this->requete("SET names '".$this->encodage."'");
138
		}
137
		}
139
	}
138
	}
140
 
139
 
141
	/**
140
	/**
142
	 * Fonction qui appelle la bonne fonction de requete suivant le type de bdd.
141
	 * Fonction qui appelle la bonne fonction pour executer une requête suivant le type de bdd.
143
	 *
142
	 *
144
	 * @param string la requete à effectuer
143
	 * @param string la requete à effectuer
145
	 * @return PDOStatement un objet contenant le résultat de la requête
144
	 * @return PDOStatement un objet contenant le résultat de la requête
146
	 */
145
	 */
147
	final protected function requete($requete) {
146
	final protected function requete($requete) {
148
		// on ne se connecte que lors du premier appel à une requete (lazy connexion)
147
		// on ne se connecte que lors du premier appel à une requete (lazy connexion)
149
		if ($this->connexion == null) {
148
		if ($this->connexion == null) {
150
			$this->connecter();
149
			$this->connecter();
151
		}
150
		}
152
 
151
 
153
		$retour = null;
152
		$retour = null;
154
 
153
 
155
		switch ($this->abstraction) {
154
		switch ($this->abstraction) {
156
			case 'pdo':
155
			case 'pdo':
157
				$retour = $this->connexion->query($requete);
156
				$retour = $this->connexion->query($requete);
158
			break;
157
				break;
159
 
-
 
160
			case 'mysql':
158
			case 'mysql':
161
				$retour = mysql_query($requete,$this->connexion);
159
				$retour = mysql_query($requete,$this->connexion);
162
			break;
160
				break;
163
 
-
 
164
			case 'mysqli':
161
			case 'mysqli':
165
				$retour = $this->connexion->query($requete);
162
				$retour = $this->connexion->query($requete);
166
			break;
163
				break;
167
 
-
 
168
			case 'sqlite3':
164
			case 'sqlite3':
169
				$retour = $this->connexion->exec($requete);
165
				$retour = $this->connexion->exec($requete);
170
			break;
166
				break;
171
		}
167
		}
172
 
168
 
173
		return $retour;
169
		return $retour;
174
	}
170
	}
175
 
171
 
176
	final protected function requeteUn($requete,$mode = 'ASSOC') {
172
	final protected function requeteUn($requete,$mode = 'ASSOC') {
177
 
-
 
178
		// on ne se connecte que lors du premier appel à une requete (lazy connexion)
173
		// Connection seulement lors du premier appel à une requete (lazy connexion)
179
		if ($this->connexion == null) {
174
		if ($this->connexion == null) {
180
			$this->connecter();
175
			$this->connecter();
181
		}
176
		}
182
 
177
 
183
		$retour = null;
178
		$retour = null;
184
 
-
 
185
		switch ($this->abstraction) {
179
		switch ($this->abstraction) {
186
			case 'pdo':
180
			case 'pdo':
187
				$res_req = $this->connexion->query($requete);
181
				$res_req = $this->connexion->query($requete);
188
				$retour =$res_req->fetch($this->$mode);
182
				$retour =$res_req->fetch($this->$mode);
189
			break;
183
				break;
190
 
-
 
191
			case 'mysql':
184
			case 'mysql':
192
				$res = mysql_query($requete,$this->connexion);
185
				$res = mysql_query($requete,$this->connexion);
193
				$fonction_fetch = $this->$mode;
186
				$fonction_fetch = $this->$mode;
194
				$retour = $fonction_fetch($res);
187
				$retour = $fonction_fetch($res);
195
			break;
188
				break;
196
 
-
 
197
			case 'mysqli':
189
			case 'mysqli':
198
				$res = $this->connexion->query($requete);
190
				$res = $this->connexion->query($requete);
199
				$fonction_fetch = $this->$mode;
191
				$fonction_fetch = $this->$mode;
200
				$retour = $res->$fonction_fetch();
192
				$retour = $res->$fonction_fetch();
201
			break;
193
				break;
202
 
-
 
203
			case 'sqlite3':
194
			case 'sqlite3':
204
				$retour = $this->connexion->querySingle($requete);
195
				$retour = $this->connexion->querySingle($requete);
205
			break;
196
				break;
206
		}
197
		}
207
 
198
 
208
		return $retour;
199
		return $retour;
209
	}
200
	}
210
 
201
 
211
 
202
 
212
	final protected function requeteTous($requete,$mode = 'ASSOC') {
203
	final protected function requeteTous($requete,$mode = 'ASSOC') {
213
 
-
 
214
		// on ne se connecte que lors du premier appel à une requete (lazy connexion)
204
		// Connexion seulement lors du premier appel à une requete (lazy connexion)
215
		if ($this->connexion == null) {
205
		if ($this->connexion == null) {
216
			$this->connecter();
206
			$this->connecter();
217
		}
207
		}
218
 
208
 
219
		$retour = null;
209
		$retour = null;
220
 
210
 
221
		switch ($this->abstraction) {
211
		switch ($this->abstraction) {
222
			case 'pdo':
212
			case 'pdo':
223
				$res_req = $this->connexion->query($requete);
213
				$res_req = $this->connexion->query($requete);
-
 
214
				if ($res_req !== false) {
224
				$retour =$res_req->fetchAll($this->$mode);
215
					$retour = $res_req->fetchAll($this->$mode);
-
 
216
				} else {
-
 
217
					$retour = false;
-
 
218
				}
225
			break;
219
				break;
226
 
-
 
227
			case 'mysql':
220
			case 'mysql':
228
				$res = mysql_query($requete,$this->connexion);
221
				$res = mysql_query($requete, $this->connexion);
229
				$fonction_fetch = $this->$mode;
222
				$fonction_fetch = $this->$mode;
230
				while($ligne = $fonction_fetch($res)) {
223
				while ($ligne = $fonction_fetch($res)) {
231
					$retour[] = $ligne;
224
					$retour[] = $ligne;
232
				}
225
				}
233
			break;
226
				break;
234
 
-
 
235
			case 'mysqli':
227
			case 'mysqli':
236
				$res = $this->connexion->query($requete);
228
				$res = $this->connexion->query($requete);
237
				$function_fetch = $this->$mode;
229
				$function_fetch = $this->$mode;
238
				while($ligne = $res->$function_fetch()) {
230
				while ($ligne = $res->$function_fetch()) {
239
					$retour[] = $ligne;
231
					$retour[] = $ligne;
240
				}
232
				}
241
			break;
233
				break;
242
 
-
 
243
			case 'sqlite3':
234
			case 'sqlite3':
244
				$res = $this->connexion->query($requete);
235
				$res = $this->connexion->query($requete);
245
				while($ligne = $res->fetch_array($this->ASSOC)) {
236
				while ($ligne = $res->fetch_array($this->ASSOC)) {
246
					if($mode == $this->ASSOC) {
237
					if ($mode == $this->ASSOC) {
247
						$retour[] = $ligne;
238
						$retour[] = $ligne;
248
					}
-
 
249
					elseif($mode == $this->OBJECT){
239
					} elseif ($mode == $this->OBJECT) {
250
						// cas particulier de sqllite
240
						// cas particulier de sqllite
251
						// qui n'a pas de fonction fetch_object
241
						// qui n'a pas de fonction fetch_object
252
						$ligneObjet = new stdClass();
242
						$ligneObjet = new stdClass();
253
						foreach($ligne as $colonne => $valeur) {
243
						foreach ($ligne as $colonne => $valeur) {
254
							$ligneObjet->$colonne = $valeur;
244
							$ligneObjet->$colonne = $valeur;
255
						}
245
						}
256
						$retour [] = $ligneObjet;
246
						$retour[] = $ligneObjet;
257
					}
247
					}
258
				}
248
				}
259
			break;
249
				break;
260
 
-
 
261
		}
250
		}
262
 
251
 
263
		return $retour;
252
		return $retour;
264
	}
253
	}
265
 
254
 
266
	/**
255
	/**
267
	 * protège une chaine de caractères avant l'insertion dans la base de données
256
	 * protège une chaine de caractères avant l'insertion dans la base de données
268
	 */
257
	 */
269
	final protected function proteger($chaine) {
258
	final protected function proteger($chaine) {
270
 
259
 
271
		// on ne se connecte que lors du premier appel à une requete
260
		// on ne se connecte que lors du premier appel à une requete
272
		if ($this->connexion == null) {
261
		if ($this->connexion == null) {
273
			$this->connecter();
262
			$this->connecter();
274
		}
263
		}
275
 
264
 
276
		$retour = $chaine;
265
		$retour = $chaine;
277
 
266
 
278
		switch ($this->abstraction) {
267
		switch ($this->abstraction) {
279
			case 'pdo':
268
			case 'pdo':
280
				$retour = $this->connexion->quote($chaine);
269
				$retour = $this->connexion->quote($chaine);
281
			break;
270
				break;
282
 
-
 
283
			case 'mysql':
271
			case 'mysql':
284
				$retour = '"'.mysql_real_escape_string($chaine, $this->connexion).'"';
272
				$retour = '"'.mysql_real_escape_string($chaine, $this->connexion).'"';
285
			break;
273
				break;
286
 
-
 
287
			case 'mysqli':
274
			case 'mysqli':
288
				$retour = '"'.$this->connexion->real_escape_string($chaine).'"';
275
				$retour = '"'.$this->connexion->real_escape_string($chaine).'"';
289
			break;
276
				break;
290
 
-
 
291
			case 'sqlite3':
277
			case 'sqlite3':
292
				$retour = $this->connexion->escapeString($chaine);
278
				$retour = $this->connexion->escapeString($chaine);
293
			break;
279
				break;
294
		}
280
		}
295
 
281
 
296
		return $retour;
282
		return $retour;
297
	}
283
	}
298
 
284
 
299
	/**
285
	/**
300
	 * initialise les constantes de classe à leur bonne valeur
286
	 * initialise les constantes de classe à leur bonne valeur
301
	 * et lance une exception si le protocole n'est pas bien défini
287
	 * et lance une exception si le protocole n'est pas bien défini
302
	 * @throws Exception
288
	 * @throws Exception
303
	 */
289
	 */
304
	final public function initialiserProtocole() {
290
	final public function initialiserProtocole() {
305
 
291
 
306
		switch ($this->abstraction) {
292
		switch ($this->abstraction) {
307
			case 'pdo':
293
			case 'pdo':
308
				$this->ASSOC = PDO::FETCH_ASSOC;
294
				$this->ASSOC = PDO::FETCH_ASSOC;
309
				$this->OBJECT = PDO::FETCH_CLASS;
295
				$this->OBJECT = PDO::FETCH_CLASS;
310
			break;
296
				break;
311
 
-
 
312
			case 'mysql':
297
			case 'mysql':
313
				$this->ASSOC = 'mysql_fetch_assoc';
298
				$this->ASSOC = 'mysql_fetch_assoc';
314
				$this->OBJECT = 'mysql_fetch_object';
299
				$this->OBJECT = 'mysql_fetch_object';
315
			break;
300
				break;
316
 
-
 
317
			case 'mysqli':
301
			case 'mysqli':
318
				$this->ASSOC = 'fetch_assoc';
302
				$this->ASSOC = 'fetch_assoc';
319
				$this->OBJECT = 'fetch_object';
303
				$this->OBJECT = 'fetch_object';
320
			break;
304
				break;
321
 
-
 
322
			case 'sqlite3':
305
			case 'sqlite3':
323
				$this->ASSOC = 'SQLITE3_ASSOC';
306
				$this->ASSOC = 'SQLITE3_ASSOC';
324
				$this->OBJECT = 'SQLITE3_OBJECT';
307
				$this->OBJECT = 'SQLITE3_OBJECT';
325
			break;
308
				break;
326
 
-
 
327
			default:
309
			default:
328
				throw new Exception('Erreur : l\'abstraction '.$this->abstraction.' n\'est pas prise en charge');
310
				throw new Exception('Erreur : l\'abstraction '.$this->abstraction.' n\'est pas prise en charge');
329
			break;
311
				break;
330
		}
312
		}
331
	}
313
	}
332
 
314
 
333
	/**
315
	/**
334
	 * Destructeur de classe, se contente de fermer explicitement la connexion
316
	 * Destructeur de classe, se contente de fermer explicitement la connexion
335
	 */
317
	 */
336
	final public function __destruct() {
318
	final public function __destruct() {
337
		switch ($this->abstraction) {
319
		switch ($this->abstraction) {
338
			case 'pdo':
320
			case 'pdo':
339
				$this->connexion = null;
321
				$this->connexion = null;
340
			break;
322
				break;
341
 
-
 
342
			case 'mysql':
323
			case 'mysql':
343
				return mysql_close($this->connexion);
324
				return mysql_close($this->connexion);
344
			break;
325
				break;
345
 
-
 
346
			case 'mysqli':
326
			case 'mysqli':
347
				$this->connexion->close();
327
				$this->connexion->close();
348
			break;
328
				break;
349
 
-
 
350
			case 'sqlite3':
329
			case 'sqlite3':
351
				$this->connexion->close();
330
				$this->connexion->close();
352
			break;
331
				break;
353
		}
332
		}
354
	}
333
	}
355
}
334
}
356
?>
335
?>