6 |
jpm |
1 |
<?php
|
|
|
2 |
// declare(encoding='UTF-8');
|
|
|
3 |
/**
|
|
|
4 |
* Classe Controleur générale partagée par les différents modules de l'application.
|
|
|
5 |
*
|
|
|
6 |
* @package Referentiel
|
|
|
7 |
* @category Php5.2
|
|
|
8 |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
|
|
|
9 |
* @copyright 2010 Tela-Botanica
|
|
|
10 |
* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
|
|
|
11 |
* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
|
|
|
12 |
* @version SVN: $Id$
|
|
|
13 |
*/
|
|
|
14 |
abstract class AppliControleur extends Controleur {
|
|
|
15 |
|
|
|
16 |
const RENDU_TETE = 'tete';
|
|
|
17 |
const RENDU_CORPS = 'corps';
|
|
|
18 |
const RENDU_PIED = 'pied';
|
37 |
jpm |
19 |
const RENDU_NAVIGATION = 'navigation';
|
|
|
20 |
const RENDU_MENU = 'menu';
|
6 |
jpm |
21 |
|
|
|
22 |
// FIXME : voir s'il est plus intéressant d'utiliser une méthode dans les classes filles
|
|
|
23 |
protected $url = null;
|
26 |
jpm |
24 |
private $parametres = array();
|
|
|
25 |
private $sortie = array();
|
|
|
26 |
private $messages = null;
|
6 |
jpm |
27 |
|
26 |
jpm |
28 |
//+----------------------------------------------------------------------------------------------------------------+
|
|
|
29 |
// Constructeur
|
|
|
30 |
|
6 |
jpm |
31 |
public function __construct() {
|
|
|
32 |
$registre = Registre::getInstance();
|
|
|
33 |
$this->parametres = $registre->get('parametres');
|
|
|
34 |
$this->url = $this->parametres['url'];
|
|
|
35 |
parent::__construct();
|
|
|
36 |
}
|
|
|
37 |
|
26 |
jpm |
38 |
//+----------------------------------------------------------------------------------------------------------------+
|
|
|
39 |
// Accesseurs
|
|
|
40 |
|
6 |
jpm |
41 |
/**
|
26 |
jpm |
42 |
* Retourne le tableau de sortie à utiliser dans le controleur principal de l'application.
|
|
|
43 |
*/
|
|
|
44 |
public function getSortie() {
|
|
|
45 |
return $this->sortie;
|
|
|
46 |
}
|
|
|
47 |
|
|
|
48 |
/**
|
6 |
jpm |
49 |
* Attribue à la bonne position de sortie un contenu.
|
|
|
50 |
*/
|
|
|
51 |
protected function setSortie($position, $contenu, $fusionner = false) {
|
|
|
52 |
if ($this->verifierExistencePosition($position)) {
|
|
|
53 |
if ($fusionner) {
|
|
|
54 |
$this->sortie[$position] .= $contenu;
|
|
|
55 |
} else {
|
|
|
56 |
$this->sortie[$position] = $contenu;
|
|
|
57 |
}
|
|
|
58 |
}
|
|
|
59 |
}
|
|
|
60 |
|
|
|
61 |
/**
|
26 |
jpm |
62 |
* Retourne le tableau des messages
|
|
|
63 |
*/
|
|
|
64 |
protected function getMessages() {
|
|
|
65 |
return $this->messages;
|
|
|
66 |
}
|
|
|
67 |
/**
|
|
|
68 |
* Ajoute un message
|
|
|
69 |
*/
|
|
|
70 |
protected function addMessage($message) {
|
|
|
71 |
if ('' != $message) {
|
|
|
72 |
$this->messages[] = $message;
|
|
|
73 |
}
|
|
|
74 |
}
|
|
|
75 |
|
|
|
76 |
|
|
|
77 |
//+----------------------------------------------------------------------------------------------------------------+
|
|
|
78 |
// Méthodes
|
|
|
79 |
|
|
|
80 |
/**
|
6 |
jpm |
81 |
* Vérifie l'existence de la position indiquée pour son utilisation dans le tableau de sortie.
|
|
|
82 |
* @param string la position à tester.
|
|
|
83 |
* @return bool true si la position est valide, sinon false.
|
|
|
84 |
*/
|
|
|
85 |
private function verifierExistencePosition($position) {
|
|
|
86 |
$existe = true;
|
|
|
87 |
if ($position != self::RENDU_TETE &&
|
|
|
88 |
$position != self::RENDU_CORPS &&
|
37 |
jpm |
89 |
$position != self::RENDU_PIED &&
|
|
|
90 |
$position != self::RENDU_NAVIGATION &&
|
|
|
91 |
$position != self::RENDU_MENU) {
|
6 |
jpm |
92 |
trigger_error("La position '$position' n'est pas une valeur prédéfinie.", E_USER_WARNING);
|
|
|
93 |
$existe = false;
|
|
|
94 |
}
|
|
|
95 |
return $existe;
|
|
|
96 |
}
|
|
|
97 |
|
|
|
98 |
/**
|
|
|
99 |
* Execute l'action d'un module donnée et fusionne le résultat avec le tableau de sortie.
|
|
|
100 |
*/
|
|
|
101 |
protected function executerAction($ClasseModule, $action) {
|
|
|
102 |
$module = new $ClasseModule();
|
|
|
103 |
$module->$action();
|
|
|
104 |
$this->fusionnerSortie($module->getSortie());
|
|
|
105 |
|
|
|
106 |
}
|
|
|
107 |
|
|
|
108 |
/**
|
|
|
109 |
* Fusionne un tableau de sortie par défaut avec le tableau passé en paramêtre.
|
|
|
110 |
* @param array le tableau à fusionner
|
|
|
111 |
*/
|
|
|
112 |
private function fusionnerSortie($sortie) {
|
|
|
113 |
$this->sortie = array_merge($this->sortie, $sortie);
|
|
|
114 |
}
|
|
|
115 |
|
|
|
116 |
protected function postraiterDonnees(&$tableau) {
|
|
|
117 |
if (count($tableau) > 0) {
|
|
|
118 |
foreach ($tableau as $cle => &$valeur) {
|
|
|
119 |
if ($valeur == '') {
|
|
|
120 |
$valeur = ' ';
|
|
|
121 |
} else if (is_string($valeur)) {
|
33 |
jpm |
122 |
$valeur = $this->remplacerEsperluette($valeur);
|
6 |
jpm |
123 |
} else if (is_array($valeur)) {
|
|
|
124 |
$this->postraiterDonnees($valeur);
|
|
|
125 |
}
|
|
|
126 |
}
|
|
|
127 |
}
|
|
|
128 |
}
|
33 |
jpm |
129 |
|
|
|
130 |
protected function traiterEsperluette(&$tableau) {
|
|
|
131 |
if (count($tableau) > 0) {
|
|
|
132 |
foreach ($tableau as $cle => &$valeur) {
|
|
|
133 |
if (is_string($valeur)) {
|
|
|
134 |
$valeur = $this->remplacerEsperluette($valeur);
|
|
|
135 |
} else if (is_array($valeur)) {
|
|
|
136 |
$this->traiterEsperluette($valeur);
|
|
|
137 |
}
|
|
|
138 |
}
|
|
|
139 |
}
|
|
|
140 |
}
|
|
|
141 |
|
|
|
142 |
private function remplacerEsperluette($txt) {
|
|
|
143 |
$txt = preg_replace('/&(?!([a-z]+|#[0-9]+|#x[0-9a-f]+);)/i', '&', $txt, -1);
|
|
|
144 |
return $txt;
|
|
|
145 |
}
|
37 |
jpm |
146 |
/**
|
|
|
147 |
* Construction du menu et stockage dans le conteneur de sortie RENDU_MENU.
|
|
|
148 |
*
|
|
|
149 |
* @param string $referentiel code du référentiel.
|
|
|
150 |
*/
|
|
|
151 |
protected function construireMenu($referentiel) {
|
|
|
152 |
$menu['nom'] = 'Accueil';
|
|
|
153 |
$menu['url'] = $this->obtenirUrlMenuAccueil();
|
|
|
154 |
$donnees['menus'][] = $menu;
|
|
|
155 |
$menu['nom'] = 'Tests';
|
|
|
156 |
$menu['url'] = $this->obtenirUrlMenuTest($referentiel);
|
|
|
157 |
$donnees['menus'][] = $menu;
|
|
|
158 |
$menu['nom'] = 'Versionnage';
|
|
|
159 |
$menu['url'] = $this->obtenirUrlMenuVersionnage($referentiel);
|
|
|
160 |
$donnees['menus'][] = $menu;
|
|
|
161 |
$menu['nom'] = 'Consultation';
|
|
|
162 |
$menu['url'] = $this->obtenirUrlMenuConsultation($referentiel);
|
|
|
163 |
$donnees['menus'][] = $menu;
|
|
|
164 |
$this->setSortie(self::RENDU_MENU, $this->getVue('menu', $donnees), false);
|
|
|
165 |
}
|
|
|
166 |
/**
|
|
|
167 |
* Construction du fil d'ariane et stockage dans le conteneur de sortie RENDU_NAVIGATION.
|
|
|
168 |
*
|
|
|
169 |
* @param $referentiel code du référentiel
|
|
|
170 |
* @param $id_traitement id du traitement
|
|
|
171 |
* @param $id_resultat id du résultat
|
|
|
172 |
*/
|
|
|
173 |
protected function construireFilAriane($referentiel = null, $id_traitement = null, $id_resultat = null) {
|
|
|
174 |
$entree['nom'] = 'Accueil';
|
|
|
175 |
$entree['url'] = $this->obtenirUrlMenuAccueil();
|
|
|
176 |
$donnees['entrees'][] = $entree;
|
|
|
177 |
|
|
|
178 |
if (isset($referentiel)) {
|
|
|
179 |
$entree['nom'] = strtoupper($referentiel);
|
|
|
180 |
$entree['url'] = $this->obtenirUrlDetailReferentiel($referentiel);
|
|
|
181 |
$donnees['entrees'][] = $entree;
|
|
|
182 |
|
|
|
183 |
$module = Referentiel::getModule();
|
|
|
184 |
if ($module != 'Accueil') {
|
|
|
185 |
$entree['nom'] = $module;
|
|
|
186 |
$entree['url'] = $this->obtenirUrlMenu($module, $referentiel);
|
|
|
187 |
$donnees['entrees'][] = $entree;
|
|
|
188 |
}
|
|
|
189 |
|
|
|
190 |
if (isset($id_traitement)) {
|
|
|
191 |
$entree['nom'] = "Traitement #$id_traitement";
|
|
|
192 |
$entree['url'] = $this->obtenirUrlFicheTraitement($referentiel, $id_traitement);
|
|
|
193 |
$donnees['entrees'][] = $entree;
|
|
|
194 |
}
|
|
|
195 |
|
|
|
196 |
if (isset($id_resultat)) {
|
|
|
197 |
$entree['nom'] = "Résultat #$id_resultat";
|
|
|
198 |
$entree['url'] = $this->obtenirUrlFicheResultat($referentiel, $id_resultat);
|
|
|
199 |
$donnees['entrees'][] = $entree;
|
|
|
200 |
}
|
|
|
201 |
}
|
|
|
202 |
|
|
|
203 |
$this->setSortie(self::RENDU_NAVIGATION, $this->getVue('fil_ariane', $donnees), false);
|
|
|
204 |
}
|
33 |
jpm |
205 |
|
37 |
jpm |
206 |
protected function obtenirUrlDetailReferentiel($referentiel) {
|
|
|
207 |
$this->url->setRequete(false);
|
|
|
208 |
$this->url->setVariableRequete('module', 'Accueil');
|
|
|
209 |
$this->url->setVariableRequete('action', 'afficherDetail');
|
|
|
210 |
$this->url->setVariableRequete('ref', $referentiel);
|
|
|
211 |
$url = $this->url->getURL();
|
|
|
212 |
$this->url->unsetVariablesRequete(array('module', 'action', 'ref'));
|
|
|
213 |
return $url;
|
|
|
214 |
}
|
|
|
215 |
|
|
|
216 |
protected function obtenirUrlMenuAccueil() {
|
|
|
217 |
return $this->obtenirUrlMenu('Accueil');
|
|
|
218 |
}
|
|
|
219 |
|
|
|
220 |
protected function obtenirUrlMenuTest($referentiel) {
|
|
|
221 |
return $this->obtenirUrlMenu('Test', $referentiel);
|
|
|
222 |
}
|
|
|
223 |
|
|
|
224 |
protected function obtenirUrlMenuVersionnage($referentiel) {
|
|
|
225 |
return $this->obtenirUrlMenu('Versionnage', $referentiel);
|
|
|
226 |
}
|
|
|
227 |
|
|
|
228 |
protected function obtenirUrlMenuConsultation($referentiel) {
|
|
|
229 |
return $this->obtenirUrlMenu('Consultation', $referentiel);
|
|
|
230 |
}
|
|
|
231 |
|
|
|
232 |
private function obtenirUrlMenu($menu, $referentiel = null) {
|
|
|
233 |
$this->url->setRequete(false);
|
|
|
234 |
$this->url->setVariableRequete('module', $menu);
|
|
|
235 |
if (isset($referentiel)) {
|
|
|
236 |
$this->url->setVariableRequete('ref', $referentiel);
|
|
|
237 |
}
|
|
|
238 |
$url = $this->url->getURL();
|
|
|
239 |
$this->url->unsetVariablesRequete(array('module', 'ref'));
|
|
|
240 |
return $url;
|
|
|
241 |
}
|
|
|
242 |
|
|
|
243 |
protected function obtenirUrlFicheTraitement($referentiel, $id_traitement) {
|
|
|
244 |
$this->url->setRequete(false);
|
|
|
245 |
$this->url->setVariableRequete('module', 'Traitement');
|
|
|
246 |
$this->url->setVariableRequete('id-t', $id_traitement);
|
|
|
247 |
$this->url->setVariableRequete('ref', $referentiel);
|
|
|
248 |
$url = $this->url->getURL();
|
|
|
249 |
$this->url->unsetVariablesRequete(array('module', 'id-t', 'ref'));
|
|
|
250 |
return $url;
|
|
|
251 |
}
|
|
|
252 |
|
|
|
253 |
protected function obtenirUrlFicheResultat($referentiel, $id_resultat) {
|
|
|
254 |
$this->url->setRequete(false);
|
|
|
255 |
$this->url->setVariableRequete('module', 'Resultat');
|
|
|
256 |
$this->url->setVariableRequete('id-r', $id_resultat);
|
|
|
257 |
$this->url->setVariableRequete('ref', $referentiel);
|
|
|
258 |
$url = $this->url->getURL();
|
|
|
259 |
$this->url->unsetVariablesRequete(array('module', 'id-r', 'ref'));
|
|
|
260 |
return $url;
|
|
|
261 |
}
|
6 |
jpm |
262 |
}
|