Subversion Repositories eFlore/Applications.coel-consultation

Rev

Rev 57 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
9 jpm 1
<?php
2
// declare(encoding='UTF-8');
3
/**
4
 * Classe Controleur générale de l'application Collection.
5
 *
6
 * @category	php5.2
7
 * @package		Collection
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: ColControleur.php 68 2010-05-17 16:56:20Z jpm $
13
 */
11 jpm 14
abstract class ColControleur extends Controleur {
55 jpm 15
 
16
	const FMT_DATE = '%d/%m/%Y';
68 jpm 17
	const FMT_DATE_TXT = '%A %d %B %Y';
55 jpm 18
	const FMT_DATE_HEURE = '%d/%m/%Y %H:%i:%s';
19
	const FMT_DATE_HEURE_TXT = '%A %d %B %Y à %H:%M';
20
 
9 jpm 21
	const RENDU_TETE = 'tete';
22
	const RENDU_CORPS = 'corps';
23
	const RENDU_PIED = 'pied';
15 jpm 24
	const TYPE_AUTRE = 'AUTRE';
25
	const TYPE_TOTAL = 'TOTAL';
26
	const SEPARATEUR_TYPE_VALEUR = '##';
27
	const SEPARATEUR_VALEURS = ';;';
28
	const SEPARATEUR_DONNEES = '||';
29
	const VALEUR_NULL = 'NC';
9 jpm 30
 
31
	private $sortie = array();
32
	private $parametres = array();
11 jpm 33
	// FIXME : voir s'il est plus intéressant d'utiliser une méthode dans les classes filles
34
	protected $url = null;
9 jpm 35
 
36
	public function __construct()  {
37
		$registre = Registre::getInstance();
38
		$this->parametres = $registre->get('parametres');
39
		$this->url = $this->parametres['url'];
40
		parent::__construct();
41
	}
42
 
43
	/**
11 jpm 44
	 * Attribue à la bonne position de sortie un contenu.
9 jpm 45
	 */
46
	protected function setSortie($position, $contenu, $fusionner = false) {
11 jpm 47
		if ($this->verifierExistencePosition($position)) {
9 jpm 48
			if ($fusionner) {
49
				$this->sortie[$position] .= $contenu;
50
			} else {
51
				$this->sortie[$position] = $contenu;
52
			}
53
		}
54
	}
11 jpm 55
 
56
	/**
57
	 * Vérifie l'existence de la position indiquée pour son utilisation dans le tableau de sortie.
58
	 * @param string la position à tester.
59
	 * @return bool true si la position est valide, sinon false.
60
	 */
61
	private function verifierExistencePosition($position) {
62
		$existe = true;
63
		if ($position != self::RENDU_TETE &&
64
			$position != self::RENDU_CORPS &&
65
			$position != self::RENDU_PIED) {
66
			trigger_error("La position '$position' n'est pas une valeur prédéfinie.", E_USER_WARNING);
67
			$existe = false;
68
		}
69
		return $existe;
70
	}
71
 
72
	/**
73
	 * Retourne le tableau de sortie à utiliser dans le controleur principal de l'application.
74
	 */
9 jpm 75
	public function getSortie() {
76
		return $this->sortie;
77
	}
78
 
11 jpm 79
	/**
80
	 * Execute l'action d'un module donnée et fusionne le résultat avec le tableau de sortie.
81
	 */
82
	protected function executerAction($ClasseModule, $action) {
83
		$module = new $ClasseModule();
84
		$module->$action();
85
		$this->fusionnerSortie($module->getSortie());
86
 
87
	}
9 jpm 88
 
11 jpm 89
	/**
90
	 * Fusionne un tableau de sortie par défaut avec le tableau passé en paramêtre.
91
	 * @param array le tableau à fusionner
92
	 */
93
	private function fusionnerSortie($sortie) {
94
		$this->sortie = array_merge($this->sortie, $sortie);
95
	}
96
 
16 jpm 97
	protected function construireTxtTruckSimple($chaine_a_analyser) {
98
		return $this->construireTxtTruck($chaine_a_analyser, false, false);
99
	}
100
 
15 jpm 101
	protected function construireTxtTruckSansMajuscule($chaine_a_analyser) {
102
		return $this->construireTxtTruck($chaine_a_analyser, false);
103
	}
104
 
16 jpm 105
	protected function construireTxtTruckSansPointFinal($chaine_a_analyser) {
106
		return $this->construireTxtTruck($chaine_a_analyser, true, false);
107
	}
108
 
109
	protected function construireTxtTruck($chaine_a_analyser, $majuscule = true, $point_final = true) {
15 jpm 110
		$termes = array();
111
		if ((!is_null($chaine_a_analyser)) && (trim($chaine_a_analyser) != ''))	{
112
			$valeurs = explode(self::SEPARATEUR_VALEURS, $chaine_a_analyser);
113
			$nbre_valeurs = count($valeurs);
114
			if ($nbre_valeurs > 0) {
115
				for ($i = 0; $i < $nbre_valeurs; $i++)	{
116
					$valeur = trim($valeurs[$i]);
117
					if ($valeur != '') {
118
						$valeur_formatee = $this->formaterValeurTruck($valeur);
119
						$termes[] = $valeur_formatee;
120
					}
121
				}
122
			}
123
		}
124
 
16 jpm 125
		$chaine_a_retourner = $this->formaterTableauDeTxt($termes, $majuscule, $point_final);
15 jpm 126
		return $chaine_a_retourner;
127
	}
128
 
55 jpm 129
	protected function getTxtTruckParPosition($chaine_a_analyser, $position = 1) {
130
		$retour = '';
131
		if ((!is_null($chaine_a_analyser)) && (trim($chaine_a_analyser) != ''))	{
132
			$valeurs = explode(self::SEPARATEUR_VALEURS, $chaine_a_analyser);
133
			$nbre_valeurs = count($valeurs);
134
			if ($nbre_valeurs > 0) {
135
				$position = $position - 1;
136
				$valeur = trim($valeurs[$position]);
137
				if ($valeur != '') {
138
					$retour = $this->formaterValeurTruck($valeur);
139
				}
140
			}
141
		}
142
		return $retour;
143
	}
144
 
145
	protected function getTableauTruck($chaine_a_analyser) {
146
		$tableau_retour = array();
147
		if ((!is_null($chaine_a_analyser)) && (trim($chaine_a_analyser) != ''))	{
148
			$valeurs = explode(self::SEPARATEUR_VALEURS, $chaine_a_analyser);
149
			$nbre_valeurs = count($valeurs);
150
			if ($nbre_valeurs > 0) {
151
				for ($i = 0; $i < $nbre_valeurs; $i++)	{
152
					$valeur = trim($valeurs[$i]);
153
					if ($valeur != '') {
154
						$tableau_retour[] = $valeur;
155
					}
156
				}
157
			}
158
		}
159
		return $tableau_retour;
160
	}
161
 
15 jpm 162
	private function formaterValeurTruck($valeur) {
163
		$chaine_a_retourner = '';
164
 
165
		if (preg_match('/^[^#]+##[^$]+$/', $valeur))	{
166
			$cle_valeur = explode(self::SEPARATEUR_TYPE_VALEUR, $valeur);
167
			$chaine_a_retourner = (($cle_valeur[1] == '' || $cle_valeur[1] == 'null') ? self::VALEUR_NULL : $cle_valeur[1]);
168
			$chaine_a_retourner .= ' '.$this->formaterParenthese($cle_valeur[0]);
169
		} else if ($valeur != '')	{
170
			$chaine_a_retourner = $valeur;
171
		} else {
172
			trigger_error("Valeur truck posant problème :$valeur", E_USER_NOTICE);
173
		}
174
 
175
		return $chaine_a_retourner;
176
	}
177
 
178
	protected function formaterParenthese($chaine_a_afficher) {
179
		if ($chaine_a_afficher != '') {
180
			$chaine_a_afficher = '('.$chaine_a_afficher.')';
181
		}
182
		return $chaine_a_afficher;
183
	}
184
 
185
	protected function formaterSautDeLigne($chaine_a_formater) {
186
		$txt_a_retourner = preg_replace('/\n/', '<br />', $chaine_a_formater);
187
		return $txt_a_retourner;
188
	}
189
 
16 jpm 190
	protected function formaterTableauDeTxt($tableau_de_txt, $majuscule = true, $point_final = true) {
15 jpm 191
		$chaine_a_afficher = '';
192
		$taille_du_tableau = count($tableau_de_txt);
193
		if ($taille_du_tableau > 0) {
194
			$index_avt_dernier = $taille_du_tableau - 1;
195
			for ($i = 0; $i < $taille_du_tableau; $i++)	{
196
				$mot = $tableau_de_txt[$i];
197
				if ($i != $index_avt_dernier) {
198
					$chaine_a_afficher .= $mot.', ';
199
				} else {
16 jpm 200
					$chaine_a_afficher .= $this->nettoyerPointFinal($mot);
201
					if ($point_final) {
202
						$chaine_a_afficher .= '.';
203
					}
15 jpm 204
				}
205
			}
206
		}
207
		if ($majuscule) {
208
			$chaine_a_afficher = ucfirst($chaine_a_afficher);
209
		}
210
		return $chaine_a_afficher;
211
	}
212
 
213
	protected function formaterAutre($chaine_a_afficher) {
214
		if ($chaine_a_afficher != '') {
215
			$chaine_a_afficher = ' [Autre : '.$chaine_a_afficher.']';
216
		}
217
		return $chaine_a_afficher;
218
	}
219
 
220
	protected function formaterOuiNon($chaine_a_formater) {
221
		$txt_a_retourner = '';
222
		if ($chaine_a_formater == '0') {
223
			$txt_a_retourner = 'non';
224
		} else if ($chaine_a_formater == '1') {
225
			$txt_a_retourner = 'oui';
226
		}
227
		return $txt_a_retourner;
228
	}
229
 
55 jpm 230
	protected function formaterDate($date, $format = self::FMT_DATE_HEURE) {
17 jpm 231
		if ($date == '' || $date == '0000-00-00' || $date == '0000-00-00 00:00:00') {
232
			$date = 'Inconnue';
55 jpm 233
		} else {
234
			$timestamp = strtotime($date);
235
			$date = strftime($format, $timestamp);
17 jpm 236
		}
237
		return $date;
238
	}
239
 
15 jpm 240
	protected function nettoyerPointFinal($mot) {
241
		$mot = preg_replace('/[.]$/', '', $mot);
242
		return $mot;
243
	}
244
 
245
	public function construireTxtListeOntologie($chaineAAnalyser, $valeurEstOntologie = true, $typeEstOntologie = true, $donneeEstOntologie = false) {
246
		$termes = array();
247
		$autres = array();
248
		$chaineAAnalyser = trim($chaineAAnalyser);
249
		if ($chaineAAnalyser != '') {
250
			$valeurs = explode(self::SEPARATEUR_VALEURS, $chaineAAnalyser);
251
			$nbreValeurs = count($valeurs);
252
			if ($nbreValeurs > 0)	{
253
				for ($i = 0; $i < $nbreValeurs; $i++)	{
254
					$valeur = $valeurs[$i];
255
 
256
					// VALEUR SANS TYPE
257
					// La valeur sans type est une entrée de l'ontologie
258
					if ($valeurEstOntologie && preg_match('/^[0-9]+$/', $valeur)) {
259
						if ($valeur == '0') {
260
							$valeur = '';
261
						} else {
262
							$valeurOntologie = Ontologie::getValeur($valeur);
263
							if ($valeurOntologie != '') {
264
								$valeur = $valeurOntologie['nom'];
265
							}
266
						}
267
					}
268
 
269
					// VALEUR AVEC TYPE
270
					// Type : AUTRE
271
					$valeurTypeAutre = self::TYPE_AUTRE.self::SEPARATEUR_TYPE_VALEUR;
272
					if (preg_match('/^'.$valeurTypeAutre.'.+$/', $valeur)) {
273
						$txtAutre = preg_replace('/^'.$valeurTypeAutre.'/', '', $valeur);
274
						if ($txtAutre != '') {
275
							$autres[] = $txtAutre;
276
						}
277
						$valeur = '';
278
					}
279
					// Type correspondant à une entrée de l'ontologie
280
					if ($typeEstOntologie) {
19 jpm 281
						$valeurTypeOntologie = '([0-9]+)'.self::SEPARATEUR_TYPE_VALEUR;
282
						if (preg_match('/^'.$valeurTypeOntologie.'.*$/', $valeur, $match)) {
283
							$type = $match[1];
284
							$valeurOntologieNom = Ontologie::getValeurNom($type);
285
							if ($valeurOntologieNom !== false) {
15 jpm 286
								$valeur = preg_replace('/^'.$type.'/', $valeurOntologieNom.': ', $valeur);
287
							}
288
						}
289
					}
290
					// Donnée correspondant à une entrée de l'ontologie
291
					if ($donneeEstOntologie) {
292
						$donneeOntologie = self::SEPARATEUR_TYPE_VALEUR.'([0-9]+)';
293
						if (preg_match('/^.+'.$donneeOntologie.'$/', $valeur, $match)) {
294
							$donnee = $match[1];
295
							$donnee = str_replace(self::SEPARATEUR_TYPE_VALEUR, '', $donnee);
19 jpm 296
							$valeurOntologieNom = Ontologie::getValeurNom($donnee);
297
							if ($valeurOntologieNom !== false) {
15 jpm 298
								$valeur = preg_replace('/'.$donnee.'$/', $valeurOntologieNom, $valeur);
299
							}
300
						}
301
					}
302
 
303
					// Nettoyage final
304
					$valeur = preg_replace('/'.self::SEPARATEUR_TYPE_VALEUR.'/', '', $valeur);
305
 
306
					if ($valeur != '') {
307
						$termes[] = $valeur;
308
					}
309
				}
310
			}
311
		}
312
 
313
		$chaineTermes = $this->formaterTableauDeTxt($termes);
314
		$chaineAutres = $this->formaterTableauDeTxt($autres);
315
		$chaineARetourner = $chaineTermes.$this->formaterAutre($chaineAutres);
316
 
317
		return $chaineARetourner;
318
	}
319
 
18 jpm 320
	protected function obtenirUrlFicheStructure($id_structure) {
321
		$this->url->setVariableRequete('module', 'Fiche');
322
		$this->url->setVariableRequete('action', 'afficherStructure');
323
		$this->url->setVariableRequete('id', $id_structure);
324
		$url = $this->url->getURL();
325
		$this->url->unsetVariablesRequete(array('module', 'action', 'id'));
326
		return $url;
327
	}
328
 
55 jpm 329
	protected function obtenirUrlFicheCollection($id_collection) {
18 jpm 330
		$this->url->setVariableRequete('module', 'Fiche');
331
		$this->url->setVariableRequete('action', 'afficherCollection');
332
		$this->url->setVariableRequete('id', $id_collection);
333
		$url = $this->url->getURL();
334
		$this->url->unsetVariablesRequete(array('module', 'action', 'id'));
335
		return $url;
336
	}
19 jpm 337
 
55 jpm 338
	protected function obtenirUrlFichePersonne($id_personne) {
339
		$this->url->setVariableRequete('module', 'Fiche');
340
		$this->url->setVariableRequete('action', 'afficherPersonne');
341
		$this->url->setVariableRequete('id', $id_personne);
342
		$url = $this->url->getURL();
343
		$this->url->unsetVariablesRequete(array('module', 'action', 'id'));
344
		return $url;
345
	}
346
 
19 jpm 347
	protected function postraiterDonnees(&$tableau) {
348
		if (count($tableau) > 0) {
349
			foreach ($tableau as $cle => &$valeur) {
350
				if ($valeur == '') {
351
					$valeur = '&nbsp;';
352
				} else if (is_string($valeur)) {
353
					$valeur = preg_replace('/&(?!amp;)/i', '&amp;', $valeur, -1);
354
				} else if (is_array($valeur)) {
355
					$this->postraiterDonnees($valeur);
356
				}
357
			}
358
		}
359
	}
9 jpm 360
}