Subversion Repositories Applications.framework

Rev

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

Rev 403 Rev 407
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 403 2012-02-22 14:35:20Z gduche $
 20 
 * @version	$Id: Bdd.php 407 2012-02-22 16:33:59Z gduche $
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 
		if ($this->type == 'sqlite' || $this->type == 'sqlite2') {
 99 
		if ($this->type == 'sqlite' || $this->type == 'sqlite2') {
100 
			$this->dsn = $this->type.':'.$this->hote;
 100 
			$this->dsn = $this->type.':'.$this->hote;
101 
		} else {
 101 
		} else {
102 
			$this->dsn = $this->type.':dbname='.$this->bdd_nom.';host='.$this->hote;
 102 
			$this->dsn = $this->type.':dbname='.$this->bdd_nom.';host='.$this->hote;
103 
		}
 103 
		}
104 
		$this->initialiserProtocole();
 104 
		$this->initialiserProtocole();
105 
	}
 105 
	}
106 
 
 106 
 
107 
	/** Initialise les constantes de classe à leur bonne valeur et déclenche une erreur si le protocole n'est pas bien défini. */
 107 
	/** Initialise les constantes de classe à leur bonne valeur et déclenche une erreur si le protocole n'est pas bien défini. */
108 
	protected function initialiserProtocole() {
 108 
	protected function initialiserProtocole() {
109 
		switch ($this->abstraction) {
 109 
		switch ($this->abstraction) {
110 
			case self::ABSTRACTION_PDO :
 110 
			case self::ABSTRACTION_PDO :
111 
				$this->ASSOC = PDO::FETCH_ASSOC;
 111 
				$this->ASSOC = PDO::FETCH_ASSOC;
112 
				$this->OBJECT = PDO::FETCH_CLASS;
 112 
				$this->OBJECT = PDO::FETCH_CLASS;
113 
				break;
 113 
				break;
114 
			case self::ABSTRACTION_MYSQL :
 114 
			case self::ABSTRACTION_MYSQL :
115 
				$this->ASSOC = 'mysql_fetch_assoc';
 115 
				$this->ASSOC = 'mysql_fetch_assoc';
116 
				$this->OBJECT = 'mysql_fetch_object';
 116 
				$this->OBJECT = 'mysql_fetch_object';
117 
				break;
 117 
				break;
118 
			case self::ABSTRACTION_MYSQLI :
 118 
			case self::ABSTRACTION_MYSQLI :
119 
				$this->ASSOC = 'fetch_assoc';
 119 
				$this->ASSOC = 'fetch_assoc';
120 
				$this->OBJECT = 'fetch_object';
 120 
				$this->OBJECT = 'fetch_object';
121 
				break;
 121 
				break;
122 
			case self::ABSTRACTION_SQLITE3 :
 122 
			case self::ABSTRACTION_SQLITE3 :
123 
				$this->ASSOC = 'SQLITE3_ASSOC';
 123 
				$this->ASSOC = 'SQLITE3_ASSOC';
124 
				$this->OBJECT = 'SQLITE3_OBJECT';
 124 
				$this->OBJECT = 'SQLITE3_OBJECT';
125 
				break;
 125 
				break;
126 
			default:
 126 
			default:
127 
				$m = "Erreur : l'abstraction '{$this->abstraction}' n'est pas prise en charge";
 127 
				$m = "Erreur : l'abstraction '{$this->abstraction}' n'est pas prise en charge";
128 
				trigger_error($m, E_USER_WARNING);
 128 
				trigger_error($m, E_USER_WARNING);
129 
		}
 129 
		}
130 
	}
 130 
	}
131 
 
 131 
 
132 
	/**
 132 
	/**
133 
	 * Connection à la base de données en utilisant les informations fournies par
 133 
	 * Connection à la base de données en utilisant les informations fournies par
134 
	 * le fichier de configuration.
 134 
	 * le fichier de configuration.
135 
	 * Cette méthode est private et final car elle n'a pas vocation a être appelée par l'utilisateur.
 135 
	 * Cette méthode est private et final car elle n'a pas vocation a être appelée par l'utilisateur.
136 
	 */
 136 
	 */
