Subversion Repositories Applications.framework

Rev

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

Rev 166 Rev 168
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 166 2010-03-10 16:32:13Z aurelien $$
 15 
 * @version		SVN: $$Id: Controleur.php 168 2010-03-19 17:19:31Z jpm $$
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->verifierEtReencoderTableauRequete();
 38 
		$this->verifierEtReencoderTableauRequete();
39 
	}
 39 
	}
40 
 
 40 
 
41 
	/**
 41 
	/**
42 
	* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
 42 
	* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
43 
	*
 43 
	*
44 
	* @param string $nom_modele le nom du modèle à  charger
 44 
	* @param string $nom_modele le nom du modèle à  charger
45 
	*
 45 
	*
46 
	* @return boolean false si le chargement a échoué, sinon true.
 46 
	* @return boolean false si le chargement a échoué, sinon true.
47 
	*/
 47 
	*/
48 
	final protected function chargerModele($nom_modele) {
 48 
	final protected function chargerModele($nom_modele) {
49 
		$sortie = true;
 49 
		$sortie = true;
50 
		$modele = $this->getModele($nom_modele);
 50 
		$modele = $this->getModele($nom_modele);
51 
		if ($modele !== false) {
 51 
		if ($modele !== false) {
52 
			$this->$nom_modele = new $nom_modele;
 52 
			$this->$nom_modele = new $nom_modele;
53 
		} else {
 53 
		} else {
54 
			$sortie = false;
 54 
			$sortie = false;
55 
		}
 55 
		}
56 
		return $sortie;
 56 
		return $sortie;
57 
	}
 57 
	}
58 
 
 58 
 
59 
	/**
 59 
	/**
60 
	* Retourne un modele donné
 60 
	* Retourne un modele donné
61 
	*
 61 
	*
62 
	* @param string $nom_modele le nom du modèle à  charger
 62 
	* @param string $nom_modele le nom du modèle à  charger
63 
	*
 63 
	*
64 
	* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
 64 
	* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
65 
	*/
 65 
	*/
66 
	final protected function getModele($nom_modele) {
 66 
	final protected function getModele($nom_modele) {
67 
		$sortie = false;
 67 
		$sortie = false;
68 
		$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.'.php';
 68 
		$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.'.php';
69 
		if (file_exists($chemin_modele)) {
 69 
		if (file_exists($chemin_modele)) {
70 
			include_once $chemin_modele;
 70 
			include_once $chemin_modele;
71 
			if (class_exists($nom_modele)) {
 71 
			if (class_exists($nom_modele)) {
72 
				$sortie = new $nom_modele;
 72 
				$sortie = new $nom_modele;
73 
			}
 73 
			}
74 
		}
 74 
		}
75 
		return $sortie;
 75 
		return $sortie;
76 
	}
 76 
	}
77 
 
 77 
 
78 
	/**
 78 
	/**
79 
	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
 79 
	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
80 
	 * en extrait les variables, charge le squelette et retourne le résultat des deux combinés.
 80 
	 * en extrait les variables, charge le squelette et retourne le résultat des deux combinés.
81 
	 *
 81 
	 *
82 
	 * @param String $nom_squelette le nom du squelette
 82 
	 * @param String $nom_squelette le nom du squelette
83 
	 * @param Array  $donnees	   un tableau associatif contenant les variables a injecter dans la vue
 83 
	 * @param Array  $donnees	   un tableau associatif contenant les variables a injecter dans la vue
84 
	 *
 84 
	 *
85 
	 * @return boolean false si la vue n'existe pas, sinon la chaine résultat.
 85 
	 * @return boolean false si la vue n'existe pas, sinon la chaine résultat.
86 
	 */
 86 
	 */
87 
	final protected function getVue($nom_squelette, $donnees = array()) {
 87 
	final protected function getVue($nom_squelette, $donnees = array()) {
88 
		$chemin_squelette = ($this->registre->get('base_chemin_squelette')).$nom_squelette.'.tpl.html';
 88 
		$chemin_squelette = ($this->registre->get('base_chemin_squelette')).$nom_squelette.'.tpl.html';
89 
 
 89 
 
90 
		$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
 90 
		$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
91 
 
 91 
 
92 
		if (Config::get('sortie_encodage') != Config::get('appli_encodage')) {
 92 
		if (Config::get('sortie_encodage') != Config::get('appli_encodage')) {
93 
			$sortie = mb_convert_encoding($sortie,Config::get('sortie_encodage'),Config::get('appli_encodage'));
 93 
			$sortie = mb_convert_encoding($sortie,Config::get('sortie_encodage'),Config::get('appli_encodage'));
94 
		}
 94 
		}
95 
 
 95 
 
96 
		return $sortie;
 96 
		return $sortie;
97 
	}
 97 
	}
98 
 
 98 
 
99 
	/**
 99 
	/**
100 
	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
 100 
	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
101 
	 * en extrait les variables, charge le squelette et crée une variable de classe portant le nom du squelette
 101 
	 * en extrait les variables, charge le squelette et crée une variable de classe portant le nom du squelette
102 
	 * contenant les deux combinés.
 102 
	 * contenant les deux combinés.
103 
	 *
 103 
	 *
104 
	 * @param String $nom_squelette le nom du squelette
 104 
	 * @param String $nom_squelette le nom du squelette
105 
	 * @param Array  $donnees	   un tableau associatif contenant les variables a injecter dans la vue
 105 
	 * @param Array  $donnees	   un tableau associatif contenant les variables a injecter dans la vue
106 
	 *
 106 
	 *
107 
	 * @return boolean false si la vue n'existe pas, sinon true.
 107 
	 * @return boolean false si la vue n'existe pas, sinon true.
108 
	 */
 108 
	 */
