Subversion Repositories Applications.framework

Rev

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

Rev 119 Rev 120
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 119 2009-09-01 09:18:45Z jp_milcent $$
17 
* @version   SVN: $$Id: Modele.php 120 2009-09-01 12:21:14Z aurelien $$
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 
	 * DSN pour accéder à la base de données
 28 
	 * DSN pour accéder à la base de données
29 
	 */
 29 
	 */
30 
	private $dsn;
 30 
	private $dsn;
31 
	/**
 31 
	/**
32 
	 * Type de base de données (mysql, mysqli, etc ...)
 32 
	 * Type de base de données (mysql, mysqli, etc ...)
33 
	 */
 33 
	 */
34 
	private $type;
 34 
	private $type;
35 
	/**
 35 
	/**
36 
	 * Hote herbergeant la base de données
 36 
	 * Hote herbergeant la base de données
37 
	 */
 37 
	 */
38 
	private $hote;
 38 
	private $hote;
39 
	/**
 39 
	/**
40 
	 * 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
41 
	 */
 41 
	 */
42 
	private $bdd_nom;
 42 
	private $bdd_nom;
43 
	/**
 43 
	/**
44 
	 * Nom d'utilisateur
 44 
	 * Nom d'utilisateur
45 
	 */
 45 
	 */
46 
	private $utilisateur;
 46 
	private $utilisateur;
47 
	/**
 47 
	/**
48 
	 * Mot de passe
 48 
	 * Mot de passe
49 
	 */
 49 
	 */
50 
	private $pass;
 50 
	private $pass;
51
51 
 
52 
    /**
 52 
	/**
53 
     * Encodage de la base de données
 53 
	 * Encodage de la base de données
54 
     */
 54 
	 */
55 
     private $encodage = null;
 55 
	 private $encodage = null;
56 
	/**
 56 
	/**
57 
	 * Connexion à la base de données
 57 
	 * Connexion à la base de données
58 
	 */
 58 
	 */
59 
	private $connexion = null;
 59 
	private $connexion = null;
60 
 
 60 
 
61 
	/**
 61 
	/**
62 
	 * Constructeur par défaut, appelé à l'initialisation.
 62 
	 * Constructeur par défaut, appelé à l'initialisation.
63 
	 */
 63 
	 */
64 
    final public function __construct() {
 64 
	final public function __construct() {
65 
    	// 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
66 
    	$this->registre = Registre::getInstance();
 66 
		$this->registre = Registre::getInstance();
67 
    	$this->type = Config::get('bdd_protocole');
 67 
		$this->type = Config::get('bdd_protocole');
68 
    	$this->hote = Config::get('bdd_serveur');
 68 
		$this->hote = Config::get('bdd_serveur');
69 
    	$this->bdd_nom = Config::get('bdd_nom');
 69 
		$this->bdd_nom = Config::get('bdd_nom');
70 
    	$this->utilisateur = Config::get('bdd_utilisateur');
 70 
		$this->utilisateur = Config::get('bdd_utilisateur');
71 
    	$this->pass = Config::get('bdd_mot_de_passe');
 71 
		$this->pass = Config::get('bdd_mot_de_passe');
72 
        $this->encodage = Config::get('bdd_encodage');
 72 
		$this->encodage = Config::get('bdd_encodage');
73
73 
 
74 
    	$this->dsn = $this->type.':dbname='.$this->bdd_nom.';host='.$this->hote;
 74 
		$this->dsn = $this->type.':dbname='.$this->bdd_nom.';host='.$this->hote;
75 
    }
 75 
	}
76
76 
 
77 
    /**
 77 
	/**
78 
     * 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.
79 
     *
79 
	 *
80 
     * @param string la requete à effectuer
 80 
	 * @param string la requete à effectuer
81 
     * @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
82 
     */
 82 
	 */
83 
    final protected function requete($requete) {
 83 
	final protected function requete($requete) {
84 
    	// 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)
85 
    	if ($this->connexion == null) {
 85 
		if ($this->connexion == null) {
86 
    		$this->connecter();
 86 
			$this->connecter();
87 
    	}
 87 
		}
88 
		return $this->connexion->query($requete);
 88 
		return $this->connexion->query($requete);
89 
    }
 89 
	}
90
90 
 
91 
    /**
 91 
	/**
92 
     * 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
93 
     * le fichier de configuration.
 93 
	 * le fichier de configuration.
94 
     * 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.
95 
     *
95 
	 *
96 
     * @throws PDOException une exception dans le cas ou là connexion échoue
 96 
	 * @throws PDOException une exception dans le cas ou là connexion échoue
97 
     */
 97 
	 */
98 
    final private function connecter() {
 98 
	final private function connecter() {
99 
    	// TODO: retirer le try catch et laisser le problème au gestionnaire d'exceptions
- 
 
100 
		try {
 99 
 
101 
		    $this->connexion = new PDO($this->dsn, $this->utilisateur, $this->pass);
100 
			$this->connexion = new PDO($this->dsn, $this->utilisateur, $this->pass);
102 
            if($this->encodage != null) {
 101 
			if($this->encodage != null) {
103 
                $this->requete("SET names '".$this->encodage."'");
 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
104 
            }
 108 
	 */
- 
 
 109 
	final protected function proteger($chaine) {
- 
 
 110 
		// on ne se connecte que lors du premier appel à une requete
105 
		} catch (PDOException $e) {
 111 
		if ($this->connexion == null) {
106 
			echo $e->getMessage();
 112 
			$this->connecter();
- 
 
 113 
		}
- 
 
 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 ;
107 
		}
 123 
		}
108 
    }
 - 
 
109
124 
	}
110 
    /**
 - 
 
111 
     * protège une chaine de caractères avant l'insertion dans la base de données
- 
 
112 
     */
 - 
 
113 
    final protected function proteger($chaine) {
 - 
 
114 
    	// on ne se connecte que lors du premier appel à une requete
 - 
 
115 
    	if ($this->connexion == null) {
 - 
 
116 
    		$this->connecter();
 - 
 
117 
    	}
 - 
 
118 
    	return $this->connexion->quote($chaine);
 - 
 
119 
    }
 - 
 
120
- 
 
121 
    /**
 - 
 
122 
     * Destructeur de classe, se contente de fermer explicitement la connexion
 - 
 
123 
     */
 - 
 
124 
    final public function __destruct() {
 - 
 
125 
    	if ($this->connexion != null) {
- 
 
126 
	    	$this->connexion = null ;
 - 
 
127 
    	}
 - 
 
128 
    }
 - 
 
129 
}
 125 
}
130 
?>
 126 
?>