Subversion Repositories Applications.framework

Rev

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

Rev 162 Rev 165
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	php5
 8 
 * @category	php5
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	2009 Tela-Botanica
 12 
 * @copyright	2009 Tela-Botanica
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		SVN: $$Id: Controleur.php 162 2010-03-05 09:05:37Z aurelien $$
 15 
 * @version		SVN: $$Id: Controleur.php 165 2010-03-05 10:51:55Z aurelien $$
16 
 * @link		/doc/framework/
 16 
 * @link		/doc/framework/
17 
 *
 17 
 *
18 
 */
 18 
 */
19 
abstract class Controleur {
 19 
abstract class Controleur {
20 
	/**
 20 
	/**
21 
	 * Registre global, normalement accessible partout
 21 
	 * Registre global, normalement accessible partout
22 
	 */
 22 
	 */
23 
	private $registre;
 23 
	private $registre;
24 
 
 24 
 
25 
	/**
 25 
	/**
26 
	 * Constructeur par défaut
 26 
	 * Constructeur par défaut
27 
	 */
 27 
	 */
28 
	public function __construct() {
 28 
	public function __construct() {
29 
		if (Config::existe('fw_html_errors')) {
 29 
		if (Config::existe('fw_html_errors')) {
30 
			ini_set('html_errors', Config::get('fw_html_errors'));
 30 
			ini_set('html_errors', Config::get('fw_html_errors'));
31 
		}
 31 
		}
32 
 
 32 
 
33 
		$this->registre = Registre::getInstance();
 33 
		$this->registre = Registre::getInstance();
34 
		$this->registre->set('base_chemin_modele', Config::get('chemin_modeles'));
 34 
		$this->registre->set('base_chemin_modele', Config::get('chemin_modeles'));
35 
		$this->registre->set('base_chemin_squelette', Config::get('chemin_squelettes'));
 35 
		$this->registre->set('base_chemin_squelette', Config::get('chemin_squelettes'));
36 
		$this->registre->set('base_chemin_controleur', Config::get('chemin_controleurs'));
 36 
		$this->registre->set('base_chemin_controleur', Config::get('chemin_controleurs'));
37 
		$this->registre->set('base_url_application', new Url(Config::get('url_base')));
 37 
		$this->registre->set('base_url_application', new Url(Config::get('url_base')));
38 
		$this->registre->set('sortie_encodage', new Url(Config::get('sortie_encodage')));
 - 
 
39 
		$this->registre->set('appli_encodage', new Url(Config::get('appli_encodage')));
 - 
 
40 
	}
 38 
	}
41 
 
 39 
 
42 
	/**
 40 
	/**
43 
	* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
 41 
	* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
44 
	*
 42 
	*
45 
	* @param string $nom_modele le nom du modèle à charger
 43 
	* @param string $nom_modele le nom du modèle à  charger
46 
	*
 44 
	*
47 
	* @return boolean false si le chargement a échoué, rien sinon
 45 
	* @return boolean false si le chargement a échoué, sinon true.
48 
	*/
 46 
	*/
49 
	final protected function chargerModele($nom_modele) {
 47 
	final protected function chargerModele($nom_modele) {
50 
 
 - 
 
- 
 
 48 
		$sortie = true;
51 
		$chemin_modele = ($this->registre->get('base_chemin_modele')).$nom_modele.'.php';
 49 
		$modele = $this->getModele($nom_modele);
52 
 
 - 
 
53 
		if (!file_exists($chemin_modele)) {
 50 
		if ($modele !== false) {
54 
			throw new Exception('Impossible de charger le fichier de modèle '.$chemin_modele);
 51 
			$this->$nom_modele = new $nom_modele;
- 
 
 52 
		} else {
55 
			return false;
 53 
			$sortie = false;
56 
		}
 54 
		}
- 
 
 55 
		return $sortie;
- 
 
 56 
	}
- 
 
 57 
 
57 
 
 58 
	/**
58 
		include_once $chemin_modele;
 59 
	* Retourne un modele donné
59 
 
 60 
	*
- 
 
 61 
	* @param string $nom_modele le nom du modèle à  charger
60 
		if (!class_exists($nom_modele)) {
 62 
	*
- 
 
 63 
	* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
- 
 
 64 
	*/
61 
			throw new Exception('Impossible de charger la classe '.$nom_modele.' dans le dossier '.$chemin_modele);
 65 
	final protected function getModele($nom_modele) {
- 
 
 66 
		$sortie = false;
- 
 
 67 
		$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.'.php';
- 
 
 68 
		if (file_exists($chemin_modele)) {
- 
 
 69 
			include_once $chemin_modele;
- 
 
 70 
			if (class_exists($nom_modele)) {
- 
 
 71 
				$sortie = new $nom_modele;
62 
			return false;
 72 
			}
63 
		}
 - 
 
64 
 
 73 
		}
65 
		$this->$nom_modele = new $nom_modele;
 74 
		return $sortie;
66 
	}
 75 
	}
67 
 
