Subversion Repositories Applications.framework

Rev

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

Rev 354 Rev 355
1 
<?php
 1 
<?php
2 
// declare(encoding='UTF-8');
 2 
// declare(encoding='UTF-8');
3 
/**
 3 
/**
4 
 * Classe Bdd, d'accés au base de données.
 4 
 * Classe Bdd, d'accés au base de données.
5 
 * Elle fait office d'abstraction légère de base de données en utilisant diverses possibilités d'accès aux
5 
 * Elle fait office d'abstraction légère de base de données en utilisant diverses possibilités d'accès aux
6 
 * bases de données (PDO, mysql, mysqli, SQLite3).
 6 
 * bases de données (PDO, mysql, mysqli, SQLite3).
7 
 * Les valeurs pour le paramètre 'bdd_abstraction' du fichier config.ini sont : pdo, mysql, mysqli, sqlite3
 7 
 * Les valeurs pour le paramètre 'bdd_abstraction' du fichier config.ini sont : pdo, mysql, mysqli, sqlite3
8 
 * Vous pouvez aussi utiliser : "php:Bdd::ABSTRACTION_PDO","php:Bdd::ABSTRACTION_MYSQL", "php:Bdd::ABSTRACTION_MYSQLI",
 8 
 * Vous pouvez aussi utiliser : "php:Bdd::ABSTRACTION_PDO","php:Bdd::ABSTRACTION_MYSQL", "php:Bdd::ABSTRACTION_MYSQLI",
9 
 * "php:Bdd::ABSTRACTION_SQLITE3".
 9 
 * "php:Bdd::ABSTRACTION_SQLITE3".
10 
 * Elle peut être étendue, pour ajouter le support d'autres bases de données où prendre en compte des méthodes spécifique à
 10 
 * Elle peut être étendue, pour ajouter le support d'autres bases de données où prendre en compte des méthodes spécifique à
11 
 * un type d'abstraction.
 11 
 * un type d'abstraction.
12 
 *
 12 
 *
13 
 * @category	php 5.2
 13 
 * @category	php 5.2
14 
 * @package	Framework
 14 
 * @package	Framework
15 
 * @author		Aurélien PERONNET <aurelien@tela-botanica.org>
 15 
 * @author		Aurélien PERONNET <aurelien@tela-botanica.org>
16 
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
 16 
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
17 
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
 17 
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
18 
 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
 18 
 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
19 
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
 19 
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
20 
 * @version	$Id: Bdd.php 354 2011-08-08 13:28:14Z jpm $
 20 
 * @version	$Id: Bdd.php 355 2011-08-08 13:31:31Z jpm $
21 
 * @link		/doc/framework/
 21 
 * @link		/doc/framework/
22 
 */
 22 
 */
23 
class Bdd {
 23 
class Bdd {
24 
	/** Constante stockant le squelette du message en cas d'erreur de requête sql. */
 24 
	/** Constante stockant le squelette du message en cas d'erreur de requête sql. */
25 
	const ERREUR_REQUETE_TPL = 'Requête echec.\nFichier : %s.\nLigne : %s.\nMessage : %s.\nRequête : %s';
 25 
	const ERREUR_REQUETE_TPL = 'Requête echec.\nFichier : %s.\nLigne : %s.\nMessage : %s.\nRequête : %s';
26
26
27 
	/** Constante stockant le squelette du message en cas d'erreur de connexion à la base de données. */
 27 
	/** Constante stockant le squelette du message en cas d'erreur de connexion à la base de données. */
28 
	const ERREUR_CONNEXION_TPL = 'Erreur de connexion à la base de données, vérifiez les paramètres du fichier de configuration.\nMessage : %S.';
 28 
	const ERREUR_CONNEXION_TPL = 'Erreur de connexion à la base de données, vérifiez les paramètres du fichier de configuration.\nMessage : %S.';
29
29
30 
	/** Constante stockant le squelette du message en cas d'erreur de sélection de la base de données. */
 30 
	/** Constante stockant le squelette du message en cas d'erreur de sélection de la base de données. */
31 
	const ERREUR_SELECTION_BDD_TPL = 'Erreur de sélection de la base de données, vérifiez les paramètres du fichier de configuration.\nMessage : %S.';
 31 
	const ERREUR_SELECTION_BDD_TPL = 'Erreur de sélection de la base de données, vérifiez les paramètres du fichier de configuration.\nMessage : %S.';
32
32
33 
	/** Constante stockant le code pour l'abstraction de PDO. */
 33 
	/** Constante stockant le code pour l'abstraction de PDO. */
34 
	const ABSTRACTION_PDO = 'pdo';
 34 
	const ABSTRACTION_PDO = 'pdo';
35
35
36 
	/** Constante stockant le code pour l'abstraction de mysql. */
 36 
	/** Constante stockant le code pour l'abstraction de mysql. */
37 
	const ABSTRACTION_MYSQL = 'mysql';
 37 
	const ABSTRACTION_MYSQL = 'mysql';
38
38
39 
	/** Constante stockant le code pour l'abstraction de mysqli. */
 39 
	/** Constante stockant le code pour l'abstraction de mysqli. */
40 
	const ABSTRACTION_MYSQLI = 'mysqli';
 40 
	const ABSTRACTION_MYSQLI = 'mysqli';
41
41
42 
	/** Constante stockant le code pour l'abstraction de SQLite3. */
 42 
	/** Constante stockant le code pour l'abstraction de SQLite3. */
43 
	const ABSTRACTION_SQLITE3 = 'sqlite3';
 43 
	const ABSTRACTION_SQLITE3 = 'sqlite3';
44
44
45 
	/** Constante stockant le code pour le mode tableau associatif des résultats des requêtes. */
 45 
	/** Constante stockant le code pour le mode tableau associatif des résultats des requêtes. */
46 
	const MODE_ASSOC = 'ASSOC';
 46 
	const MODE_ASSOC = 'ASSOC';
47
47
48 
	/** Constante stockant le code pour le mode objet des résultats des requêtes. */
 48 
	/** Constante stockant le code pour le mode objet des résultats des requêtes. */
49 
	const MODE_OBJET = 'OBJECT';
 49 
	const MODE_OBJET = 'OBJECT';
50
50
51 
	/** Mode de fetch associatif */
 51 
	/** Mode de fetch associatif */
52 
	protected $ASSOC = '';
 52 
	protected $ASSOC = '';
53
53
54 
	/** Mode de fetch objet */
 54 
	/** Mode de fetch objet */
55 
	protected $OBJECT = '';
 55 
	protected $OBJECT = '';
56 
 
