WebSVN – eFlore/Applications.eflore-consultation – Diff – /trunk/controleurs/AppControleur.php


<?php
// declare(encoding='UTF-8');
/**
 * AppControleur est le controlleur principal de l'application.
 * Elle repartie les demandes utilisateurs dans les différents modules, executent les actions et redistribue le code
 * html dans les différentes fonctions d'affichage.
 * C'est une Singleton.
 *
 * @category	PHP 5.2
 * @package		eflore-consultation
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @author		Delphine CAUQUIL <delphine@tela-botanica.org>
 * @copyright	2011 Tela-Botanica
 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
 * @version		$Id$
 */
 
class AppControleur extends Controleur {
	
	/**
	 * Instance de la classe pointant sur elle même (pour le pattern singleton)
	 */
	private static $instance = null;
	
	/**
	 * Paramètres pour les collections
	 */
	private static $parametres = array();
	
	/**
	 * Constructeur vide
	 */
	public function __construct() {
		$sortie = array('titre' => '', 'description' => '', 'tags' => '',
			'corps' => '', 'tete' => '', 'pied' => '',
			'navigation' => '', 'menu' => '');
		$url = new Url(Config::get('url_base_index'));
		self::$parametres = array(
			'module' => Config::get('module_defaut'), 
			'action' => Config::get('action_defaut'),
			'sortie' => $sortie,
			'url' => $url);
		parent::__construct();
	}
	
	/**
	 * Initialisation du controleur principal en fonction des paramêtres de l'url.
	 */
	public static function initialiser() {
		self::verifierCreationInstance();
		self::gererSession();
				
		if (isset($_GET['module'])) {
			self::$parametres['module'] = $_GET['module'];
		}
		if (isset($_GET['action'])) {
			self::$parametres['action'] = $_GET['action'];
		}
		self::$parametres['url']->setRequete(array('action' => self::$parametres['action'], 'module' => self::$parametres['module']));
				
		Registre::set('parametres', &self::$parametres);
		
		$ClasseModule = self::$parametres['module'];
		$action = self::$parametres['action'];
		// Nous vérifions que le module existe
		if (class_exists($ClasseModule)) {
			$module = new $ClasseModule();
			$module->$action();
			self::fusionnerSortie($module->getSortie());
		} else {
			trigger_error("La classe du controleur '$ClasseModule' est introuvable.");
		}
	}
	
	private static function gererSession() {
		if (Config::get('session_demarrage')) {
			// Attribution d'un nom à la session
			session_name(Config::get('session_nom'));
			// Démarrage de la session
			session_start();
		}
	}
	
	/**
	 * Fusionne un tableau de sortie par défaut avec le tableau renvoyé par l'action du module.
	 * @param array le tableau à fusionner
	 */
	private static function fusionnerSortie($sortie) {
		self::$parametres['sortie'] = array_merge(self::$parametres['sortie'], $sortie);
	}
	
	
	/**
	 * Vérifie si l'instance de classe à été crée, si non la crée.
	 */
	private static function verifierCreationInstance() {
		if (empty(self::$instance)) {
			self::$instance = new AppControleur();
		}
	}
	
	/**
	 * Retourne le titre du contenu de l'application. 
	 */
	public static function getMetaTitre() {
		$contenu = self::$parametres['sortie']['titre'];
		$sortie = self::convertirEncodage($contenu);
		return $sortie;
	}
	
	/**
	 * Retourne la description du contenu de l'application. 
	 */
	public static function getMetaDescription() {
		$contenu = self::$parametres['sortie']['description'];
		$sortie = self::convertirEncodage($contenu);
		return $sortie;
	}
	
	/**
	 * Retourne les mots-clés (tags) du contenu de l'application. 
	 */
	public static function getMetaTags() {
		$contenu = self::$parametres['sortie']['tags'];
		$sortie = self::convertirEncodage($contenu);
		return $sortie;
	}
	
	/**
	 * Retourne le contenu du corps de l'application. 
	 */
	public static function getContenuCorps() {
		$contenu = self::$parametres['sortie']['corps'];
		$sortie = self::convertirEncodage($contenu);
		return $sortie;
	}
	
	/**
	 * Retourne le contenu de la tête de l'application. 
	 */
	public static function getContenuTete() {
		$contenu = self::$parametres['sortie']['tete'];
		$sortie = self::convertirEncodage($contenu);
		return $sortie;
	}
	
