Subversion Repositories Applications.framework

Rev

Go to most recent revision | Details | 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.
5 
* Elle fait office d'abstraction légère de base de données en utilisant les objects PDO natifs
6 
* de PHP
7 
* Elle est abstraite donc doit obligatoirement être étendue.
8 
*
9 
* PHP Version 5
10 
*
11 
* @category  Class
12 
* @package   Framework
13 
* @author    aurelien <aurelien@tela-botanica.org>
14 
* @copyright 2009 Tela-Botanica
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 105 2009-08-31 15:25:05Z aurelien $$
18 
* @link      /doc/framework/
19 
*
20 
*/
5 aurelien 21 
abstract class Modele {
22 
 
23 
	/**
24 
	 * registre global
25 
	 */
26 
	private $registre;
27 
	/**
28 
	 * Gestionnaire d'exceptions php
29 
	 */
30 
	private $gestionnaire_exception;
31 
	/**
32 
	 * Gestionnaire d'erreurs php
33 
	 */
34 
	private $gestionnaire_erreur;
35 
	/**
105 aurelien 36 
	 * DSN pour accéder à la base de données
5 aurelien 37 
	 */
38 
	private $dsn;
39 
	/**
105 aurelien 40 
	 * Type de base de données (mysql, mysqli, etc ...)
5 aurelien 41 
	 */
42 
	private $type;
43 
	/**
105 aurelien 44 
	 * Hote herbergeant la base de données
5 aurelien 45 
	 */
46 
	private $hote;
47 
	/**
105 aurelien 48 
	 * Nom de la base de données à laquelle le modèle doit se connecter
5 aurelien 49 
	 */
50 
	private $bdd_nom;
51 
	/**
52 
	 * Nom d'utilisateur
53 
	 */
54 
	private $utilisateur;
55 
	/**
56 
	 * Mot de passe
57 
	 */
58 
	private $pass;
105 aurelien 59 
 
60 
    /**
61 
     * Encodage de la base de données
62 
     */
63 
     private $encodage = null;
5 aurelien 64 
	/**
105 aurelien 65 
	 * Connexion à la base de données
5 aurelien 66 
	 */
67 
	private $connexion = null;
68 
 
69 
	/**
105 aurelien 70 
	 * Constructeur par défaut, appelé à l'initialisation.
5 aurelien 71 
	 */
72 
    final public function __construct() {
105 aurelien 73 
    	// les différents paramètres nécessaires sont lus à partir du registre
5 aurelien 74 
    	$this->registre = Registre::getInstance();
75 
    	$this->gestionnaire_erreur = GestionnaireErreur::getInstance();
80 jpm 76 
    	$this->type = Config::get('bdd_protocole');
77 
    	$this->hote = Config::get('bdd_serveur');
78 
    	$this->bdd_nom = Config::get('bdd_nom');
79 
    	$this->utilisateur = Config::get('bdd_utilisateur');
80 
    	$this->pass = Config::get('bdd_mot_de_passe');
105 aurelien 81 
        $this->encodage = Config::get('bdd_encodage');
5 aurelien 82 
 
83 
    	$this->dsn = $this->type.':dbname='.$this->bdd_nom.';host='.$this->hote;
84 
    }
85 
 
86 
    /**
93 jpm 87 
     * Fonction qui appelle la bonne fonction de requete suivant le type de bdd.
88 
     *
105 aurelien 89 
     * @param string la requete à effectuer
90 
     * @return PDOStatement un objet contenant le résultat de la requête
5 aurelien 91 
     */
92 
    final protected function requete($requete) {
105 aurelien 93 
    	// on ne se connecte que lors du premier appel à une requete (lazy connexion)
89 jpm 94 
    	if ($this->connexion == null) {
5 aurelien 95 
    		$this->connecter();
96 
    	}
97 
		return $this->connexion->query($requete);
98 
    }
99 
 
100 
    /**
105 aurelien 101 
     * Connection à la base de données en utilisant les informations fournies par
93 jpm 102 
     * le fichier de configuration.
105 aurelien 103 
     * private et final car n'a pas vocation a être appelée par l'utilisateur.
93 jpm 104 
     *
105 aurelien 105 
     * @throws PDOException une exception dans le cas ou là connexion échoue
5 aurelien 106 
     */
107 
    final private function connecter() {
105 aurelien 108 
    	// TODO: retirer le try catch et laisser le problème au gestionnaire d'exceptions
5 aurelien 109 
		try {
105 aurelien 110 
		    $this->connexion = new PDO($this->dsn, $this->utilisateur, $this->pass);
111 
            if($this->encodage != null) {
112 
                $this->requete("SET names '".$this->encodage."'");
113 
            }
5 aurelien 114 
		} catch (PDOException $e) {
89 jpm 115 
 
5 aurelien 116 
		}
117 
    }
118 
 
119 
    /**
105 aurelien 120 
     * protège une chaine de caractères avant l'insertion dans la base de données
5 aurelien 121 
     */
122 
    final protected function proteger($chaine) {
105 aurelien 123 
    	// on ne se connecte que lors du premier appel à une requete
89 jpm 124 
    	if ($this->connexion == null) {
5 aurelien 125 
    		$this->connecter();
126 
    	}
127 
    	return $this->connexion->quote($chaine);
128 
    }
129 
 
130 
    /**
131 
     * Destructeur de classe, se contente de fermer explicitement la connexion
132 
     */
133 
    final public function __destruct() {
89 jpm 134 
    	if ($this->connexion != null) {
5 aurelien 135 
	    	$this->connexion = null ;
136 
    	}
137 
    }
138 
}
139 
?>