Subversion Repositories Applications.framework

Rev

Rev 122 | Rev 133 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
5 aurelien 1
<?php
105 aurelien 2
// declare(encoding='UTF-8');
5 aurelien 3
/**
105 aurelien 4
* Classe modèle, donc d'accés au données, elle ne devrait pas être appelée de l'extérieur.
120 aurelien 5
* Elle fait office d'abstraction légère de base de données en utilisant les objects PDO natifs
105 aurelien 6
* de PHP
7
* Elle est abstraite donc doit obligatoirement être étendue.
120 aurelien 8
*
9
* PHP Version 5
10
*
105 aurelien 11
* @category  Class
12
* @package   Framework
120 aurelien 13
* @author	aurelien <aurelien@tela-botanica.org>
105 aurelien 14
* @copyright 2009 Tela-Botanica
120 aurelien 15
* @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
16
* @license   http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
17
* @version   SVN: $$Id: Modele.php 123 2009-09-01 15:33:34Z aurelien $$
18
* @link	  /doc/framework/
19
*
105 aurelien 20
*/
5 aurelien 21
abstract class Modele {
22
 
23
	/**
24
	 * registre global
25
	 */
26
	private $registre;
27
	/**
105 aurelien 28
	 * DSN pour accéder à la base de données
5 aurelien 29
	 */
30
	private $dsn;
31
	/**
105 aurelien 32
	 * Type de base de données (mysql, mysqli, etc ...)
5 aurelien 33
	 */
34
	private $type;
35
	/**
105 aurelien 36
	 * Hote herbergeant la base de données
5 aurelien 37
	 */
38
	private $hote;
39
	/**
105 aurelien 40
	 * Nom de la base de données à laquelle le modèle doit se connecter
5 aurelien 41
	 */
42
	private $bdd_nom;
43
	/**
44
	 * Nom d'utilisateur
45
	 */
46
	private $utilisateur;
47
	/**
48
	 * Mot de passe
49
	 */
50
	private $pass;
120 aurelien 51
 
5 aurelien 52
	/**
120 aurelien 53
	 * Encodage de la base de données
54
	 */
55
	 private $encodage = null;
56
	/**
105 aurelien 57
	 * Connexion à la base de données
5 aurelien 58
	 */
59
	private $connexion = null;
60
 
61
	/**
105 aurelien 62
	 * Constructeur par défaut, appelé à l'initialisation.
5 aurelien 63
	 */
120 aurelien 64
	final public function __construct() {
65
		// les différents paramètres nécessaires sont lus à partir du registre
66
		$this->registre = Registre::getInstance();
67
		$this->type = Config::get('bdd_protocole');
68
		$this->hote = Config::get('bdd_serveur');
69
		$this->bdd_nom = Config::get('bdd_nom');
70
		$this->utilisateur = Config::get('bdd_utilisateur');
71
		$this->pass = Config::get('bdd_mot_de_passe');
72
		$this->encodage = Config::get('bdd_encodage');
73
 
74
		$this->dsn = $this->type.':dbname='.$this->bdd_nom.';host='.$this->hote;
75
	}
76
 
77
	/**
78
	 * Fonction qui appelle la bonne fonction de requete suivant le type de bdd.
79
	 *
80
	 * @param string la requete à effectuer
81
	 * @return PDOStatement un objet contenant le résultat de la requête
82
	 */
83
	final protected function requete($requete) {
84
		// on ne se connecte que lors du premier appel à une requete (lazy connexion)
85
		if ($this->connexion == null) {
86
			$this->connecter();
87
		}
5 aurelien 88
		return $this->connexion->query($requete);
120 aurelien 89
	}
90
 
91
	/**
92
	 * Connection à la base de données en utilisant les informations fournies par
93
	 * le fichier de configuration.
94
	 * private et final car n'a pas vocation a être appelée par l'utilisateur.
95
	 *
96
	 * @throws PDOException une exception dans le cas ou là connexion échoue
97
	 */
98
	final private function connecter() {
99
 
100
			$this->connexion = new PDO($this->dsn, $this->utilisateur, $this->pass);
101
			if($this->encodage != null) {
102
				$this->requete("SET names '".$this->encodage."'");
103
			}
104
	}
105
 
106
	/**
107
	 * protège une chaine de caractères avant l'insertion dans la base de données
108
	 */
109
	final protected function proteger($chaine) {
110
		// on ne se connecte que lors du premier appel à une requete
111
		if ($this->connexion == null) {
112
			$this->connecter();
119 jp_milcent 113
		}
120 aurelien 114
		return $this->connexion->quote($chaine);
115
	}
116
 
117
	/**
118
	 * Destructeur de classe, se contente de fermer explicitement la connexion
119
	 */
120
	final public function __destruct() {
121
		if ($this->connexion != null) {
122
			$this->connexion = null ;
123
		}
124
	}
5 aurelien 125
}
126
?>