	/**
	 * Retourne le contenu du pied de l'application. 
	 */
	public static function getContenuPied() {
		$contenu = self::$parametres['sortie']['pied'];
		$sortie = self::convertirEncodage($contenu);
		return $sortie;
	}
	
	/**
	 * Retourne les éléments de navigation (onglet, fils d'ariane) de l'application. 
	 */
	public static function getContenuNavigation() {
		$contenu = self::$parametres['sortie']['navigation'];
		$sortie = self::convertirEncodage($contenu);
		return $sortie;
	}
	
	/**
	 * Retourne les éléments du menu de l'application. 
	 */
	public static function getContenuMenu() {
		$contenu = self::$parametres['sortie']['menu'];
		$sortie = self::convertirEncodage($contenu);
		return $sortie;
	}
	
	/**
	 * Retourne les chronos pris dans l'appli 
	 */
	public static function getChrono() {
		$sortie = '';
		if (Config::get('benchmark_chrono')) {
			$chrono = Chronometre::afficherChrono();
			$sortie = self::convertirEncodage($chrono);
		}
		return $sortie;
	}
	
	/**
	 * Retourne les messages d'exceptions et d'erreurs. 
	 */
	public static function getExceptions() {
		$contenu = (Config::get('debogage')) ? GestionnaireException::getExceptions() : '';
		$sortie = self::convertirEncodage($contenu);
		return $sortie;
	}
	
	/**
	 * Convertion du contenu de l'application (voir fichier config.ini : appli_encodage), 
	 * dans le format de sortie désiré (voir fichier config.ini : sortie_encodage).
	 * Cette convertion a lieu seulement si les formats sont différents.
	 */
	private static function convertirEncodage($contenu) {
		if (Config::get('sortie_encodage') != Config::get('appli_encodage')) {
			$contenu = mb_convert_encoding($contenu, Config::get('sortie_encodage'), Config::get('appli_encodage'));
		}
		return $contenu;
	}
}
?>

Subversion Repositories eFlore/Applications.eflore-consultation

(root)/trunk/controleurs/AppControleur.php – Rev 14 → 16

