Subversion Repositories Applications.framework

Rev

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

Rev 356 Rev 364
1 
<?php
 1 
<?php
2 
// declare(encoding='UTF-8');
 2 
// declare(encoding='UTF-8');
3 
/**
 3 
/**
4 
 * Classe Controleur, coeur d'une application, c'est normalement la seule classe d'une application
 4 
 * Classe Controleur, coeur d'une application, c'est normalement la seule classe d'une application
5 
 * qui devrait être appelée de l'extérieur.
 5 
 * qui devrait être appelée de l'extérieur.
6 
 * Elle est abstraite donc doit obligatoirement être étendue.
 6 
 * Elle est abstraite donc doit obligatoirement être étendue.
7 
 *
 7 
 *
8 
 * @category	php 5.2
 8 
 * @category	php 5.2
9 
 * @package	Framework
 9 
 * @package	Framework
10 
 * @author		Aurélien PERONNET <aurelien@tela-botanica.org>
 10 
 * @author		Aurélien PERONNET <aurelien@tela-botanica.org>
11 
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
 11 
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
12 
 * @copyright	Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org)
 12 
 * @copyright	Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org)
13 
 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
 13 
 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
14 
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
 14 
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
15 
 * @version	$Id: Controleur.php 356 2011-08-16 13:50:49Z jpm $
 15 
 * @version	$Id: Controleur.php 364 2011-09-27 15:24:36Z jpm $
16 
 * @link		/doc/framework/
 16 
 * @link		/doc/framework/
17 
 *
 17 
 *
18 
 */
 18 
 */
19 
abstract class Controleur {
 19 
abstract class Controleur {
20 
	/** Variable statique indiquant que les tableaux _GET et _POST ont déjà été encodé au format de l'appli. */
 20 
	/** Variable statique indiquant que les tableaux _GET et _POST ont déjà été encodé au format de l'appli. */
21 
	private static $encodage = false;
 21 
	private static $encodage = false;
22 
 
 22 
 
23 
	/** Chemin de base vers les classes métiers de la partie Modèle de l'application. */
 23 
	/** Chemin de base vers les classes métiers de la partie Modèle de l'application. */
24 
	private $base_chemin_modele = null;
 24 
	private $base_chemin_modele = null;
25
25
26 
	/** Chemin de base vers les fichiers squelette de la partie Vue de l'application. */
 26 
	/** Chemin de base vers les fichiers squelette de la partie Vue de l'application. */
27 
	private $base_chemin_squelette = null;
 27 
	private $base_chemin_squelette = null;
28
28
29 
	/** Chemin de base vers les classes controleurs de la partie Controleur de l'application. */
 29 
	/** Chemin de base vers les classes controleurs de la partie Controleur de l'application. */
30 
	private $base_chemin_controleur = null;
 30 
	private $base_chemin_controleur = null;
31
31
32 
	/** Objet URL contant l'url de la base de l'application. */
 32 
	/** Objet URL contant l'url de la base de l'application. */
33 
	private $base_url_applicaton = null;
 33 
	private $base_url_applicaton = null;
34 
 