137 
	protected function connecter() {
 137 
	protected function connecter() {
138 
		if ($this->connexion == null) {
 138 
		if ($this->connexion == null) {
139 
			switch ($this->abstraction) {
 139 
			switch ($this->abstraction) {
140 
				case self::ABSTRACTION_PDO :
 140 
				case self::ABSTRACTION_PDO :
141 
					try {
 141 
					try {
142 
						$this->connexion = new PDO($this->dsn, $this->utilisateur, $this->pass);
 142 
						$this->connexion = new PDO($this->dsn, $this->utilisateur, $this->pass);
143 
						$this->connexion->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
 143 
						$this->connexion->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
144 
					} catch (PDOException $e) {
 144 
					} catch (PDOException $e) {
145 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, $e->getMessage());
 145 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, $e->getMessage());
146 
						trigger_error($e, E_USER_WARNING);
 146 
						trigger_error($e, E_USER_WARNING);
147 
					}
 147 
					}
148 
					if ($this->encodage != null && $this->type == 'mysql') {
 148 
					if ($this->encodage != null && $this->type == 'mysql') {
149 
						$this->requeter("SET names '".$this->encodage."'");
 149 
						$this->requeter("SET names '".$this->encodage."'");
150 
					} else if ($this->type == 'sqlite') {
 150 
					} else if ($this->type == 'sqlite') {
151 
						$this->requeter("PRAGMA case_sensitive_like = false");
 151 
						$this->requeter("PRAGMA case_sensitive_like = false");
152 
					}
 152 
					}
153 
					break;
 153 
					break;
154 
				case self::ABSTRACTION_MYSQL :
 154 
				case self::ABSTRACTION_MYSQL :
155 
					$this->connexion = mysql_connect($this->hote, $this->utilisateur, $this->pass);
 155 
					$this->connexion = mysql_connect($this->hote, $this->utilisateur, $this->pass);
156 
					if ($this->connexion !== false) {
 156 
					if ($this->connexion !== false) {
157 
						$selection = mysql_select_db($this->bdd_nom, $this->connexion);
 157 
						$selection = mysql_select_db($this->bdd_nom, $this->connexion);
158 
						if ($selection === false) {
 158 
						if ($selection === false) {
159 
							$e = sprintf(self::ERREUR_SELECTION_BDD_TPL, mysql_error());
 159 
							$e = sprintf(self::ERREUR_SELECTION_BDD_TPL, mysql_error());
160 
							trigger_error($e, E_USER_WARNING);
 160 
							trigger_error($e, E_USER_WARNING);
161 
						}
 161 
						}
162 
					} else {
 162 
					} else {
163 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, mysql_error());
 163 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, mysql_error());
164 
						trigger_error($e, E_USER_WARNING);
 164 
						trigger_error($e, E_USER_WARNING);
165 
					}
 165 
					}
166 
					if ($this->encodage != null) {
 166 
					if ($this->encodage != null) {
167 
						$this->requeter("SET names '".$this->encodage."'");
 167 
						$this->requeter("SET names '".$this->encodage."'");
168 
					}
 168 
					}
169 
					break;
 169 
					break;
170 
				case self::ABSTRACTION_MYSQLI :
 170 
				case self::ABSTRACTION_MYSQLI :
171 
					$this->connexion = @new mysqli($this->hote, $this->utilisateur, $this->pass, $this->bdd_nom);
 171 
					$this->connexion = @new mysqli($this->hote, $this->utilisateur, $this->pass, $this->bdd_nom);
172 
					if ($this->connexion->connect_errno) {
 172 
					if ($this->connexion->connect_errno) {
173 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, $this->connexion->connect_error);
 173 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, $this->connexion->connect_error);
174 
						trigger_error($e, E_USER_WARNING);
 174 
						trigger_error($e, E_USER_WARNING);
175 
					}
 175 
					}