 56 
 
57 
	/** abstraction de base de données utilisée */
 57 
	/** abstraction de base de données utilisée */
58 
	protected $abstraction;
 58 
	protected $abstraction;
59
59
60 
	/** DSN pour accéder à la base de données */
 60 
	/** DSN pour accéder à la base de données */
61 
	protected $dsn;
 61 
	protected $dsn;
62
62
63 
	/** Type de base de données (mysql, mysqli, etc ...) */
 63 
	/** Type de base de données (mysql, mysqli, etc ...) */
64 
	protected $type;
 64 
	protected $type;
65
65
66 
	/** Hote herbergeant la base de données */
 66 
	/** Hote herbergeant la base de données */
67 
	protected $hote;
 67 
	protected $hote;
68
68
69 
	/** Nom de la base de données à laquelle le modèle doit se connecter */
 69 
	/** Nom de la base de données à laquelle le modèle doit se connecter */
70 
	protected $bdd_nom;
 70 
	protected $bdd_nom;
71
71
72 
	/** Nom d'utilisateur */
 72 
	/** Nom d'utilisateur */
73 
	protected $utilisateur;
 73 
	protected $utilisateur;
74
74
75 
	/** Mot de passe */
 75 
	/** Mot de passe */
76 
	protected $pass;
 76 
	protected $pass;
77 
 
 77 
 
78 
	/** Encodage de la base de données */
 78 
	/** Encodage de la base de données */
79 
	protected $encodage = null;
 79 
	protected $encodage = null;
80
80
81 
	/** Connexion à la base de données */
 81 
	/** Connexion à la base de données */
82 
	protected $connexion = null;
 82 
	protected $connexion = null;
83 
 
 83 
 
84 
	/** Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.*/
 84 
	/** Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.*/
85 
	protected $parametres_obligatoires = array('bdd_abstraction', 'bdd_protocole', 'bdd_serveur', 'bdd_nom',
85 
	protected $parametres_obligatoires = array('bdd_abstraction', 'bdd_protocole', 'bdd_serveur', 'bdd_nom',
86 
		'bdd_utilisateur', 'bdd_mot_de_passe', 'bdd_encodage');
 86 
		'bdd_utilisateur', 'bdd_mot_de_passe', 'bdd_encodage');
87
87
88 
	/** Constructeur par défaut, appelé à l'initialisation. */
 88 
	/** Constructeur par défaut, appelé à l'initialisation. */
89 
	public function __construct() {
 89 
	public function __construct() {
90 
		Config::verifierPresenceParametres($this->parametres_obligatoires);
 90 
		Config::verifierPresenceParametres($this->parametres_obligatoires);
91 
		$this->abstraction = strtolower(Config::get('bdd_abstraction'));
 91 
		$this->abstraction = strtolower(Config::get('bdd_abstraction'));
92 
		$this->type = Config::get('bdd_protocole');
 92 
		$this->type = Config::get('bdd_protocole');
93 
		$this->hote = Config::get('bdd_serveur');
 93 
		$this->hote = Config::get('bdd_serveur');
94 
		$this->bdd_nom = Config::get('bdd_nom');
 94 
		$this->bdd_nom = Config::get('bdd_nom');
95 
		$this->utilisateur = Config::get('bdd_utilisateur');
 95 
		$this->utilisateur = Config::get('bdd_utilisateur');
96 
		$this->pass = Config::get('bdd_mot_de_passe');
 96 
		$this->pass = Config::get('bdd_mot_de_passe');
97 
		$this->encodage = Config::get('bdd_encodage');
 97 
		$this->encodage = Config::get('bdd_encodage');
98 
 
 98 
 
99 
		$this->dsn = $this->type.':dbname='.$this->bdd_nom.';host='.$this->hote;
 99 
		$this->dsn = $this->type.':dbname='.$this->bdd_nom.';host='.$this->hote;
100 
		$this->initialiserProtocole();
 100 
		$this->initialiserProtocole();
101 
	}
 101 
	}
102 
 
