Subversion Repositories Applications.framework

Rev

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

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