176 
					if ($this->encodage != null) {
 176 
					if ($this->encodage != null) {
177 
						$this->requeter("SET names '".$this->encodage."'");
 177 
						$this->requeter("SET names '".$this->encodage."'");
178 
					}
 178 
					}
179 
					break;
 179 
					break;
180 
				case self::ABSTRACTION_SQLITE3 :
 180 
				case self::ABSTRACTION_SQLITE3 :
181 
					// cas particulier de sqllite, on considère que le nom de la base de données correspond au fichier à ouvrir
 181 
					// cas particulier de sqllite, on considère que le nom de la base de données correspond au fichier à ouvrir
182 
					$this->connexion = new SQLite3($this->bdd_nom);
 182 
					$this->connexion = new SQLite3($this->bdd_nom);
183 
					if (!$this->connexion) {
 183 
					if (!$this->connexion) {
184 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, '');
 184 
						$e = sprintf(self::ERREUR_CONNEXION_TPL, '');
185 
						trigger_error($e, E_USER_WARNING);
 185 
						trigger_error($e, E_USER_WARNING);
186 
					}
 186 
					}
187 
					$this->requeter("PRAGMA case_sensitive_like = false");
 187 
					$this->requeter("PRAGMA case_sensitive_like = false");
188 
					break;
 188 
					break;
189 
				default:
 189 
				default:
190 
					$this->connexion = null;
 190 
					$this->connexion = null;
191 
			}
 191 
			}
192 
		}
 192 
		}
193 
	}
 193 
	}
194 
 
 194 
 
195 
	/**
 195 
	/**
196 
	 * @deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see requeter
 196 
	 * @deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see requeter
197 
	 */
 197 
	 */
198 
	final protected function requete($requete) {
 198 
	final protected function requete($requete) {
199 
		return $this->requeter($requete);
 199 
		return $this->requeter($requete);
200 
	}
 200 
	}
201 
 
 201 
 
202 
	/**
 202 
	/**
203 
	 * Execute une requête et retourne le résultat tel que renvoyé par l'abstraction courante.
 203 
	 * Execute une requête et retourne le résultat tel que renvoyé par l'abstraction courante.
204 
	 *
 204 
	 *
205 
	 * @param string la requête à effectuer
 205 
	 * @param string la requête à effectuer
206 
	 * @return mixed un objet contenant le résultat de la requête
 206 
	 * @return mixed un objet contenant le résultat de la requête
207 
	 */
 207 
	 */