 102 
 
103 
	/** Initialise les constantes de classe à leur bonne valeur et déclenche une erreur si le protocole n'est pas bien défini. */
 103 
	/** Initialise les constantes de classe à leur bonne valeur et déclenche une erreur si le protocole n'est pas bien défini. */
104 
	protected function initialiserProtocole() {
 104 
	protected function initialiserProtocole() {
105 
		switch ($this->abstraction) {
 105 
		switch ($this->abstraction) {
106 
			case self::ABSTRACTION_PDO :
 106 
			case self::ABSTRACTION_PDO :
107 
				$this->ASSOC = PDO::FETCH_ASSOC;
 107 
				$this->ASSOC = PDO::FETCH_ASSOC;
108 
				$this->OBJECT = PDO::FETCH_CLASS;
 108 
				$this->OBJECT = PDO::FETCH_CLASS;
109 
				break;
 109 
				break;
110 
			case self::ABSTRACTION_MYSQL :
 110 
			case self::ABSTRACTION_MYSQL :
111 
				$this->ASSOC = 'mysql_fetch_assoc';
 111 
				$this->ASSOC = 'mysql_fetch_assoc';
112 
				$this->OBJECT = 'mysql_fetch_object';
 112 
				$this->OBJECT = 'mysql_fetch_object';
113 
				break;
 113 
				break;
114 
			case self::ABSTRACTION_MYSQLI :
 114 
			case self::ABSTRACTION_MYSQLI :
115 
				$this->ASSOC = 'fetch_assoc';
 115 
				$this->ASSOC = 'fetch_assoc';
116 
				$this->OBJECT = 'fetch_object';
 116 
				$this->OBJECT = 'fetch_object';
117 
				break;
 117 
				break;
118 
			case self::ABSTRACTION_SQLITE3 :
 118 
			case self::ABSTRACTION_SQLITE3 :
119 
				$this->ASSOC = 'SQLITE3_ASSOC';
 119 
				$this->ASSOC = 'SQLITE3_ASSOC';
120 
				$this->OBJECT = 'SQLITE3_OBJECT';
 120 
				$this->OBJECT = 'SQLITE3_OBJECT';
121 
				break;
 121 
				break;
122 
			default:
 122 
			default:
123 
				$m = "Erreur : l'abstraction '{$this->abstraction}' n'est pas prise en charge";
 123 
				$m = "Erreur : l'abstraction '{$this->abstraction}' n'est pas prise en charge";
124 
				trigger_error($m, E_USER_WARNING);
 124 
				trigger_error($m, E_USER_WARNING);
125 
		}
 125 
		}
126 
	}
 126 
	}
127
127
128 
	/**
 128 
	/**
129 
	 * Connection à la base de données en utilisant les informations fournies par
 129 
	 * Connection à la base de données en utilisant les informations fournies par
130 
	 * le fichier de configuration.
 130 
	 * le fichier de configuration.
131 
	 * Cette méthode est private et final car elle n'a pas vocation a être appelée par l'utilisateur.
 131 
	 * Cette méthode est private et final car elle n'a pas vocation a être appelée par l'utilisateur.
132 
	 */
 132 
	 */
133 
	protected function connecter() {
 133 
	protected function connecter() {
134 
		if ($this->connexion == null) {
 134 
		if ($this->connexion == null) {
135 
			switch ($this->abstraction) {
 135 
			switch ($this->abstraction) {
136 
				case self::ABSTRACTION_PDO :
 136 
				case self::ABSTRACTION_PDO :
137 
					try {
 137 
					try {
138 
						$this->connexion = new PDO($this->dsn, $this->utilisateur, $this->pass);
 138 
						$this->connexion = new PDO($this->dsn, $this->utilisateur, $this->pass);
139 
						$this->connexion->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
 139 
						$this->connexion->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
140 
					} catch (PDOException $e) {
 140 
					} catch (PDOException $e) {
141 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, $e->getMessage());
 141 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, $e->getMessage());
142 
						trigger_error($e, E_USER_WARNING);
 142 
						trigger_error($e, E_USER_WARNING);
143 
					}
 143 
					}
144 
					break;
 144 
					break;
145 
				case self::ABSTRACTION_MYSQL :
 145 
				case self::ABSTRACTION_MYSQL :
146 
					$this->connexion = mysql_connect($this->hote, $this->utilisateur, $this->pass);
 146 
					$this->connexion = mysql_connect($this->hote, $this->utilisateur, $this->pass);
147 
					if ($this->connexion !== false) {
 147 
					if ($this->connexion !== false) {
148 
						$selection = mysql_select_db($this->bdd_nom, $this->connexion);
 148 
						$selection = mysql_select_db($this->bdd_nom, $this->connexion);
149 
						if ($selection === false) {
 149 
						if ($selection === false) {
150 
							$e = sprintf(self::ERREUR_SELECTION_BDD_TPL, mysql_error());
 150 
							$e = sprintf(self::ERREUR_SELECTION_BDD_TPL, mysql_error());
151 
							trigger_error($e, E_USER_WARNING);
 151 
							trigger_error($e, E_USER_WARNING);
152 
						}
 152 
						}
153 
					} else {
 153 
					} else {
154 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, mysql_error());
 154 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, mysql_error());
155 
						trigger_error($e, E_USER_WARNING);
 155 
						trigger_error($e, E_USER_WARNING);
156 
					}
 156 
					}
157 
					break;
 157 
					break;
158 
				case self::ABSTRACTION_MYSQLI :
 158 
				case self::ABSTRACTION_MYSQLI :
159 
					$this->connexion = @new mysqli($this->hote, $this->utilisateur, $this->pass, $this->bdd_nom);
 159 
					$this->connexion = @new mysqli($this->hote, $this->utilisateur, $this->pass, $this->bdd_nom);
160 
					if ($this->connexion->connect_errno) {
 160 
					if ($this->connexion->connect_errno) {
161 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, $this->connexion->connect_error);
 161 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, $this->connexion->connect_error);
162 
						trigger_error($e, E_USER_WARNING);
 162 
						trigger_error($e, E_USER_WARNING);
163 
					}
 163 
					}
164 
					break;
 164 
					break;
165 
				case self::ABSTRACTION_SQLITE3 :
 165 
				case self::ABSTRACTION_SQLITE3 :
166 
					// cas particulier de sqllite, on considère que le nom de la base de données correspond au fichier à ouvrir
 166 
					// cas particulier de sqllite, on considère que le nom de la base de données correspond au fichier à ouvrir
167 
					$this->connexion = new SQLite3($this->bdd_nom);
 167 
					$this->connexion = new SQLite3($this->bdd_nom);
168 
					if (!$this->connexion) {
 168 
					if (!$this->connexion) {
169 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, '');
 169 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, '');
170 
						trigger_error($e, E_USER_WARNING);
 170 
						trigger_error($e, E_USER_WARNING);
171 
					}
 171 
					}
