Subversion Repositories eFlore/Applications.cel

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
1204 jpm 1
<?php
2
/**
3
 * La classe de gestion de la base de données.
4
 *
5
 * @category php 5.2
6
 * @package cel
7
 * @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
8
 * @copyright Copyright (c) 2012, Tela Botanica (accueil@tela-botanica.org)
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
11
 * @version	$Id$
12
 */
13
class Bdd {
14
 
15
	const SQL_MODE_ASSOC = PDO::FETCH_ASSOC;
16
	const SQL_MODE_OBJET = PDO::FETCH_OBJ;
17
	const SQL_RETOUR_COMPLET = 'All';
18
	const SQL_RETOUR_LIGNE = 'Row';
19
	const SQL_RETOUR_COLONNE = 'Column';
20
	const SQL_RETOUR_BRUT = 'Raw';
21
 
22
	private $bdd = null;
23
 
24
	public function __construct($cfg) {
25
		// ATTENTION : la connexin à la bdd peut échouer si l'host vaut localhost. Utiliser 127.0.0.1 à la place.
26
		$dsn = $cfg['phptype'].':dbname='.$cfg['database'].';host='.$cfg['hostspec'];
27
		try {
28
			// Création de la connexion en UTF-8 à la BDD
29
			$this->bdd = new PDO($dsn, $cfg['username'], $cfg['password'], array(PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES 'UTF8'"));
30
			// Affiche les erreurs détectées par PDO (sinon mode silencieux => aucune erreur affiché)
31
			$this->bdd->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
32
		} catch (PDOException $e) {
33
			$message = "La connexion à la base de donnée via PDO a échouée : $dsn {$e->getMessage()}";
34
			$code = E_USER_ERROR;
35
			throw new Exception($message, $code);
36
		}
37
	}
38
 
39
	/**
40
	 * Protège automatiquement toutes les chaines comprises entre deux caractères '|'.
41
	 * Puis execute la requete.
42
	 * @see protegerRequete()
43
	 * @param unknown_type $requete
44
	 */
45
	public function requeter($requete, $retour = self::SQL_RETOUR_COMPLET, $mode = PDO::FETCH_ASSOC) {
46
		$resultat = false;
47
		try {
48
			switch ($retour) {
49
				case self::SQL_RETOUR_COMPLET :
50
					$resultat = $this->bdd->query($requete)->fetchAll($mode);// Retourne toutes les lignes
51
					break;
52
				case self::SQL_RETOUR_LIGNE :
53
					$resultat = $this->bdd->query($requete)->fetch($mode);// Retourne la première ligne
54
					break;
55
				case self::SQL_RETOUR_COLONNE :
56
					$resultat = $this->bdd->query($requete)->fetchColumn();// Retourne la première colonne de la première ligne
57
					break;
58
				case self::SQL_RETOUR_BRUT :
59
					$resultat = $this->bdd->query($requete);// Retourne l'objet brut pour être utilisé dans une boucle de type foreach
60
					break;
61
				default:
62
					$message = "Le type de retour '$retour' est inconnu.";
63
					$code = E_USER_ERROR;
64
					throw new Exception($message, $code);
65
			}
66
			if ($resultat === false) {
67
				$message = "La requête a retourné aucun résultat : $requete";
68
				$code = E_USER_NOTICE;
69
				throw new Exception($message, $code);
70
			}
71
		} catch (PDOException $e) {
72
			$message = sprintf($this->getTxt('sql_erreur_requete'), $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
73
			$code = E_USER_ERROR;
74
			throw new Exception($message, $code);
75
		}
76
		return $resultat;
77
	}
78
 
79
	/**
80
	 * Protège automatiquement toutes les chaines comprises entre deux caractères '|'.
81
	 * @see protegerRequete()
82
	 * @param unknown_type $requete
83
	 */
84
	public function executer($requete) {
85
		$resultat = false;
86
		try {
87
			$resultat = $this->bdd->exec($requete);
88
			if ($resultat === false) {
89
				$this->debug[] = "La requête a échoué : $requete";
90
			}
91
		} catch (PDOException $e) {
92
			$message = sprintf($this->getTxt('sql_erreur_requete'), $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
93
			$code = E_USER_ERROR;
94
			throw new Exception($message);
95
		}
96
		return $resultat;
97
	}
98
 
99
	public function proteger($element) {
100
		$element = is_array($element) ? $this->protegerTableau($element) : $this->protegerChaine($element);
101
		return $element;
102
	}
103
 
104
	private function protegerChaine($chaine) {
105
		return $this->bdd->quote($chaine);
106
	}
107
 
108
	private function protegerTableau(Array $tableau) {
109
		foreach ($tableau as $id => $val) {
110
			if (is_array($val)) {
111
				$tableau[$id] = $this->protegerTableau($val);
112
			} else {
113
				$tableau[$id] = $this->protegerChaine($val);
114
			}
115
		}
116
		return $tableau;
1223 jpm 117
	}
118
 
119
	public function etreNull($valeur) {
120
		$etreNull = false;
121
		if ($valeur == '' || $valeur == null || $valeur == '000null' || $valeur == 'null' || $valeur == '*') {
122
			$etreNull = true;
123
		}
124
		return $etreNull;
1204 jpm 125
	}
126
 
127
	public function getTxt($id) {
128
		$sortie = '';
129
		switch ($id) {
130
			case 'sql_erreur_requete' : $sortie = "Requête echec.\nFichier : %s.\nLigne : %s.\nMessage : %s.\nRequête : %s"; break;
131
			default : $sortie = $id;
132
		}
133
		return $sortie;
134
	}
135
}
136
?>