Subversion Repositories Applications.framework

Rev

Rev 105 | Rev 119 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

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