Subversion Repositories eFlore/Applications.cel

Rev

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

Rev 2101 Rev 2143
1
<?php
1
<?php
2
/**
2
/**
3
 * La classe de gestion de la base de données.
3
 * La classe de gestion de la base de données.
4
 *
4
 *
5
 * @category php 5.2
5
 * @category php 5.2
6
 * @package cel
6
 * @package cel
7
 * @author Raphaël Droz <raphael@tela-botanica.org>
7
 * @author Raphaël Droz <raphael@tela-botanica.org>
8
 * @copyright Copyright (c) 2013, Tela Botanica (accueil@tela-botanica.org)
8
 * @copyright Copyright (c) 2013, Tela Botanica (accueil@tela-botanica.org)
9
 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
9
 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
10
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
10
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
11
 */
11
 */
12
class Bdd2 extends PDO {
12
class Bdd2 extends PDO {
13
 
13
 
14
	const SQL_MODE_ASSOC = PDO::FETCH_ASSOC;
14
	const SQL_MODE_ASSOC = PDO::FETCH_ASSOC;
15
	const SQL_MODE_OBJET = PDO::FETCH_OBJ;
15
	const SQL_MODE_OBJET = PDO::FETCH_OBJ;
16
	const SQL_RETOUR_COMPLET = 'All';
16
	const SQL_RETOUR_COMPLET = 'All';
17
	const SQL_RETOUR_LIGNE = 'Row';
17
	const SQL_RETOUR_LIGNE = 'Row';
18
	const SQL_RETOUR_COLONNE = 'Column';
18
	const SQL_RETOUR_COLONNE = 'Column';
19
	const SQL_RETOUR_BRUT = 'Raw';
19
	const SQL_RETOUR_BRUT = 'Raw';
20
 
20
 
21
	function __construct($config, $base = 'database_cel') {
21
	function __construct($config, $base = 'database_cel') {
22
        $cfg = $config[$base];
22
        $cfg = $config[$base];
23
        // ATTENTION : la connexin à la bdd peut échouer si l'host vaut localhost. Utiliser 127.0.0.1 à la place.
23
        // ATTENTION : la connexin à la bdd peut échouer si l'host vaut localhost. Utiliser 127.0.0.1 à la place.
24
		$dsn = $cfg['phptype'].':dbname='.$cfg['database'].';host='.$cfg['hostspec'];
24
		$dsn = $cfg['phptype'].':dbname='.$cfg['database'].';host='.$cfg['hostspec'];
25
		try {
25
		try {
26
    		// Création de la connexion en UTF-8 à la BDD
26
    		// Création de la connexion en UTF-8 à la BDD
27
			parent::__construct($dsn, $cfg['username'], $cfg['password'], array(PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES 'UTF8'"));
27
			parent::__construct($dsn, $cfg['username'], $cfg['password'], array(PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES 'UTF8'"));
28
			// Affiche les erreurs détectées par PDO (sinon mode silencieux => aucune erreur affiché)
28
			// Affiche les erreurs détectées par PDO (sinon mode silencieux => aucune erreur affiché)
29
			parent::setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
29
			parent::setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
30
		} catch (PDOException $e) {
30
		} catch (PDOException $e) {
31
    		echo 'La connexion à la base de donnée via PDO a échouée : ' .$dsn . "\n". $e->getMessage();
31
    		echo 'La connexion à la base de donnée via PDO a échouée : ' .$dsn . "\n". $e->getMessage();
32
		}
32
		}
33
	}
33
	}
34
 
34
 
35
	/**
35
	/**
36
	 * Protège automatiquement toutes les chaines comprises entre deux caractères '|'.
36
	 * Protège automatiquement toutes les chaines comprises entre deux caractères '|'.
37
	 * Puis execute la requete.
37
	 * Puis execute la requete.
38
	 * @see protegerRequete()
38
	 * @see protegerRequete()
39
	 * @param unknown_type $requete
39
	 * @param unknown_type $requete
40
	 */
40
	 */
41
	public function requeter($requete, $retour = self::SQL_RETOUR_COMPLET, $mode = PDO::FETCH_ASSOC) {
41
	public function requeter($requete, $retour = self::SQL_RETOUR_COMPLET, $mode = PDO::FETCH_ASSOC) {
42
		$requete = $this->protegerRequete($requete);
-
 
43
		return $this->executerRequete($requete, $retour, $mode);
42
		return $this->executerRequete($requete, $retour, $mode);
44
	}
43
	}
45
 
44
 
46
	/**
45
	/**
47
	 * Protège automatiquement toutes les chaines comprises entre deux caractères '|'.
46
	 * Execute la requete retournant une seule ligne de résultat.
48
	 * @see protegerRequete()
-
 
49
	 * @param unknown_type $requete
47
	 * @param String $requete
50
	 */
48
	 */
51
	public function executer($requete) {
49
	public function requeterLigne($requete, $mode = PDO::FETCH_ASSOC) {
52
		$requete = $this->protegerRequete($requete);
-
 
53
		return $this->executerRequeteSimple($requete);
50
		return $this->executerRequete($requete, self::SQL_RETOUR_LIGNE, $mode);
54
	}
51
	}
55
 
52
 
56
	/**
53
	/**
57
	 * Méthode permettant de rechercher dans une requete SQL sous forme de chaine (String) les chaines
54
	 * Execute la requete retournant une seule colone de résultat.
58
	 * à protéger. Cela évite de protéger chaque variable avant de l'insérer dans une requete SQL.
-
 
59
	 * Par contre, il est important que les chaine à protéger ne contiennent pas le caractère '|'.
-
 
60
	 *
-
 
61
	 * @param $requete
55
	 * @param String $requete
62
	 */
56
	 */
63
	public function protegerRequete($requete) {
-
 
64
		if (substr_count($requete, '|') % 2 === 0) {
-
 
65
			if (preg_match_all('/\|([^|]*)\|/', $requete, $correspondances, PREG_SET_ORDER)) {
-
 
66
				foreach ($correspondances as $chaine) {
-
 
67
					$chaine_protegee = $this->quote($chaine[1]);
-
 
68
					$requete = str_replace($chaine[0], $chaine_protegee, $requete);
-
 
69
				}
-
 
70
			}
-
 
71
		} else {
-
 
72
			$this->messages[] = "La requête a protéger contient un nombre impair de caractère de protection '|'.";
-
 
73
			$requete = false;
-
 
74
		}
-
 
75
		return $requete;
-
 
76
	}
-
 
77
 
-
 
78
 
-
 
79
	public function proteger($chaine) {
-
 
80
		return $this->quote($chaine);
-
 
81
	}
-
 
82
	
-
 
83
	public function protegerTableau(Array $tableau) {
-
 
84
		foreach ($tableau as $id => $val) {
-
 
85
			if (is_array($val)) {
-
 
86
				$tableau[$id] = $this->protegerTableau($val);
-
 
87
			} else {
-
 
88
				$tableau[$id] = $this->proteger($val);
-
 
89
			}
-
 
90
		}
-
 
91
		return $tableau;
-
 
92
	}
-
 
93
 
-
 
94
	public function executerRequeteSimple($requete) {
57
	public function requeterValeurUnique($requete, $mode = PDO::FETCH_ASSOC) {
95
		$resultat = false;
-
 
96
		try {
-
 
97
			$resultat = $this->exec($requete);
-
 
98
			if ($resultat === false) {
-
 
99
				$this->debug[] = "La requête a échoué : $requete";
58
		return $this->executerRequete($requete, self::SQL_RETOUR_COLONNE, $mode);
100
			}
-
 
101
		} catch (PDOException $e) {
-
 
102
			$message = "Fichier : {$e->getFile()} \nLigne : {$e->getLine()} \nMessage : {$e->getMessage()} \nRequête : $requete";
-
 
103
			$code = E_USER_ERROR;
-
 
104
			throw new Exception($message, $code);
-
 
105
		}
-
 
106
		return $resultat;
-
 
107
	}
59
	}
108
 
60
 
109
	public function executerRequete($requete, $retour = self::SQL_RETOUR_COMPLET, $mode = PDO::FETCH_ASSOC) {
61
	public function executerRequete($requete, $retour = self::SQL_RETOUR_COMPLET, $mode = PDO::FETCH_ASSOC) {
110
		$resultat = false;
62
		$resultat = false;
111
		try {
63
		try {
112
			switch ($retour) {
64
			switch ($retour) {
113
				case self::SQL_RETOUR_COMPLET :
65
				case self::SQL_RETOUR_COMPLET :
114
					$resultat = $this->query($requete)->fetchAll($mode);// Retourne toutes les lignes
66
					$resultat = $this->query($requete)->fetchAll($mode);// Retourne toutes les lignes
115
					break;
67
					break;
116
				case self::SQL_RETOUR_LIGNE :
68
				case self::SQL_RETOUR_LIGNE :
117
					$resultat = $this->query($requete)->fetch($mode);// Retourne la première ligne
69
					$resultat = $this->query($requete)->fetch($mode);// Retourne la première ligne
118
					break;
70
					break;
119
				case self::SQL_RETOUR_COLONNE :
71
				case self::SQL_RETOUR_COLONNE :
120
					$resultat = $this->query($requete)->fetchColumn();// Retourne la première colonne de la première ligne
72
					$resultat = $this->query($requete)->fetchColumn();// Retourne la première colonne de la première ligne
121
					break;
73
					break;
122
				case self::SQL_RETOUR_BRUT :
74
				case self::SQL_RETOUR_BRUT :
123
					$resultat = $this->query($requete);// Retourne l'objet brut pour être utilisé dans une boucle de type foreach
75
					$resultat = $this->query($requete);// Retourne l'objet brut pour être utilisé dans une boucle de type foreach
124
					break;
76
					break;
125
				default:
77
				default:
126
					$this->debug[] = "Le type de retour '$retour' est inconnu.";
78
					$this->debug[] = "Le type de retour '$retour' est inconnu.";
127
			}
79
			}
128
			if ($resultat === false) {
80
			if ($resultat === false) {
129
				$this->debug[] = "La requête a retourné aucun résultat : $requete";
81
				$this->debug[] = "La requête a retourné aucun résultat : $requete";
130
			}
82
			}
131
		} catch (PDOException $e) {
83
		} catch (PDOException $e) {
-
 
84
			$msgTpl = "Requête echec.\nFichier : %s.\nLigne : %s.\nMessage : %s.\nRequête : %s";
132
			$this->debug[] = sprintf($this->getTxt('sql_erreur_requete'), $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
85
			$this->debug[] = sprintf($msgTpl, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
133
		}
86
		}
134
		return $resultat;
87
		return $resultat;
135
	}
88
	}
-
 
89
 
-
 
90
	/**
-
 
91
	 * Execute la requete retournant l'objet brut de résultat pour l'utiliser dans un foreach.
-
 
92
	 * @param String $requete
-
 
93
	 */
-
 
94
	public function requeterBrut($requete) {
-
 
95
		return $this->executerRequete($requete, self::SQL_RETOUR_BRUT);
-
 
96
	}
-
 
97
 
-
 
98
	/**
-
 
99
	 * Protège automatiquement toutes les chaines comprises entre deux caractères '|'.
-
 
100
	 * @see protegerRequete()
-
 
101
	 * @param unknown_type $requete
136
 
102
	 */
137
	public function getTxt($id) {
103
	public function executer($requete) {
138
		$sortie = '';
104
		$resultat = false;
-
 
105
		try {
-
 
106
			$resultat = $this->exec($requete);
139
		switch ($id) {
107
			if ($resultat === false) {
-
 
108
				$this->debug[] = "La requête a échoué : $requete";
-
 
109
			}
140
			case 'sql_erreur' : $sortie = 'Requête echec. Fichier : "%s". Ligne : "%s". Message : %s'; break;
110
		} catch (PDOException $e) {
141
			case 'sql_erreur_requete' : $sortie = "Requête echec.\nFichier : %s.\nLigne : %s.\nMessage : %s.\nRequête : %s"; break;
111
			$message = "Fichier : {$e->getFile()} \nLigne : {$e->getLine()} \nMessage : {$e->getMessage()} \nRequête : $requete";
-
 
112
			$code = E_USER_ERROR;
142
			default : $sortie = $id;
113
			throw new Exception($message, $code);
143
		}
114
		}
144
		return $sortie;
115
		return $resultat;
145
	}
116
	}
-
 
117
 
-
 
118
	public function proteger($donnees) {
-
 
119
		if (is_array($donnees)) {
-
 
120
			$retour = $this->protegerTableau($donnees);
-
 
121
		} else {
-
 
122
			$retour = $this->quote($donnees);
-
 
123
		}
-
 
124
		return $retour;
-
 
125
	}
-
 
126
 
-
 
127
	private function protegerTableau(Array $tableau) {
-
 
128
		foreach ($tableau as $id => $val) {
-
 
129
			if (is_array($val)) {
-
 
130
				$tableau[$id] = $this->protegerTableau($val);
-
 
131
			} else {
-
 
132
				$tableau[$id] = $this->proteger($val);
-
 
133
			}
-
 
134
		}
-
 
135
		return $tableau;
-
 
136
	}
146
	
137
 
147
	public function obtenirDernierId() {
138
	public function obtenirDernierId() {
148
		return $this->lastInsertId();
139
		return $this->lastInsertId();
149
	}
140
	}
150
 
141
 
151
}
142
}