208 
	public function requeter($requete) {
 208 
	public function requeter($requete) {
209 
		$this->connecter();
 209 
		$this->connecter();
210 
 
 210 
 
211 
		$retour = null;
 211 
		$retour = null;
212 
		switch ($this->abstraction) {
 212 
		switch ($this->abstraction) {
213 
			case self::ABSTRACTION_PDO :
 213 
			case self::ABSTRACTION_PDO :
214 
				try {
 214 
				try {
215 
					$retour = $this->connexion->query($requete);
 215 
					$retour = $this->connexion->query($requete);
216 
				} catch (PDOException $e) {
 216 
				} catch (PDOException $e) {
217 
					$m = sprintf(self::ERREUR_REQUETE_TPL, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
 217 
					$m = sprintf(self::ERREUR_REQUETE_TPL, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
218 
					trigger_error($m, E_USER_WARNING);
 218 
					trigger_error($m, E_USER_WARNING);
219 
				}
 219 
				}
220 
				break;
 220 
				break;
221 
			case self::ABSTRACTION_MYSQL :
 221 
			case self::ABSTRACTION_MYSQL :
222 
				$retour = mysql_query($requete, $this->connexion);
 222 
				$retour = mysql_query($requete, $this->connexion);
223 
				break;
 223 
				break;
224 
			case self::ABSTRACTION_MYSQLI :
 224 
			case self::ABSTRACTION_MYSQLI :
225 
				$retour = $this->connexion->query($requete);
 225 
				$retour = $this->connexion->query($requete);
226 
				break;
 226 
				break;
227 
			case self::ABSTRACTION_SQLITE3 :
 227 
			case self::ABSTRACTION_SQLITE3 :
228 
				$retour = $this->connexion->exec($requete);
 228 
				$retour = $this->connexion->exec($requete);
229 
				break;
 229 
				break;
230 
		}
 230 
		}
231 
		return $retour;
 231 
		return $retour;
232 
	}
 232 
	}
233 
 
 233 
 
234 
	/**
 234 
	/**
235 
	 * @deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see recuperer
 235 
	 * @deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see recuperer
236 
	 */
 236 
	 */
237 
	final protected function requeteUn($requete, $mode = self::MODE_ASSOC) {
 237 
	final protected function requeteUn($requete, $mode = self::MODE_ASSOC) {
238 
		return $this->recuperer($requete, $mode);
 238 
		return $this->recuperer($requete, $mode);
239 
	}
 239 
	}
240 
 
 240 
 
241 
	/**
 241 
	/**
242 
	 * Execute une requête et retourne le premier résultat sous forme de tableau (par défaut) ou d'objet.
 242 
	 * Execute une requête et retourne le premier résultat sous forme de tableau (par défaut) ou d'objet.
243 
	 * 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.
 243 
	 * 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.
244 
	 *
 244 
	 *
245 
	 * @param string la requête à effectuer
 245 
	 * @param string la requête à effectuer
246 
	 * @param string le mode de retour ASSOC (Bdd::MODE_ASSOC) pour un tableau ou OBJECT (Bdd::MODE_OBJET) pour un objet.
 246 
	 * @param string le mode de retour ASSOC (Bdd::MODE_ASSOC) pour un tableau ou OBJECT (Bdd::MODE_OBJET) pour un objet.
247 
	 * @return mixed un objet ou un tableau contenant le résultat de la requête
 247 
	 * @return mixed un objet ou un tableau contenant le résultat de la requête
248 
	 */
 248 
	 */
249 
	public function recuperer($requete, $mode = self::MODE_ASSOC) {
 249 
	public function recuperer($requete, $mode = self::MODE_ASSOC) {
250 
		$this->connecter();
 250 
		$this->connecter();
251 
 
 251 
 
252 
		$retour = null;
 252 
		$retour = null;
253 
		switch ($this->abstraction) {
 253 
		switch ($this->abstraction) {
254 
			case self::ABSTRACTION_PDO :
 254 
			case self::ABSTRACTION_PDO :
255 
				try {
 255 
				try {
256 
					$resultat = $this->connexion->query($requete);
 256 
					$resultat = $this->connexion->query($requete);
257 
					$retour = ($resultat !== false) ? $resultat->fetch($this->$mode) : $resultat;
 257 
					$retour = ($resultat !== false) ? $resultat->fetch($this->$mode) : $resultat;
258 
				} catch (PDOException $e) {
 258 
				} catch (PDOException $e) {
259 
					$m = sprintf(self::ERREUR_REQUETE_TPL, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
 259 
					$m = sprintf(self::ERREUR_REQUETE_TPL, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
260 
					trigger_error($m, E_USER_WARNING);
 260 
					trigger_error($m, E_USER_WARNING);
261 
				}
 261 
				}
262 
				break;
 262 
				break;
263 
			case self::ABSTRACTION_MYSQL :
 263 
			case self::ABSTRACTION_MYSQL :
264 
				$res = mysql_query($requete, $this->connexion);
 264 
				$res = mysql_query($requete, $this->connexion);
265 
				$fonction_fetch = $this->$mode;
 265 
				$fonction_fetch = $this->$mode;
266 
				$retour = $fonction_fetch($res);
 266 
				$retour = $fonction_fetch($res);
267 
				break;
 267 
				break;
268 
			case self::ABSTRACTION_MYSQLI :
 268 
			case self::ABSTRACTION_MYSQLI :
269 
				$res = $this->connexion->query($requete);
 269 
				$res = $this->connexion->query($requete);
270 
				$fonction_fetch = $this->$mode;
 270 
				$fonction_fetch = $this->$mode;
271 
				$retour = $res->$fonction_fetch();
 271 
				$retour = $res->$fonction_fetch();
272 
				break;
 272 
				break;
273 
			case self::ABSTRACTION_SQLITE3 :
 273 
			case self::ABSTRACTION_SQLITE3 :
274 
				$retour = $this->connexion->querySingle($requete);
 274 
				$retour = $this->connexion->querySingle($requete);
275 
				break;
 275 
				break;
276 
		}
 276 
		}
277 
		return $retour;
 277 
		return $retour;
278 
	}
 278 
	}
279 
 
 279 
 
280 
	/**
 280 
	/**
281 
	 * @deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see recupererTous
 281 
	 * @deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see recupererTous
282 
	 */
 282 
	 */
283 
	final protected function requeteTous($requete, $mode = self::MODE_ASSOC) {
 283 
	final protected function requeteTous($requete, $mode = self::MODE_ASSOC) {
284 
		return $this->recupererTous($requete, $mode);
 284 
		return $this->recupererTous($requete, $mode);
285 
	}
 285 
	}
286 
 
 286 
 
287 
	/**
 287 
	/**
288 
	 * Execute une requête et retourne un tableau de résultats. Un résultat peut être présentés sous forme
 288 
	 * Execute une requête et retourne un tableau de résultats. Un résultat peut être présentés sous forme
289 
	 * de tableau (par défaut) ou d'objet.
 289 
	 * de tableau (par défaut) ou d'objet.
290 
	 * Les noms des champs de la base de données correspondent aux noms des clés du tableau résultat ou
 290 
	 * Les noms des champs de la base de données correspondent aux noms des clés du tableau résultat ou
291 
	 * aux noms des attributs de l'objet résultat.
 291 
	 * aux noms des attributs de l'objet résultat.
292 
	 *
 292 
	 *
293 
	 * @param string la requête à effectuer
 293 
	 * @param string la requête à effectuer
294 
	 * @param string le mode de retour des résultats : ASSOC (Bdd::MODE_ASSOC) pour un tableau ou OBJECT (Bdd::MODE_OBJET) pour un objet.
 294 
	 * @param string le mode de retour des résultats : ASSOC (Bdd::MODE_ASSOC) pour un tableau ou OBJECT (Bdd::MODE_OBJET) pour un objet.
295 
	 * @return array un tableau contenant les résultats sous forme d'objets ou de tableau (par défaut).
 295 
	 * @return array un tableau contenant les résultats sous forme d'objets ou de tableau (par défaut).
296 
	 */
 296 
	 */
297 
	public function recupererTous($requete, $mode = self::MODE_ASSOC) {
 297 
	public function recupererTous($requete, $mode = self::MODE_ASSOC) {
298 
		$this->connecter();
 298 
		$this->connecter();
299 
 
 299 
 
300 
		$retour = null;
 300 
		$retour = null;
301 
		switch ($this->abstraction) {
 301 
		switch ($this->abstraction) {
302 
			case self::ABSTRACTION_PDO :
 302 
			case self::ABSTRACTION_PDO :
303 
				try {
 303 
				try {
304 
					$resultat = $this->connexion->query($requete);
 304 
					$resultat = $this->connexion->query($requete);
305 
					$retour = ($resultat !== false) ? $resultat->fetchAll($this->$mode) : $resultat;
 305 
					$retour = ($resultat !== false) ? $resultat->fetchAll($this->$mode) : $resultat;
306 
				} catch (PDOException $e) {
 306 
				} catch (PDOException $e) {
307 
					$m = sprintf(self::ERREUR_REQUETE_TPL, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
 307 
					$m = sprintf(self::ERREUR_REQUETE_TPL, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
308 
					trigger_error($m, E_USER_WARNING);
 308 
					trigger_error($m, E_USER_WARNING);
309 
				}
 309 
				}
310 
				break;
 310 
				break;
311 
			case self::ABSTRACTION_MYSQL :
 311 
			case self::ABSTRACTION_MYSQL :
312 
				$resultat = mysql_query($requete, $this->connexion);
 312 
				$resultat = mysql_query($requete, $this->connexion);
313 
				$fonction_fetch = $this->$mode;
 313 
				$fonction_fetch = $this->$mode;
314 
				while ($ligne = $fonction_fetch($resultat)) {
 314 
				while ($ligne = $fonction_fetch($resultat)) {
315 
					$retour[] = $ligne;
 315 
					$retour[] = $ligne;
316 
				}
 316 
				}
317 
				break;
 317 
				break;
318 
			case self::ABSTRACTION_MYSQLI :
 318 
			case self::ABSTRACTION_MYSQLI :
319 
				$resultat = $this->connexion->query($requete);
 319 
				$resultat = $this->connexion->query($requete);
320 
				$function_fetch = $this->$mode;
 320 
				$function_fetch = $this->$mode;
321 
				while ($ligne = $resultat->$function_fetch()) {
 321 
				while ($ligne = $resultat->$function_fetch()) {
322 
					$retour[] = $ligne;
 322 
					$retour[] = $ligne;
323 
				}
 323 
				}
324 
				break;
 324 
				break;
325 
			case self::ABSTRACTION_SQLITE3 :
 325 
			case self::ABSTRACTION_SQLITE3 :
326 
				$resultat = $this->connexion->query($requete);
 326 
				$resultat = $this->connexion->query($requete);
327 
				while ($ligne = $resultat->fetch_array($this->ASSOC)) {
 327 
				while ($ligne = $resultat->fetch_array($this->ASSOC)) {
328 
					if ($mode == self::MODE_OBJET) {
 328 
					if ($mode == self::MODE_OBJET) {
329 
						// Cas particulier de sqllite qui n'a pas de fonction fetch_object
 329 
						// Cas particulier de sqllite qui n'a pas de fonction fetch_object
330 
						$ligneObjet = new stdClass();
 330 
						$ligneObjet = new stdClass();
331 
						foreach ($ligne as $colonne => $valeur) {
 331 
						foreach ($ligne as $colonne => $valeur) {
332 
							$ligneObjet->$colonne = $valeur;
 332 
							$ligneObjet->$colonne = $valeur;
333 
						}
 333 
						}
334 
						$ligne = $ligneObjet;
 334 
						$ligne = $ligneObjet;
335 
					}
 335 
					}
336 
					$retour[] = $ligne;
 336 
					$retour[] = $ligne;
337 
				}
 337 
				}
338 
				break;
 338 
				break;
339 
		}
 339 
		}
340 
		return $retour;
 340 
		return $retour;
341 
	}
 341 
	}
342 
 
 342 
 
343 
	/**
 343 
	/**
344 
	 * Protège une chaine de caractères avant l'insertion dans la base de données (ajout de quotes ou guillemets).
 344 
	 * Protège une chaine de caractères avant l'insertion dans la base de données (ajout de quotes ou guillemets).
345 
	 * @param string la chaine à protéger
 345 
	 * @param string la chaine à protéger
346 
	 * @return string la chaine protégée
 346 
	 * @return string la chaine protégée
347 
	 */
 347 
	 */
348 
	public function proteger($chaine) {
 348 
	public function proteger($chaine) {
349 
		$this->connecter();
 349 
		$this->connecter();
350 
 
 350 
 
351 
		$retour = $chaine;
 351 
		$retour = $chaine;
352 
		switch ($this->abstraction) {
 352 
		switch ($this->abstraction) {
353 
			case self::ABSTRACTION_PDO :
 353 
			case self::ABSTRACTION_PDO :
354 
				$retour = $this->connexion->quote($chaine);
 354 
				$retour = $this->connexion->quote($chaine);
355 
				break;
 355 
				break;
356 
			case self::ABSTRACTION_MYSQL :
 356 
			case self::ABSTRACTION_MYSQL :
357 
				$retour = '"'.mysql_real_escape_string($chaine, $this->connexion).'"';
 357 
				$retour = '"'.mysql_real_escape_string($chaine, $this->connexion).'"';
358 
				break;
 358 
				break;
359 
			case self::ABSTRACTION_MYSQLI :
 359 
			case self::ABSTRACTION_MYSQLI :
360 
				$retour = '"'.$this->connexion->real_escape_string($chaine).'"';
 360 
				$retour = '"'.$this->connexion->real_escape_string($chaine).'"';
361 
				break;
 361 
				break;
362 
			case self::ABSTRACTION_SQLITE3 :
 362 
			case self::ABSTRACTION_SQLITE3 :
363 
				$retour = $this->connexion->escapeString($chaine);
 363 
				$retour = $this->connexion->escapeString($chaine);
364 
				break;
 364 
				break;
365 
		}
 365 
		}
366 
		return $retour;
 366 
		return $retour;
367 
	}
 367 
	}
368
368
369 
	/**
 369 
	/**
370 
	* Protège les chaines d'un tableau de caractères avant l'insertion dans la base de données (ajout de quotes ou guillemets).
 370 
	* Protège les chaines d'un tableau de caractères avant l'insertion dans la base de données (ajout de quotes ou guillemets).
371 
	* @param array le tableau de chaines à protéger
 371 
	* @param array le tableau de chaines à protéger
372 
	* @return array le tableau avec les chaines protégées
 372 
	* @return array le tableau avec les chaines protégées
373 
	*/
 373 
	*/
374 
	private function protegerTableau($tableau) {
 374 
	public function protegerTableau($tableau) {
375 
		$champsProteges = array();
 375 
		$champsProteges = array();
376 
		foreach($tableau as $champ => $valeur) {
 376 
		foreach($tableau as $champ => $valeur) {
377 
			$champsProteges[$champ] = $this->proteger($valeur);
 377 
			$champsProteges[$champ] = $this->proteger($valeur);
378 
		}
 378 
		}
379 
		return $champsProteges;
 379 
		return $champsProteges;
380 
	}
 380 
	}
381 
 
 381 
 
382 
	/**
 382 
	/**
383 
	 * 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
 383 
	 * 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
384 
	 * le cas de PDO, du driver utilisé. Les méthodes utilisées pour retourner l'identifiant peuvent avoir des comportements
 384 
	 * le cas de PDO, du driver utilisé. Les méthodes utilisées pour retourner l'identifiant peuvent avoir des comportements
385 
	 * différent. Consulter la documentation PHP correspondant à l'abstraction choisie avant de l'utiliser :
 385 
	 * différent. Consulter la documentation PHP correspondant à l'abstraction choisie avant de l'utiliser :
386 
	 * @link(http://fr.php.net/manual/fr/pdo.lastinsertid.php, PDO::lastInsertId([ string $name = NULL ]))
 386 
	 * @link(http://fr.php.net/manual/fr/pdo.lastinsertid.php, PDO::lastInsertId([ string $name = NULL ]))
387 
	 * @link(http://php.net/manual/en/mysqli.insert-id.php, mysqli->insert_id())
 387 
	 * @link(http://php.net/manual/en/mysqli.insert-id.php, mysqli->insert_id())
388 
	 * @link(http://fr.php.net/manual/fr/function.mysql-insert-id.php, mysql_insert_id())
 388 
	 * @link(http://fr.php.net/manual/fr/function.mysql-insert-id.php, mysql_insert_id())
389 
	 * @link(http://fr.php.net/manual/fr/sqlite3.lastinsertrowid.php, SQLite3::lastInsertRowID())
 389 
	 * @link(http://fr.php.net/manual/fr/sqlite3.lastinsertrowid.php, SQLite3::lastInsertRowID())
390 
	 * @param mixed un paramètre éventuel à transmettre (en fonction de l'abstraction de BDD utilisée).
 390 
	 * @param mixed un paramètre éventuel à transmettre (en fonction de l'abstraction de BDD utilisée).
391 
	 * @return mixed le dernier identifiant de clé primaire ajouté dans la base de données (string ou int).
 391 
	 * @return mixed le dernier identifiant de clé primaire ajouté dans la base de données (string ou int).
392 
	 */
 392 
	 */
393 
	public function recupererIdDernierAjout($parametres = null) {
 393 
	public function recupererIdDernierAjout($parametres = null) {
394 
		$this->connecter();
 394 
		$this->connecter();
395 
 
 395 
 
396 
		$retour = $chaine;
 396 
		$retour = $chaine;
397 
		switch ($this->abstraction) {
 397 
		switch ($this->abstraction) {
398 
			case self::ABSTRACTION_PDO :
 398 
			case self::ABSTRACTION_PDO :
399 
				$retour = $this->connexion->lastInsertId($parametres);
 399 
				$retour = $this->connexion->lastInsertId($parametres);
400 
				break;
 400 
				break;
401 
			case self::ABSTRACTION_MYSQL :
 401 
			case self::ABSTRACTION_MYSQL :
402 
				$retour = mysql_insert_id($this->connexion);
 402 
				$retour = mysql_insert_id($this->connexion);
403 
				break;
 403 
				break;
404 
			case self::ABSTRACTION_MYSQLI :
 404 
			case self::ABSTRACTION_MYSQLI :
405 
				$retour = $this->connexion->insert_id();
 405 
				$retour = $this->connexion->insert_id();
406 
				break;
 406 
				break;
407 
			case self::ABSTRACTION_SQLITE3 :
 407 
			case self::ABSTRACTION_SQLITE3 :
408 
				$retour = $this->connexion->lastInsertRowID();
 408 
				$retour = $this->connexion->lastInsertRowID();
409 
				break;
 409 
				break;
410 
		}
 410 
		}
411 
		return $retour;
 411 
		return $retour;
412 
	}
 412 
	}
413 
 
 413 
 
414 
	/**
 414 
	/**
415 
	 * Destructeur de classe, se contente de fermer explicitement la connexion à la base de donnée.
 415 
	 * Destructeur de classe, se contente de fermer explicitement la connexion à la base de donnée.
416 
	 */
 416 
	 */
417 
	public function __destruct() {
 417 
	public function __destruct() {
418 
		if (isset($this->connexion)) {
 418 
		if (isset($this->connexion)) {
419 
			switch ($this->abstraction) {
 419 
			switch ($this->abstraction) {
420 
				case self::ABSTRACTION_PDO :
 420 
				case self::ABSTRACTION_PDO :
421 
					$this->connexion = null;
 421 
					$this->connexion = null;
422 
					break;
 422 
					break;
423 
				case self::ABSTRACTION_MYSQL :
 423 
				case self::ABSTRACTION_MYSQL :
424 
					if (isset($this->connexion)) {
 424 
					if (isset($this->connexion)) {
425 
						return mysql_close($this->connexion);
 425 
						return mysql_close($this->connexion);
426 
					}
 426 
					}
427 
					break;
 427 
					break;
428 
				case self::ABSTRACTION_MYSQLI :
 428 
				case self::ABSTRACTION_MYSQLI :
429 
					$this->connexion->close();
 429 
					$this->connexion->close();
430 
					break;
 430 
					break;
431 
				case self::ABSTRACTION_SQLITE3 :
 431 
				case self::ABSTRACTION_SQLITE3 :
432 
					$this->connexion->close();
 432 
					$this->connexion->close();
433 
					break;
 433 
					break;
434 
			}
 434 
			}
435 
		}
 435 
		}
436 
	}
 436 
	}
437 
}
 437 
}
438 
?>
 438 
?>