109 
	final protected function chargerVue($nom_squelette, $donnees = array()) {
 109 
	final protected function chargerVue($nom_squelette, $donnees = array()) {
110 
		$sortie = false;
 110 
		$sortie = false;
111 
		$donnees = $this->preTraiterDonnees($donnees);
 111 
		$donnees = $this->preTraiterDonnees($donnees);
112 
		$rendu = $this->getVue($nom_squelette, $donnees);
 112 
		$rendu = $this->getVue($nom_squelette, $donnees);
113 
		if ($rendu !== false) {
 113 
		if ($rendu !== false) {
114 
			// Création d'une variable de classe contenant le rendu
 114 
			// Création d'une variable de classe contenant le rendu
115 
			$this->$nom_squelette = $rendu;
 115 
			$this->$nom_squelette = $rendu;
116 
			$sortie = true;
 116 
			$sortie = true;
117 
		}
 117 
		}
118 
		return $sortie;
 118 
		return $sortie;
119 
	}
 119 
	}
120 
 
 120 
 
121 
	/**
 121 
	/**
122 
	 * Fonction prenant en paramètre un tableau de données et effectuant un traitement dessus.
 122 
	 * Fonction prenant en paramètre un tableau de données et effectuant un traitement dessus.
123 
	 * Cette fonction est à surcharger dans les classes filles pour automatiser un traitement
 123 
	 * Cette fonction est à surcharger dans les classes filles pour automatiser un traitement
124 
	 * avant chaque chargement de vue.
 124 
	 * avant chaque chargement de vue.
125 
	 *
 125 
	 *
126 
	 * @param Array $donnees Le tableau de données à traiter
 126 
	 * @param Array $donnees Le tableau de données à traiter
127 
	 *
 127 
	 *
128 
	 * @return Array $donnees Le tableau de données traité
 128 
	 * @return Array $donnees Le tableau de données traité
129 
	 */
 129 
	 */
130 
	protected function preTraiterDonnees($donnees) {
 130 
	protected function preTraiterDonnees($donnees) {
131 
		return $donnees;
 131 
		return $donnees;
132 
	}
 132 
	}
133 
 
 133 
 
134 
	/**
 134 
	/**
135 
	 * Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
 135 
	 * Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
136 
	 */
 136 
	 */
137 
	protected function verifierEtReencoderTableauRequete() {
 137 
	protected function verifierEtReencoderTableauRequete() {
138 
		if(Config::get('sortie_encodage') != Config::get('appli_encodage')) {
 138 
		if (Config::get('sortie_encodage') != Config::get('appli_encodage')) {
139 
 
 - 
 
140 
			$_POST = $this->encoderTableau($_POST, Config::get('appli_encodage'),Config::get('sortie_encodage'));
 139 
			$_POST = $this->encoderTableau($_POST, Config::get('appli_encodage'), Config::get('sortie_encodage'));
141 
			$_GET = $this->encoderTableau($_GET, Config::get('appli_encodage'),Config::get('sortie_encodage'));
 140 
			$_GET = $this->encoderTableau($_GET, Config::get('appli_encodage'), Config::get('sortie_encodage'));
142 
 
 - 
 
143 
		}
 141 
		}
144 
	}
 142 
	}
145 
 
 143 
 
146 
	/**
 144 
	/**
147 
	 * Fonction récursive transcodant toutes les valeurs d'un tableau de leur encodage d'entrée vers un encodage de sortie donné
 145 
	 * Fonction récursive transcodant toutes les valeurs d'un tableau de leur encodage d'entrée vers un encodage de sortie donné
148 
	 * @param $tableau Array Un tableau de données à encoder
 146 
	 * @param $tableau Array Un tableau de données à encoder
149 
	 * @param $encodage_sortie String l'encodage vers lequel on doit transcoder
 147 
	 * @param $encodage_sortie String l'encodage vers lequel on doit transcoder
150 
	 * @param $encodage_entree String l'encodage original des chaines du tableau (optionnel)
 148 
	 * @param $encodage_entree String l'encodage original des chaines du tableau (optionnel)
151 
	 * @return Array Le tableau encodé dans l'encodage de sortie
 149 
	 * @return Array Le tableau encodé dans l'encodage de sortie
152 
	 *
 150 
	 *
153 
	 */
 151 
	 */
154 
	final protected function encoderTableau($tableau,$encodage_sortie,$encodage_entree = null) {
 152 
	final protected function encoderTableau($tableau, $encodage_sortie, $encodage_entree = null) {
155 
 
 - 
 
156 
		if (is_array($tableau)) {
 153 
		if (is_array($tableau)) {
157 
 
 - 
 
158 
			foreach ($tableau as $cle => $valeur) {
 154 
			foreach ($tableau as $cle => $valeur) {
159 
 
 - 
 
160 
				if (is_array($valeur)) {
 155 
				if (is_array($valeur)) {
161 
				 	$tableau[$cle] = $this->encoderTableau($tableau[$cle]);
 156 
				 	$tableau[$cle] = $this->encoderTableau($tableau[$cle]);
162 
				}
 - 
 
163 
				else {
 157 
				} else {
164 
					$tableau[$cle] = mb_convert_encoding($valeur,$encodage_sortie,$encodage_entree);
 158 
					$tableau[$cle] = mb_convert_encoding($valeur, $encodage_sortie, $encodage_entree);
165 
				}
 159 
				}
166 
			}
 160 
			}
167 
		}
 161 
		}
168 
 
 162 
 
169 
		return $tableau;
 163 
		return $tableau;
170 
	}
 164 
	}
171 
}
 165 
}
172 
?>
 166 
?>