 34 
 
35 
	/** Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.*/
 35 
	/** Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.*/
36 
	protected $parametres_obligatoires = array('chemin_modeles', 'chemin_squelettes', 'chemin_controleurs', 'base_url_application');
 36 
	protected $parametres_obligatoires = array('chemin_modeles', 'chemin_squelettes', 'chemin_controleurs', 'base_url_application');
37
37
38 
	/**
 38 
	/**
39 
	 * Constructeur par défaut
 39 
	 * Constructeur par défaut
40 
	 */
 40 
	 */
41 
	public function __construct() {
 41 
	public function __construct() {
42 
		Config::verifierPresenceParametres($this->parametres_obligatoires);
 42 
		Config::verifierPresenceParametres($this->parametres_obligatoires);
43
43
44 
		$this->base_chemin_modele = Config::get('chemin_modeles');
 44 
		$this->base_chemin_modele = Config::get('chemin_modeles');
45 
		if (Registre::existe('tbf.chemin_modeles')) {
 45 
		if (Registre::existe('tbf.chemin_modeles')) {
46 
			$this->base_chemin_modele = Registre::get('tbf.chemin_modeles');
 46 
			$this->base_chemin_modele = Registre::get('tbf.chemin_modeles');
47 
		}
 47 
		}
48
48
49 
		$this->base_chemin_squelette = Config::get('chemin_squelettes');
 49 
		$this->base_chemin_squelette = Config::get('chemin_squelettes');
50 
		if (Registre::existe('tbf.chemin_squelettes')) {
 50 
		if (Registre::existe('tbf.chemin_squelettes')) {
51 
			$this->base_chemin_squelette = Registre::get('tbf.chemin_squelettes');
51 
			$this->base_chemin_squelette = Registre::get('tbf.chemin_squelettes');
52 
		}
 52 
		}
53
53
54 
		$this->base_chemin_controleur = Config::get('chemin_controleurs');
 54 
		$this->base_chemin_controleur = Config::get('chemin_controleurs');
55 
		if (Registre::existe('tbf.chemin_controleurs')) {
 55 
		if (Registre::existe('tbf.chemin_controleurs')) {
56 
			$this->base_chemin_squelette = Registre::get('tbf.chemin_controleurs');
56 
			$this->base_chemin_squelette = Registre::get('tbf.chemin_controleurs');
57 
		}
 57 
		}
58
58
59 
		$this->base_url_application = new Url(Config::get('base_url_application'));
 59 
		$this->base_url_application = new Url(Config::get('base_url_application'));
60 
	}
 60 
	}
- 
 
 61
- 
 
 62 
	/**
- 
 
 63 
	 * Permet de récupérer le chemin vers les squelettes.
- 
 
 64 
	 *
- 
 
 65 
	 * @return String $chemin chemin vers les squelettes
- 
 
 66 
	 */
- 
 
 67 
	protected function getCheminSquelette() {
- 
 
 68 
		return $this->base_chemin_squelette;
- 
 
 69 
	}
61 
 
 70 
 
- 
 
 71 
	/**
- 
 
 72 
	 * Permet de définir dynamiquement le chemin vers les squelettes.
- 
 
 73 
	 *
- 
 
 74 
	 * @param String $chemin chemin vers les squelettes
- 
 
 75 
	 */
- 
 
 76 
	protected function setCheminSquelette($chemin) {
- 
 
 77 
		$this->base_chemin_squelette = $chemin;
- 
 
 78 
	}
- 
 
 79
62 
	/**
 80 
	/**
63 
	* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
 81 
	* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
64 
	*
 82 
	*
65 
	* @param string $nom_modele le nom du modèle à  charger
 83 
	* @param string $nom_modele le nom du modèle à  charger
66 
	*
 84 
	*
67 
	* @return boolean false si le chargement a échoué, sinon true.
 85 
	* @return boolean false si le chargement a échoué, sinon true.
68 
	*/
 86 
	*/
69 
	final public function chargerModele($nom_modele) {
 87 
	final public function chargerModele($nom_modele) {
70 
		$sortie = true;
 88 
		$sortie = true;
71 
		if (!isset($this->$nom_modele)) {
 89 
		if (!isset($this->$nom_modele)) {
72 
			$modele = $this->getModele($nom_modele);
 90 
			$modele = $this->getModele($nom_modele);
73 
			if ($modele !== false) {
 91 
			if ($modele !== false) {
74 
				$this->$nom_modele = new $nom_modele;
 92 
				$this->$nom_modele = new $nom_modele;
75 
			} else {
 93 
			} else {
76 
				$sortie = false;
 94 
				$sortie = false;
77 
			}
 95 
			}
78 
		}
 96 
		}
79 
		return $sortie;
 97 
		return $sortie;
80 
	}
 98 
	}
81 
 