172 
					break;
 172 
					break;
173 
				default:
 173 
				default:
174 
					$this->connexion = null;
 174 
					$this->connexion = null;
175 
			}
 175 
			}
176
176
177 
			if ($this->encodage != null) {
 177 
			if ($this->encodage != null) {
178 
				$this->requete("SET names '".$this->encodage."'");
 178 
				$this->requete("SET names '".$this->encodage."'");
179 
			}
 179 
			}
180 
		}
 180 
		}
181 
	}
 181 
	}
182
182
183 
	/**
 183 
	/**
184 
	 * @deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see requeter
 184 
	 * @deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see requeter
185 
	 */
 185 
	 */
186 
	final protected function requete($requete) {
 186 
	final protected function requete($requete) {
187 
		return $this->requeter($requete);
 187 
		return $this->requeter($requete);
188 
	}
 188 
	}
189
189
190 
	/**
 190 
	/**
191 
	 * Execute une requête et retourne le résultat tel que renvoyé par l'abstraction courante.
 191 
	 * Execute une requête et retourne le résultat tel que renvoyé par l'abstraction courante.
192 
	 *
 192 
	 *
193 
	 * @param string la requête à effectuer
 193 
	 * @param string la requête à effectuer
194 
	 * @return mixed un objet contenant le résultat de la requête
 194 
	 * @return mixed un objet contenant le résultat de la requête
195 
	 */
 195 
	 */