Rev 14		Rev 16
1	`<?php`	1	`<?php`
2	`// declare(encoding='UTF-8');`	2	`// declare(encoding='UTF-8');`
3	`/**`	3	`/**`
4	`* AppControleur est le controlleur principal de l'application.`	4	`* AppControleur est le controlleur principal de l'application.`
5	`* Elle repartie les demandes utilisateurs dans les différents modules, executent les actions et redistribue le code`	5	`* Elle repartie les demandes utilisateurs dans les différents modules, executent les actions et redistribue le code`
6	`* html dans les différentes fonctions d'affichage.`	6	`* html dans les différentes fonctions d'affichage.`
7	`* C'est une Singleton.`	7	`* C'est une Singleton.`
8	`*`	8	`*`
9	`* @category PHP 5.2`	9	`* @category PHP 5.2`
10	`* @package eflore-consultation`	10	`* @package eflore-consultation`
11	`* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>`	11	`* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>`
12	`* @author Delphine CAUQUIL <delphine@tela-botanica.org>`	12	`* @author Delphine CAUQUIL <delphine@tela-botanica.org>`
13	`* @copyright 2011 Tela-Botanica`	13	`* @copyright 2011 Tela-Botanica`
14	`* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3`	14	`* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3`
15	`* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2`	15	`* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2`
16	`* @version $Id$`	16	`* @version $Id$`
17	`*/`	17	`*/`
18		18
19	`class AppControleur extends Controleur {`	19	`class AppControleur extends Controleur {`
20		20
21	`/**`	21	`/**`
22	`* Instance de la classe pointant sur elle même (pour le pattern singleton)`	22	`* Instance de la classe pointant sur elle même (pour le pattern singleton)`
23	`*/`	23	`*/`
24	`private static $instance = null;`	24	`private static $instance = null;`
25		25
26	`/**`	26	`/**`
27	`* Paramètres pour les collections`	27	`* Paramètres pour les collections`
28	`*/`	28	`*/`
29	`private static $parametres = array();`	29	`private static $parametres = array();`
30		30
31	`/**`	31	`/**`
32	`* Constructeur vide`	32	`* Constructeur vide`
33	`*/`	33	`*/`
34	`public function __construct() {`	34	`public function __construct() {`
35	`$sortie = array('titre' => '', 'description' => '', 'tags' => '',`	35	`$sortie = array('titre' => '', 'description' => '', 'tags' => '',`
36	`'corps' => '', 'tete' => '', 'pied' => '', 'navigation' => '', 'menu' => '');`	36	`'corps' => '', 'tete' => '', 'pied' => '',`
-		37	`'navigation' => '', 'menu' => '');`
37	`$url = new Url(Config::get('url_base_index'));`	38	`$url = new Url(Config::get('url_base_index'));`
38	`self::$parametres = array(`	39	`self::$parametres = array(`
39	`'module' => Config::get('module_defaut'),`	40	`'module' => Config::get('module_defaut'),`
40	`'action' => Config::get('action_defaut'),`	41	`'action' => Config::get('action_defaut'),`
41	`'sortie' => $sortie,`	42	`'sortie' => $sortie,`
42	`'url' => $url);`	43	`'url' => $url);`
43	`parent::__construct();`	44	`parent::__construct();`
44	`}`	45	`}`
45		46
46	`/**`	47	`/**`
47	`* Initialisation du controleur principal en fonction des paramêtres de l'url.`	48	`* Initialisation du controleur principal en fonction des paramêtres de l'url.`
48	`*/`	49	`*/`
49	`public static function initialiser() {`	50	`public static function initialiser() {`
50	`self::verifierCreationInstance();`	51	`self::verifierCreationInstance();`
51	`self::gererSession();`	52	`self::gererSession();`
52		53
53	`if (isset($_GET['module'])) {`	54	`if (isset($_GET['module'])) {`
54	`self::$parametres['module'] = $_GET['module'];`	55	`self::$parametres['module'] = $_GET['module'];`
55	`}`	56	`}`
56	`if (isset($_GET['action'])) {`	57	`if (isset($_GET['action'])) {`
57	`self::$parametres['action'] = $_GET['action'];`	58	`self::$parametres['action'] = $_GET['action'];`
58	`}`	59	`}`
59	`self::$parametres['url']->setRequete(array('action' => self::$parametres['action'], 'module' => self::$parametres['module']));`	60	`self::$parametres['url']->setRequete(array('action' => self::$parametres['action'], 'module' => self::$parametres['module']));`
60		61
61	`Registre::set('parametres', &self::$parametres);`	62	`Registre::set('parametres', &self::$parametres);`
62		63
63	`$ClasseModule = self::$parametres['module'];`	64	`$ClasseModule = self::$parametres['module'];`
64	`$action = self::$parametres['action'];`	65	`$action = self::$parametres['action'];`
-		66	`// Nous vérifions que le module existe`
-		67	`if (class_exists($ClasseModule)) {`
65	`$module = new $ClasseModule();`	68	`$module = new $ClasseModule();`
66	`$module->$action();`	69	`$module->$action();`
67	`self::fusionnerSortie($module->getSortie());`	70	`self::fusionnerSortie($module->getSortie());`
-		71	`} else {`
-		72	`trigger_error("La classe du controleur '$ClasseModule' est introuvable.");`
-		73	`}`
68	`}`	74	`}`
69		75
70	`private static function gererSession() {`	76	`private static function gererSession() {`
71	`if (Config::get('session_demarrage')) {`	77	`if (Config::get('session_demarrage')) {`
72	`// Attribution d'un nom à la session`	78	`// Attribution d'un nom à la session`
73	`session_name(Config::get('session_nom'));`	79	`session_name(Config::get('session_nom'));`
74	`// Démarrage de la session`	80	`// Démarrage de la session`
75	`session_start();`	81	`session_start();`
76	`}`	82	`}`
77	`}`	83	`}`
78		84
79	`/**`	85	`/**`
80	`* Fusionne un tableau de sortie par défaut avec le tableau renvoyé par l'action du module.`	86	`* Fusionne un tableau de sortie par défaut avec le tableau renvoyé par l'action du module.`
81	`* @param array le tableau à fusionner`	87	`* @param array le tableau à fusionner`
82	`*/`	88	`*/`
83	`private static function fusionnerSortie($sortie) {`	89	`private static function fusionnerSortie($sortie) {`
84	`self::$parametres['sortie'] = array_merge(self::$parametres['sortie'], $sortie);`	90	`self::$parametres['sortie'] = array_merge(self::$parametres['sortie'], $sortie);`
85	`}`	91	`}`
86		92
87		93
88	`/**`	94	`/**`
89	`* Vérifie si l'instance de classe à été crée, si non la crée.`	95	`* Vérifie si l'instance de classe à été crée, si non la crée.`
90	`*/`	96	`*/`
91	`private static function verifierCreationInstance() {`	97	`private static function verifierCreationInstance() {`
92	`if (empty(self::$instance)) {`	98	`if (empty(self::$instance)) {`
93	`self::$instance = new AppControleur();`	99	`self::$instance = new AppControleur();`
94	`}`	100	`}`
95	`}`	101	`}`
96		102
97	`/**`	103	`/**`
98	`* Retourne le titre du contenu de l'application.`	104	`* Retourne le titre du contenu de l'application.`
99	`*/`	105	`*/`
100	`public static function getMetaTitre() {`	106	`public static function getMetaTitre() {`
101	`$contenu = self::$parametres['sortie']['titre'];`	107	`$contenu = self::$parametres['sortie']['titre'];`
102	`$sortie = self::convertirEncodage($contenu);`	108	`$sortie = self::convertirEncodage($contenu);`
103	`return $sortie;`	109	`return $sortie;`
104	`}`	110	`}`
105		111
106	`/**`	112	`/**`
107	`* Retourne la description du contenu de l'application.`	113	`* Retourne la description du contenu de l'application.`
108	`*/`	114	`*/`
109	`public static function getMetaDescription() {`	115	`public static function getMetaDescription() {`
110	`$contenu = self::$parametres['sortie']['description'];`	116	`$contenu = self::$parametres['sortie']['description'];`
111	`$sortie = self::convertirEncodage($contenu);`	117	`$sortie = self::convertirEncodage($contenu);`
112	`return $sortie;`	118	`return $sortie;`
113	`}`	119	`}`
114		120
115	`/**`	121	`/**`
116	`* Retourne les mots-clés (tags) du contenu de l'application.`	122	`* Retourne les mots-clés (tags) du contenu de l'application.`
117	`*/`	123	`*/`
118	`public static function getMetaTags() {`	124	`public static function getMetaTags() {`
119	`$contenu = self::$parametres['sortie']['tags'];`	125	`$contenu = self::$parametres['sortie']['tags'];`
120	`$sortie = self::convertirEncodage($contenu);`	126	`$sortie = self::convertirEncodage($contenu);`
121	`return $sortie;`	127	`return $sortie;`
122	`}`	128	`}`
123		129
124	`/**`	130	`/**`
125	`* Retourne le contenu du corps de l'application.`	131	`* Retourne le contenu du corps de l'application.`
126	`*/`	132	`*/`
127	`public static function getContenuCorps() {`	133	`public static function getContenuCorps() {`
128	`$contenu = self::$parametres['sortie']['corps'];`	134	`$contenu = self::$parametres['sortie']['corps'];`
129	`$sortie = self::convertirEncodage($contenu);`	135	`$sortie = self::convertirEncodage($contenu);`
130	`return $sortie;`	136	`return $sortie;`
131	`}`	137	`}`
132		138
133	`/**`	139	`/**`
134	`* Retourne le contenu de la tête de l'application.`	140	`* Retourne le contenu de la tête de l'application.`
135	`*/`	141	`*/`
136	`public static function getContenuTete() {`	142	`public static function getContenuTete() {`
137	`$contenu = self::$parametres['sortie']['tete'];`	143	`$contenu = self::$parametres['sortie']['tete'];`
138	`$sortie = self::convertirEncodage($contenu);`	144	`$sortie = self::convertirEncodage($contenu);`
139	`return $sortie;`	145	`return $sortie;`
140	`}`	146	`}`
141		147
142	`/**`	148	`/**`
143	`* Retourne le contenu du pied de l'application.`	149	`* Retourne le contenu du pied de l'application.`
144	`*/`	150	`*/`
145	`public static function getContenuPied() {`	151	`public static function getContenuPied() {`
146	`$contenu = self::$parametres['sortie']['pied'];`	152	`$contenu = self::$parametres['sortie']['pied'];`
147	`$sortie = self::convertirEncodage($contenu);`	153	`$sortie = self::convertirEncodage($contenu);`
148	`return $sortie;`	154	`return $sortie;`
149	`}`	155	`}`
150		156
151	`/**`	157	`/**`
152	`* Retourne les éléments de navigation (onglet, fils d'ariane) de l'application.`	158	`* Retourne les éléments de navigation (onglet, fils d'ariane) de l'application.`
153	`*/`	159	`*/`
154	`public static function getContenuNavigation() {`	160	`public static function getContenuNavigation() {`
155	`$contenu = self::$parametres['sortie']['navigation'];`	161	`$contenu = self::$parametres['sortie']['navigation'];`
156	`$sortie = self::convertirEncodage($contenu);`	162	`$sortie = self::convertirEncodage($contenu);`
157	`return $sortie;`	163	`return $sortie;`
158	`}`	164	`}`
159		165
160	`/**`	166	`/**`
161	`* Retourne les éléments du menu de l'application.`	167	`* Retourne les éléments du menu de l'application.`
162	`*/`	168	`*/`
163	`public static function getContenuMenu() {`	169	`public static function getContenuMenu() {`
164	`$contenu = self::$parametres['sortie']['menu'];`	170	`$contenu = self::$parametres['sortie']['menu'];`
165	`$sortie = self::convertirEncodage($contenu);`	171	`$sortie = self::convertirEncodage($contenu);`
166	`return $sortie;`	172	`return $sortie;`
167	`}`	173	`}`
168		174
169	`/**`	175	`/**`
170	`* Retourne les chronos pris dans l'appli`	176	`* Retourne les chronos pris dans l'appli`
171	`*/`	177	`*/`
172	`public static function getChrono() {`	178	`public static function getChrono() {`
173	`$sortie = '';`	179	`$sortie = '';`
174	`if (Config::get('benchmark_chrono')) {`	180	`if (Config::get('benchmark_chrono')) {`
175	`$chrono = Chronometre::afficherChrono();`	181	`$chrono = Chronometre::afficherChrono();`
176	`$sortie = self::convertirEncodage($chrono);`	182	`$sortie = self::convertirEncodage($chrono);`
177	`}`	183	`}`
178	`return $sortie;`	184	`return $sortie;`
179	`}`	185	`}`
180		186
181	`/**`	187	`/**`
182	`* Retourne les messages d'exceptions et d'erreurs.`	188	`* Retourne les messages d'exceptions et d'erreurs.`
183	`*/`	189	`*/`
184	`public static function getExceptions() {`	190	`public static function getExceptions() {`
185	`$contenu = (Config::get('debogage')) ? GestionnaireException::getExceptions() : '';`	191	`$contenu = (Config::get('debogage')) ? GestionnaireException::getExceptions() : '';`
186	`$sortie = self::convertirEncodage($contenu);`	192	`$sortie = self::convertirEncodage($contenu);`
187	`return $sortie;`	193	`return $sortie;`
188	`}`	194	`}`
189		195
190	`/**`	196	`/**`
191	`* Convertion du contenu de l'application (voir fichier config.ini : appli_encodage),`	197	`* Convertion du contenu de l'application (voir fichier config.ini : appli_encodage),`
192	`* dans le format de sortie désiré (voir fichier config.ini : sortie_encodage).`	198	`* dans le format de sortie désiré (voir fichier config.ini : sortie_encodage).`
193	`* Cette convertion a lieu seulement si les formats sont différents.`	199	`* Cette convertion a lieu seulement si les formats sont différents.`
194	`*/`	200	`*/`
195	`private static function convertirEncodage($contenu) {`	201	`private static function convertirEncodage($contenu) {`
196	`if (Config::get('sortie_encodage') != Config::get('appli_encodage')) {`	202	`if (Config::get('sortie_encodage') != Config::get('appli_encodage')) {`
197	`$contenu = mb_convert_encoding($contenu, Config::get('sortie_encodage'), Config::get('appli_encodage'));`	203	`$contenu = mb_convert_encoding($contenu, Config::get('sortie_encodage'), Config::get('appli_encodage'));`
198	`}`	204	`}`
199	`return $contenu;`	205	`return $contenu;`
200	`}`	206	`}`
201	`}`	207	`}`
202	`?>`	208	`?>`