 76 
 
68 
	/**
 77 
	/**
69 
	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
 78 
	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
70 
	 * en extrait les variables, charge le squelette et retourne le résultat des deux combinés.
 79 
	 * en extrait les variables, charge le squelette et retourne le résultat des deux combinés.
71 
	 *
 80 
	 *
72 
	 * @param String $nom_squelette le nom du squelette
 81 
	 * @param String $nom_squelette le nom du squelette
73 
	 * @param Array  $donnees	   un tableau associatif contenant les variables a injecter dans la vue
 82 
	 * @param Array  $donnees	   un tableau associatif contenant les variables a injecter dans la vue
74 
	 *
 83 
	 *
75 
	 * @return boolean false si la vue n'existe pas, sinon la chaine résultat.
 84 
	 * @return boolean false si la vue n'existe pas, sinon la chaine résultat.
76 
	 */
 85 
	 */
77 
	final protected function getVue($nom_squelette, $donnees = array()) {
 86 
	final protected function getVue($nom_squelette, $donnees = array()) {
78 
 
 - 
 
79 
		$chemin_squelette = ($this->registre->get('base_chemin_squelette')).$nom_squelette.'.tpl.html';
 87 
		$chemin_squelette = ($this->registre->get('base_chemin_squelette')).$nom_squelette.'.tpl.html';
80 
		$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
 88 
		$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
81 
 
 89 
 
82 
		if($this->registre->get('sortie_encodage') != $this->registre->get('appli_encodage')) {
 90 
		if (Config::get('sortie_encodage') != Config::get('appli_encodage')) {
83 
			$sortie = mb_convert_encoding($sortie, $this->registre->get('sortie_encodage'), $this->registre->get('appli_encodage'));
 91 
			$sortie = mb_convert_encoding($sortie,Config::get('sortie_encodage'),Config::get('appli_encodage'));
84 
		}
 92 
		}
85 
 
 93 
 
86 
		return $sortie;
 94 
		return $sortie;
87 
	}
 95 
	}
88 
 
 96 
 
89 
	/**
 97 
	/**
90 
	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
 98 
	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
91 
	 * en extrait les variables, charge le squelette et crée une variable de classe portant le nom du squelette
 99 
	 * en extrait les variables, charge le squelette et crée une variable de classe portant le nom du squelette
92 
	 * contenant les deux combinés.
 100 
	 * contenant les deux combinés.
93 
	 *
 101 
	 *
94 
	 * @param String $nom_squelette le nom du squelette
 102 
	 * @param String $nom_squelette le nom du squelette
95 
	 * @param Array  $donnees	   un tableau associatif contenant les variables a injecter dans la vue
 103 
	 * @param Array  $donnees	   un tableau associatif contenant les variables a injecter dans la vue
96 
	 *
 104 
	 *
97 
	 * @return boolean false si la vue n'existe pas, sinon true.
 105 
	 * @return boolean false si la vue n'existe pas, sinon true.
98 
	 */
 106 
	 */
99 
	final protected function chargerVue($nom_squelette, $donnees = array()) {
 107 
	final protected function chargerVue($nom_squelette, $donnees = array()) {
100 
 
 - 
 
101 
		$donnees = $this->preTraiterDonnees($donnees);
 - 
 
102 
 
 - 
 
103 
		$sortie = false;
 108 
		$sortie = false;
- 
 
 109 
		$donnees = $this->preTraiterDonnees($donnees);
104 
		$rendu = $this->getVue($nom_squelette, $donnees);
 110 
		$rendu = $this->getVue($nom_squelette, $donnees);
105 
		if ($rendu !== false) {
 111 
		if ($rendu !== false) {
106 
			// Création d'une variable de classe contenant le rendu
 112 
			// Création d'une variable de classe contenant le rendu
107 
			$this->$nom_squelette = $rendu;
 113 
			$this->$nom_squelette = $rendu;
108 
			$sortie = true;
 114 
			$sortie = true;
109 
		}
 115 
		}
110 
		return $sortie;
 116 
		return $sortie;
111 
	}
 117 
	}
- 
 
 118 
 
- 
 
 119 
	/**
- 
 
 120 
	 * Fonction prenant en paramètre un talbeau de données et effectuant un traitement dessus.
- 
 
 121 
	 * Cette fonction est à surcharger dans les classes filles pour automatiser un traitement
- 
 
 122 
	 * avant chaque chargement de vue.
- 
 
 123 
	 *
- 
 
 124 
	 * @param Array $donnees Le tableau de données à traiter
- 
 
 125 
	 *
- 
 
 126 
	 * @return Array $donnees Le tableau de données traité
112 
 
 127 
	 */
113 
	public function preTraiterDonnees($donnees) {
 128 
	protected function preTraiterDonnees($donnees) {
114 
		return $donnees;
 129 
		return $donnees;
115 
	}
 130 
	}
116 
}
 131 
}
117 
?>
 132 
?>