196 
	public function requeter($requete) {
 196 
	public function requeter($requete) {
197 
		$this->connecter();
 197 
		$this->connecter();
198 
 
 198 
 
199 
		$retour = null;
 199 
		$retour = null;
200 
		switch ($this->abstraction) {
 200 
		switch ($this->abstraction) {
201 
			case self::ABSTRACTION_PDO :
 201 
			case self::ABSTRACTION_PDO :
202 
				try {
 202 
				try {
203 
					$retour = $this->connexion->query($requete);
 203 
					$retour = $this->connexion->query($requete);
204 
				} catch (PDOException $e) {
 204 
				} catch (PDOException $e) {
205 
					$m = sprintf(self::ERREUR_REQUETE_TPL, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
 205 
					$m = sprintf(self::ERREUR_REQUETE_TPL, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
206 
					trigger_error($m, E_USER_WARNING);
 206 
					trigger_error($m, E_USER_WARNING);
207 
				}
 207 
				}
208 
				break;
 208 
				break;
209 
			case self::ABSTRACTION_MYSQL :
 209 
			case self::ABSTRACTION_MYSQL :
210 
				$retour = mysql_query($requete, $this->connexion);
 210 
				$retour = mysql_query($requete, $this->connexion);
211 
				break;
 211 
				break;
212 
			case self::ABSTRACTION_MYSQLI :
 212 
			case self::ABSTRACTION_MYSQLI :
213 
				$retour = $this->connexion->query($requete);
 213 
				$retour = $this->connexion->query($requete);
214 
				break;
 214 
				break;
215 
			case self::ABSTRACTION_SQLITE3 :
 215 
			case self::ABSTRACTION_SQLITE3 :
216 
				$retour = $this->connexion->exec($requete);
 216 
				$retour = $this->connexion->exec($requete);
217 
				break;
 217 
				break;
218 
		}
 218 
		}
219 
		return $retour;
 219 
		return $retour;
220 
	}
 220 
	}
221
221
222 
	/**
 222 
	/**
223 
	 * @deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see recuperer
 223 
	 * @deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see recuperer
224 
	 */
 224 
	 */
225 
	final protected function requeteUn($requete, $mode = self::MODE_ASSOC) {
 225 
	final protected function requeteUn($requete, $mode = self::MODE_ASSOC) {
226 
		return $this->recuperer($requete, $mode);
 226 
		return $this->recuperer($requete, $mode);
227 
	}
 227 
	}
228
228
229 
	/**
 229 
	/**
230 
	 * Execute une requête et retourne le premier résultat sous forme de tableau (par défaut) ou d'objet.
 230 
	 * Execute une requête et retourne le premier résultat sous forme de tableau (par défaut) ou d'objet.
231 
	 * Les noms des champs de la base de données correspondent aux noms des clés du tableau ou aux noms des attributs de l'objet.
 231 
	 * Les noms des champs de la base de données correspondent aux noms des clés du tableau ou aux noms des attributs de l'objet.
232 
	 *
 232 
	 *
233 
	 * @param string la requête à effectuer
 233 
	 * @param string la requête à effectuer
234 
	 * @param string le mode de retour ASSOC (Bdd::MODE_ASSOC) pour un tableau ou OBJECT (Bdd::MODE_OBJET) pour un objet.
 234 
	 * @param string le mode de retour ASSOC (Bdd::MODE_ASSOC) pour un tableau ou OBJECT (Bdd::MODE_OBJET) pour un objet.
235 
	 * @return mixed un objet ou un tableau contenant le résultat de la requête
 235 
	 * @return mixed un objet ou un tableau contenant le résultat de la requête
236 
	 */
 236 
	 */
237 
	public function recuperer($requete, $mode = self::MODE_ASSOC) {
 237 
	public function recuperer($requete, $mode = self::MODE_ASSOC) {
238 
		$this->connecter();
 238 
		$this->connecter();
239 
 
 239 
 
240 
		$retour = null;
 240 
		$retour = null;
241 
		switch ($this->abstraction) {
 241 
		switch ($this->abstraction) {
242 
			case self::ABSTRACTION_PDO :
 242 
			case self::ABSTRACTION_PDO :
243 
				try {
 243 
				try {
244 
					$resultat = $this->connexion->query($requete);
 244 
					$resultat = $this->connexion->query($requete);
245 
					$retour = $resultat->fetch($this->$mode);
 245 
					$retour = ($resultat !== false) ? $resultat->fetch($this->$mode) : $resultat;
246 
				} catch (PDOException $e) {
 246 
				} catch (PDOException $e) {
247 
					$m = sprintf(self::ERREUR_REQUETE_TPL, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
 247 
					$m = sprintf(self::ERREUR_REQUETE_TPL, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
248 
					trigger_error($m, E_USER_WARNING);
 248 
					trigger_error($m, E_USER_WARNING);
249 
				}
 249 
				}
250 
				break;
 250 
				break;
251 
			case self::ABSTRACTION_MYSQL :
 251 
			case self::ABSTRACTION_MYSQL :
252 
				$res = mysql_query($requete, $this->connexion);
 252 
				$res = mysql_query($requete, $this->connexion);
253 
				$fonction_fetch = $this->$mode;
 253 
				$fonction_fetch = $this->$mode;
254 
				$retour = $fonction_fetch($res);
 254 
				$retour = $fonction_fetch($res);
255 
				break;
 255 
				break;
256 
			case self::ABSTRACTION_MYSQLI :
 256 
			case self::ABSTRACTION_MYSQLI :
257 
				$res = $this->connexion->query($requete);
 257 
				$res = $this->connexion->query($requete);
258 
				$fonction_fetch = $this->$mode;
 258 
				$fonction_fetch = $this->$mode;
259 
				$retour = $res->$fonction_fetch();
 259 
				$retour = $res->$fonction_fetch();
260 
				break;
 260 
				break;
261 
			case self::ABSTRACTION_SQLITE3 :
 261 
			case self::ABSTRACTION_SQLITE3 :
262 
				$retour = $this->connexion->querySingle($requete);
 262 
				$retour = $this->connexion->querySingle($requete);
263 
				break;
 263 
				break;
264 
		}
 264 
		}
265 
		return $retour;
 265 
		return $retour;
266 
	}
 266 
	}
267
267
268 
	/**
 268 
	/**
269 
	 * @deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see recupererTous
 269 
	 * @deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see recupererTous
270 
	 */
 270 
	 */
271 
	final protected function requeteTous($requete, $mode = self::MODE_ASSOC) {
 271 
	final protected function requeteTous($requete, $mode = self::MODE_ASSOC) {
272 
		return $this->recupererTous($requete, $mode);
 272 
		return $this->recupererTous($requete, $mode);
273 
	}
 273 
	}
274
274
275 
	/**
 275 
	/**
276 
	 * Execute une requête et retourne un tableau de résultats. Un résultat peut être présentés sous forme
276 
	 * Execute une requête et retourne un tableau de résultats. Un résultat peut être présentés sous forme
277 
	 * de tableau (par défaut) ou d'objet.
 277 
	 * de tableau (par défaut) ou d'objet.
278 
	 * Les noms des champs de la base de données correspondent aux noms des clés du tableau résultat ou
278 
	 * Les noms des champs de la base de données correspondent aux noms des clés du tableau résultat ou
279 
	 * aux noms des attributs de l'objet résultat.
 279 
	 * aux noms des attributs de l'objet résultat.
280 
	 *
 280 
	 *
281 
	 * @param string la requête à effectuer
 281 
	 * @param string la requête à effectuer
282 
	 * @param string le mode de retour des résultats : ASSOC (Bdd::MODE_ASSOC) pour un tableau ou OBJECT (Bdd::MODE_OBJET) pour un objet.
 282 
	 * @param string le mode de retour des résultats : ASSOC (Bdd::MODE_ASSOC) pour un tableau ou OBJECT (Bdd::MODE_OBJET) pour un objet.
283 
	 * @return array un tableau contenant les résultats sous forme d'objets ou de tableau (par défaut).
 283 
	 * @return array un tableau contenant les résultats sous forme d'objets ou de tableau (par défaut).
284 
	 */
 284 
	 */
285 
	public function recupererTous($requete, $mode = self::MODE_ASSOC) {
 285 
	public function recupererTous($requete, $mode = self::MODE_ASSOC) {
286 
		$this->connecter();
 286 
		$this->connecter();
287
287
288 
		$retour = null;
 288 
		$retour = null;
289 
		switch ($this->abstraction) {
 289 
		switch ($this->abstraction) {
290 
			case self::ABSTRACTION_PDO :
 290 
			case self::ABSTRACTION_PDO :
291 
				try {
 291 
				try {
292 
					$resultat = $this->connexion->query($requete);
 292 
					$resultat = $this->connexion->query($requete);
293 
					if ($resultat !== false) {
 - 
 
294 
						$retour = $resultat->fetchAll($this->$mode);
 293 
					$retour = ($resultat !== false) ? $resultat->fetchAll($this->$mode) : $resultat;
295 
					} else {
 - 
 
296 
						$retour = false;
 - 
 
297 
					}
 - 
 
298 
				} catch (PDOException $e) {
 294 
				} catch (PDOException $e) {
299 
					$m = sprintf(self::ERREUR_REQUETE_TPL, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
 295 
					$m = sprintf(self::ERREUR_REQUETE_TPL, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
300 
					trigger_error($m, E_USER_WARNING);
 296 
					trigger_error($m, E_USER_WARNING);
301 
				}
 297 
				}
302 
				break;
 298 
				break;
303 
			case self::ABSTRACTION_MYSQL :
 299 
			case self::ABSTRACTION_MYSQL :
304 
				$resultat = mysql_query($requete, $this->connexion);
 300 
				$resultat = mysql_query($requete, $this->connexion);
305 
				$fonction_fetch = $this->$mode;
 301 
				$fonction_fetch = $this->$mode;
306 
				while ($ligne = $fonction_fetch($resultat)) {
 302 
				while ($ligne = $fonction_fetch($resultat)) {
307 
					$retour[] = $ligne;
 303 
					$retour[] = $ligne;
308 
				}
 304 
				}
309 
				break;
 305 
				break;
310 
			case self::ABSTRACTION_MYSQLI :
 306 
			case self::ABSTRACTION_MYSQLI :
311 
				$resultat = $this->connexion->query($requete);
 307 
				$resultat = $this->connexion->query($requete);
312 
				$function_fetch = $this->$mode;
 308 
				$function_fetch = $this->$mode;
313 
				while ($ligne = $resultat->$function_fetch()) {
 309 
				while ($ligne = $resultat->$function_fetch()) {
314 
					$retour[] = $ligne;
 310 
					$retour[] = $ligne;
315 
				}
 311 
				}
316 
				break;
 312 
				break;
317 
			case self::ABSTRACTION_SQLITE3 :
 313 
			case self::ABSTRACTION_SQLITE3 :
318 
				$resultat = $this->connexion->query($requete);
 314 
				$resultat = $this->connexion->query($requete);
319 
				while ($ligne = $resultat->fetch_array($this->ASSOC)) {
 315 
				while ($ligne = $resultat->fetch_array($this->ASSOC)) {
320 
					if ($mode == self::MODE_OBJET) {
 316 
					if ($mode == self::MODE_OBJET) {
321 
						// Cas particulier de sqllite qui n'a pas de fonction fetch_object
 317 
						// Cas particulier de sqllite qui n'a pas de fonction fetch_object
322 
						$ligneObjet = new stdClass();
 318 
						$ligneObjet = new stdClass();
323 
						foreach ($ligne as $colonne => $valeur) {
 319 
						foreach ($ligne as $colonne => $valeur) {
324 
							$ligneObjet->$colonne = $valeur;
 320 
							$ligneObjet->$colonne = $valeur;
325 
						}
 321 
						}
326 
						$ligne = $ligneObjet;
 322 
						$ligne = $ligneObjet;
327 
					}
 323 
					}
328 
					$retour[] = $ligne;
 324 
					$retour[] = $ligne;
329 
				}
 325 
				}
330 
				break;
 326 
				break;
331 
		}
 327 
		}
332 
		return $retour;
 328 
		return $retour;
333 
	}
 329 
	}
334 
 
 330 
 
335 
	/**
 331 
	/**
336 
	 * Protège une chaine de caractères avant l'insertion dans la base de données (ajout de quotes ou guillemets).
 332 
	 * Protège une chaine de caractères avant l'insertion dans la base de données (ajout de quotes ou guillemets).
337 
	 * @param string la chaine à protéger
 333 
	 * @param string la chaine à protéger
338 
	 * @return string la chaine protégée
 334 
	 * @return string la chaine protégée
339 
	 */
 335 
	 */
340 
	public function proteger($chaine) {
 336 
	public function proteger($chaine) {
341 
		$this->connecter();
 337 
		$this->connecter();
342 
 
 338 
 
343 
		$retour = $chaine;
 339 
		$retour = $chaine;
344 
		switch ($this->abstraction) {
 340 
		switch ($this->abstraction) {
345 
			case self::ABSTRACTION_PDO :
 341 
			case self::ABSTRACTION_PDO :
346 
				$retour = $this->connexion->quote($chaine);
 342 
				$retour = $this->connexion->quote($chaine);
347 
				break;
 343 
				break;
348 
			case self::ABSTRACTION_MYSQL :
 344 
			case self::ABSTRACTION_MYSQL :
349 
				$retour = '"'.mysql_real_escape_string($chaine, $this->connexion).'"';
 345 
				$retour = '"'.mysql_real_escape_string($chaine, $this->connexion).'"';
350 
				break;
 346 
				break;
351 
			case self::ABSTRACTION_MYSQLI :
 347 
			case self::ABSTRACTION_MYSQLI :
352 
				$retour = '"'.$this->connexion->real_escape_string($chaine).'"';
 348 
				$retour = '"'.$this->connexion->real_escape_string($chaine).'"';
353 
				break;
 349 
				break;
354 
			case self::ABSTRACTION_SQLITE3 :
 350 
			case self::ABSTRACTION_SQLITE3 :
355 
				$retour = $this->connexion->escapeString($chaine);
 351 
				$retour = $this->connexion->escapeString($chaine);
356 
				break;
 352 
				break;
357 
		}
 353 
		}
358 
		return $retour;
 354 
		return $retour;
359 
	}
 355 
	}
360 
 
 356 
 
361 
	/**
 357 
	/**
362 
	 * Retourne l'identifiant de la dernière ligne insérée, ou la dernière valeur d'une séquence d'objets, dépendamment, dans
 358 
	 * Retourne l'identifiant de la dernière ligne insérée, ou la dernière valeur d'une séquence d'objets, dépendamment, dans
363 
	 * le cas de PDO, du driver utilisé. Les méthodes utilisées pour retourner l'identifiant peuvent avoir des comportements
 359 
	 * le cas de PDO, du driver utilisé. Les méthodes utilisées pour retourner l'identifiant peuvent avoir des comportements
364 
	 * différent. Consulter la documentation PHP correspondant à l'abstraction choisie avant de l'utiliser :
 360 
	 * différent. Consulter la documentation PHP correspondant à l'abstraction choisie avant de l'utiliser :
365 
	 * @link(http://fr.php.net/manual/fr/pdo.lastinsertid.php, PDO::lastInsertId([ string $name = NULL ]))
 361 
	 * @link(http://fr.php.net/manual/fr/pdo.lastinsertid.php, PDO::lastInsertId([ string $name = NULL ]))
366 
	 * @link(http://php.net/manual/en/mysqli.insert-id.php, mysqli->insert_id())
362 
	 * @link(http://php.net/manual/en/mysqli.insert-id.php, mysqli->insert_id())
367 
	 * @link(http://fr.php.net/manual/fr/function.mysql-insert-id.php, mysql_insert_id())
 363 
	 * @link(http://fr.php.net/manual/fr/function.mysql-insert-id.php, mysql_insert_id())
368 
	 * @link(http://fr.php.net/manual/fr/sqlite3.lastinsertrowid.php, SQLite3::lastInsertRowID())
364 
	 * @link(http://fr.php.net/manual/fr/sqlite3.lastinsertrowid.php, SQLite3::lastInsertRowID())
369 
	 * @param mixed un paramètre éventuel à transmettre (en fonction de l'abstraction de BDD utilisée).
 365 
	 * @param mixed un paramètre éventuel à transmettre (en fonction de l'abstraction de BDD utilisée).
370 
	 * @return mixed le dernier identifiant de clé primaire ajouté dans la base de données (string ou int).
 366 
	 * @return mixed le dernier identifiant de clé primaire ajouté dans la base de données (string ou int).
371 
	 */
 367 
	 */
372 
	public function recupererIdDernierAjout($parametres = null) {
 368 
	public function recupererIdDernierAjout($parametres = null) {
373 
		$this->connecter();
 369 
		$this->connecter();
374 
 
 370 
 
375 
		$retour = $chaine;
 371 
		$retour = $chaine;
376 
		switch ($this->abstraction) {
 372 
		switch ($this->abstraction) {
377 
			case self::ABSTRACTION_PDO :
 373 
			case self::ABSTRACTION_PDO :
378 
				$retour = $this->connexion->lastInsertId($parametres);
 374 
				$retour = $this->connexion->lastInsertId($parametres);
379 
				break;
 375 
				break;
380 
			case self::ABSTRACTION_MYSQL :
 376 
			case self::ABSTRACTION_MYSQL :
381 
				$retour = mysql_insert_id($this->connexion);
 377 
				$retour = mysql_insert_id($this->connexion);
382 
				break;
 378 
				break;
383 
			case self::ABSTRACTION_MYSQLI :
 379 
			case self::ABSTRACTION_MYSQLI :
384 
				$retour = $this->connexion->insert_id();
 380 
				$retour = $this->connexion->insert_id();
385 
				break;
 381 
				break;
386 
			case self::ABSTRACTION_SQLITE3 :
 382 
			case self::ABSTRACTION_SQLITE3 :
387 
				$retour = $this->connexion->lastInsertRowID();
 383 
				$retour = $this->connexion->lastInsertRowID();
388 
				break;
 384 
				break;
389 
		}
 385 
		}
390 
		return $retour;
 386 
		return $retour;
391 
	}
 387 
	}
392
388
393 
	/**
 389 
	/**
394 
	 * Destructeur de classe, se contente de fermer explicitement la connexion à la base de donnée.
 390 
	 * Destructeur de classe, se contente de fermer explicitement la connexion à la base de donnée.
395 
	 */
 391 
	 */
396 
	public function __destruct() {
 392 
	public function __destruct() {
397 
		if (isset($this->connexion)) {
 393 
		if (isset($this->connexion)) {
398 
			switch ($this->abstraction) {
 394 
			switch ($this->abstraction) {
399 
				case self::ABSTRACTION_PDO :
 395 
				case self::ABSTRACTION_PDO :
400 
					$this->connexion = null;
 396 
					$this->connexion = null;
401 
					break;
 397 
					break;
402 
				case self::ABSTRACTION_MYSQL :
 398 
				case self::ABSTRACTION_MYSQL :
403 
					if (isset($this->connexion)) {
 399 
					if (isset($this->connexion)) {
404 
						return mysql_close($this->connexion);
 400 
						return mysql_close($this->connexion);
405 
					}
401 
					}
406 
					break;
 402 
					break;
407 
				case self::ABSTRACTION_MYSQLI :
 403 
				case self::ABSTRACTION_MYSQLI :
408 
					$this->connexion->close();
 404 
					$this->connexion->close();
409 
					break;
 405 
					break;
410 
				case self::ABSTRACTION_SQLITE3 :
 406 
				case self::ABSTRACTION_SQLITE3 :
411 
					$this->connexion->close();
 407 
					$this->connexion->close();
412 
					break;
 408 
					break;
413 
			}
 409 
			}
414 
		}
 410 
		}
415 
	}
 411 
	}
416 
}
 412 
}
417 
?>
 413 
?>