 99 
 
82 
	/**
 100 
	/**
83 
	* Retourne un modele donné
 101 
	* Retourne un modele donné
84 
	*
 102 
	*
85 
	* @param string $nom_modele	le nom du fichier modèle à charger sans son extension
 103 
	* @param string $nom_modele	le nom du fichier modèle à charger sans son extension
86 
	* @param String $ext		l'extension du fichier du modèle (par défaut : ".php")
 104 
	* @param String $ext		l'extension du fichier du modèle (par défaut : ".php")
87 
	*
 105 
	*
88 
	* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
 106 
	* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
89 
	*/
 107 
	*/
90 
	final protected function getModele($nom_modele, $ext = '.php') {
 108 
	final protected function getModele($nom_modele, $ext = '.php') {
91 
		$sortie = false;
 109 
		$sortie = false;
92
110
93 
		$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.$ext;
 111 
		$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.$ext;
94 
		if (file_exists($chemin_modele)) {
 112 
		if (file_exists($chemin_modele)) {
95 
			include_once $chemin_modele;
 113 
			include_once $chemin_modele;
96 
			if (class_exists($nom_modele)) {
 114 
			if (class_exists($nom_modele)) {
97 
				$sortie = new $nom_modele;
 115 
				$sortie = new $nom_modele;
98 
			}
 116 
			}
99 
		}
 117 
		}
100 
		return $sortie;
 118 
		return $sortie;
101 
	}
 119 
	}
102 
 
 120 
 
103 
	/**
 121 
	/**
104 
	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
 122 
	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
105 
	 * en extrait les variables, charge le squelette et retourne le résultat des deux combinés.
 123 
	 * en extrait les variables, charge le squelette et retourne le résultat des deux combinés.
106 
	 *
 124 
	 *
107 
	 * @param String $nom_squelette	le nom du squelette sans son extension
 125 
	 * @param String $nom_squelette	le nom du squelette sans son extension
108 
	 * @param Array  $donnees			un tableau associatif contenant les variables a injecter dans la vue
 126 
	 * @param Array  $donnees			un tableau associatif contenant les variables a injecter dans la vue
109 
	 * @param String $ext				l'extension du fichier du squelette (par défaut : ".tpl.html"
 127 
	 * @param String $ext				l'extension du fichier du squelette (par défaut : ".tpl.html"
110 
	 *
 128 
	 *
111 
	 * @return boolean false si la vue n'existe pas, sinon la chaine résultat.
 129 
	 * @return boolean false si la vue n'existe pas, sinon la chaine résultat.
112 
	 */
 130 
	 */
113 
	final protected function getVue($nom_squelette, &$donnees = array(), $ext = '.tpl.html') {
 131 
	final protected function getVue($nom_squelette, &$donnees = array(), $ext = '.tpl.html') {
114 
		$donnees = $this->preTraiterDonnees($donnees);
 132 
		$donnees = $this->preTraiterDonnees($donnees);
115
133
116 
		$chemin_squelette = $this->base_chemin_squelette.$nom_squelette.$ext;
 134 
		$chemin_squelette = $this->base_chemin_squelette.$nom_squelette.$ext;
117 
		$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
 135 
		$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
118 
 
 136 
 
119 
		return $sortie;
 137 
		return $sortie;
120 
	}
 138 
	}
121 
 
 139 
 
122 
	/**
 140 
	/**
123 
	 * Fonction prenant en paramètre un tableau de données et effectuant un traitement dessus.
 141 
	 * Fonction prenant en paramètre un tableau de données et effectuant un traitement dessus.
124 
	 * Cette fonction est à surcharger dans les classes filles pour automatiser un traitement
 142 
	 * Cette fonction est à surcharger dans les classes filles pour automatiser un traitement
125 
	 * avant chaque chargement de vue.
 143 
	 * avant chaque chargement de vue.
126 
	 *
 144 
	 *
127 
	 * @param Array $donnees Le tableau de données à traiter
 145 
	 * @param Array $donnees Le tableau de données à traiter
128 
	 *
 146 
	 *
129 
	 * @return Array $donnees Le tableau de données traité
 147 
	 * @return Array $donnees Le tableau de données traité
130 
	 */
 148 
	 */
131 
	protected function preTraiterDonnees(&$donnees) {
 149 
	protected function preTraiterDonnees(&$donnees) {
132 
		return $donnees;
 150 
		return $donnees;
133 
	}
 151 
	}
134 
}
 152 
}
135 
?>
 153 
?>