Subversion Repositories eFlore/Applications.cel

Rev

Rev 2460 | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

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