Subversion Repositories eFlore/Applications.cel

Rev

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

Rev Author Line No. Line
1721 raphael 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 Raphaël Droz <raphael@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
10 
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
11 
 */
12 
class Bdd2 extends PDO {
13 
 
14 
	const SQL_MODE_ASSOC = PDO::FETCH_ASSOC;
15 
	const SQL_MODE_OBJET = PDO::FETCH_OBJ;
16 
	const SQL_RETOUR_COMPLET = 'All';
17 
	const SQL_RETOUR_LIGNE = 'Row';
18 
	const SQL_RETOUR_COLONNE = 'Column';
19 
	const SQL_RETOUR_BRUT = 'Raw';
20 
 
2144 jpm 21 
	public function __construct($config, $base = 'database_cel') {
22 
		$cfg = $config[$base];
23 
		// ATTENTION : la connexin à la bdd peut échouer si l'host vaut localhost. Utiliser 127.0.0.1 à la place.
1721 raphael 24 
		$dsn = $cfg['phptype'].':dbname='.$cfg['database'].';host='.$cfg['hostspec'];
25 
		try {
2144 jpm 26 
			// Création de la connexion en UTF-8 à la BDD
1721 raphael 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é)
29 
			parent::setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
30 
		} catch (PDOException $e) {
2144 jpm 31 
			echo 'La connexion à la base de donnée via PDO a échouée : ' .$dsn . "\n". $e->getMessage();
1721 raphael 32 
		}
33 
	}
34 
 
35 
	/**
36 
	 * Protège automatiquement toutes les chaines comprises entre deux caractères '|'.
37 
	 * Puis execute la requete.
38 
	 * @see protegerRequete()
39 
	 * @param unknown_type $requete
40 
	 */
41 
	public function requeter($requete, $retour = self::SQL_RETOUR_COMPLET, $mode = PDO::FETCH_ASSOC) {
42 
		return $this->executerRequete($requete, $retour, $mode);
43 
	}
44 
 
45 
	/**
2143 jpm 46 
	 * Execute la requete retournant une seule ligne de résultat.
47 
	 * @param String $requete
1721 raphael 48 
	 */
2143 jpm 49 
	public function requeterLigne($requete, $mode = PDO::FETCH_ASSOC) {
50 
		return $this->executerRequete($requete, self::SQL_RETOUR_LIGNE, $mode);
1721 raphael 51 
	}
52 
 
53 
	/**
2143 jpm 54 
	 * Execute la requete retournant une seule colone de résultat.
55 
	 * @param String $requete
1721 raphael 56 
	 */
2143 jpm 57 
	public function requeterValeurUnique($requete, $mode = PDO::FETCH_ASSOC) {
58 
		return $this->executerRequete($requete, self::SQL_RETOUR_COLONNE, $mode);
1721 raphael 59 
	}
60 
 
61 
	public function executerRequete($requete, $retour = self::SQL_RETOUR_COMPLET, $mode = PDO::FETCH_ASSOC) {
62 
		$resultat = false;
63 
		try {
64 
			switch ($retour) {
65 
				case self::SQL_RETOUR_COMPLET :
66 
					$resultat = $this->query($requete)->fetchAll($mode);// Retourne toutes les lignes
67 
					break;
68 
				case self::SQL_RETOUR_LIGNE :
69 
					$resultat = $this->query($requete)->fetch($mode);// Retourne la première ligne
70 
					break;
71 
				case self::SQL_RETOUR_COLONNE :
72 
					$resultat = $this->query($requete)->fetchColumn();// Retourne la première colonne de la première ligne
73 
					break;
74 
				case self::SQL_RETOUR_BRUT :
75 
					$resultat = $this->query($requete);// Retourne l'objet brut pour être utilisé dans une boucle de type foreach
76 
					break;
77 
				default:
78 
					$this->debug[] = "Le type de retour '$retour' est inconnu.";
79 
			}
80 
			if ($resultat === false) {
81 
				$this->debug[] = "La requête a retourné aucun résultat : $requete";
82 
			}
83 
		} catch (PDOException $e) {
2143 jpm 84 
			$msgTpl = "Requête echec.\nFichier : %s.\nLigne : %s.\nMessage : %s.\nRequête : %s";
85 
			$this->debug[] = sprintf($msgTpl, $e->getFile(), $e->getLine(), $e->getMessage(), $requete);
1721 raphael 86 
		}
87 
		return $resultat;
88 
	}
89 
 
2143 jpm 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
102 
	 */
103 
	public function executer($requete) {
104 
		try {
105 
			$resultat = $this->exec($requete);
106 
			if ($resultat === false) {
107 
				$this->debug[] = "La requête a échoué : $requete";
108 
			}
109 
		} catch (PDOException $e) {
110 
			$message = "Fichier : {$e->getFile()} \nLigne : {$e->getLine()} \nMessage : {$e->getMessage()} \nRequête : $requete";
111 
			$code = E_USER_ERROR;
112 
			throw new Exception($message, $code);
1721 raphael 113 
		}
2143 jpm 114 
		return $resultat;
1721 raphael 115 
	}
2143 jpm 116 
 
117 
	public function proteger($donnees) {
118 
		if (is_array($donnees)) {
119 
			$retour = $this->protegerTableau($donnees);
120 
		} else {
121 
			$retour = $this->quote($donnees);
122 
		}
123 
		return $retour;
124 
	}
125 
 
126 
	private function protegerTableau(Array $tableau) {
127 
		foreach ($tableau as $id => $val) {
128 
			if (is_array($val)) {
129 
				$tableau[$id] = $this->protegerTableau($val);
130 
			} else {
131 
				$tableau[$id] = $this->proteger($val);
132 
			}
133 
		}
134 
		return $tableau;
135 
	}
136 
 
2042 aurelien 137 
	public function obtenirDernierId() {
138 
		return $this->lastInsertId();
139 
	}
1721 raphael 140 
 
141 
}