| 5 |
aurelien |
1 |
<?php
|
| 105 |
aurelien |
2 |
// declare(encoding='UTF-8');
|
| 5 |
aurelien |
3 |
/**
|
| 151 |
jpm |
4 |
* Classe Controleur, coeur d'une application, c'est normalement la seule classe d'une application
|
| 129 |
aurelien |
5 |
* qui devrait être appelée de l'extérieur.
|
| 151 |
jpm |
6 |
* Elle est abstraite donc doit obligatoirement être étendue.
|
| 129 |
aurelien |
7 |
*
|
| 151 |
jpm |
8 |
* @category php5
|
|
|
9 |
* @package Framework
|
|
|
10 |
* @author Aurélien PERONNET <aurelien@tela-botanica.org>
|
|
|
11 |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
|
|
|
12 |
* @copyright 2009 Tela-Botanica
|
|
|
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
|
| 192 |
jpm |
15 |
* @version SVN: $Id: Controleur.php 215 2010-11-10 09:48:53Z jpm $
|
| 151 |
jpm |
16 |
* @link /doc/framework/
|
| 129 |
aurelien |
17 |
*
|
|
|
18 |
*/
|
| 80 |
jpm |
19 |
abstract class Controleur {
|
| 192 |
jpm |
20 |
/** Variable statique indiquant que les tableaux _GET et _POST ont déjà été encodé au format de l'appli. */
|
|
|
21 |
private static $encodage = false;
|
| 196 |
aurelien |
22 |
|
| 192 |
jpm |
23 |
/** Registre global, normalement accessible partout */
|
| 120 |
aurelien |
24 |
private $registre;
|
|
|
25 |
|
|
|
26 |
/**
|
|
|
27 |
* Constructeur par défaut
|
|
|
28 |
*/
|
| 141 |
jpm |
29 |
public function __construct() {
|
| 120 |
aurelien |
30 |
$this->registre = Registre::getInstance();
|
|
|
31 |
$this->registre->set('base_chemin_modele', Config::get('chemin_modeles'));
|
|
|
32 |
$this->registre->set('base_chemin_squelette', Config::get('chemin_squelettes'));
|
|
|
33 |
$this->registre->set('base_chemin_controleur', Config::get('chemin_controleurs'));
|
| 204 |
aurelien |
34 |
$this->registre->set('base_url_application', new Url(Config::get('base_url_application')));
|
| 120 |
aurelien |
35 |
}
|
|
|
36 |
|
|
|
37 |
/**
|
|
|
38 |
* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
|
|
|
39 |
*
|
| 165 |
aurelien |
40 |
* @param string $nom_modele le nom du modèle à charger
|
| 120 |
aurelien |
41 |
*
|
| 165 |
aurelien |
42 |
* @return boolean false si le chargement a échoué, sinon true.
|
| 120 |
aurelien |
43 |
*/
|
| 196 |
aurelien |
44 |
final public function chargerModele($nom_modele) {
|
| 165 |
aurelien |
45 |
$sortie = true;
|
| 215 |
jpm |
46 |
if (!isset($this->$nom_modele)) {
|
|
|
47 |
$modele = $this->getModele($nom_modele);
|
|
|
48 |
if ($modele !== false) {
|
|
|
49 |
$this->$nom_modele = new $nom_modele;
|
|
|
50 |
} else {
|
|
|
51 |
$sortie = false;
|
|
|
52 |
}
|
| 120 |
aurelien |
53 |
}
|
| 165 |
aurelien |
54 |
return $sortie;
|
|
|
55 |
}
|
| 162 |
aurelien |
56 |
|
| 165 |
aurelien |
57 |
/**
|
|
|
58 |
* Retourne un modele donné
|
|
|
59 |
*
|
| 215 |
jpm |
60 |
* @param string $nom_modele le nom du fichier modèle à charger sans son extension
|
|
|
61 |
* @param String $ext l'extension du fichier du modèel (par défaut : ".php"
|
| 165 |
aurelien |
62 |
*
|
|
|
63 |
* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
|
|
|
64 |
*/
|
| 192 |
jpm |
65 |
final protected function getModele($nom_modele, $ext = '.php') {
|
| 165 |
aurelien |
66 |
$sortie = false;
|
| 204 |
aurelien |
67 |
|
| 192 |
jpm |
68 |
$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.$ext;
|
| 165 |
aurelien |
69 |
if (file_exists($chemin_modele)) {
|
|
|
70 |
include_once $chemin_modele;
|
|
|
71 |
if (class_exists($nom_modele)) {
|
|
|
72 |
$sortie = new $nom_modele;
|
|
|
73 |
}
|
| 120 |
aurelien |
74 |
}
|
| 165 |
aurelien |
75 |
return $sortie;
|
| 120 |
aurelien |
76 |
}
|
| 162 |
aurelien |
77 |
|
| 120 |
aurelien |
78 |
/**
|
|
|
79 |
* Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
|
| 151 |
jpm |
80 |
* en extrait les variables, charge le squelette et retourne le résultat des deux combinés.
|
| 120 |
aurelien |
81 |
*
|
| 215 |
jpm |
82 |
* @param String $nom_squelette le nom du squelette sans son extension
|
|
|
83 |
* @param Array $donnees un tableau associatif contenant les variables a injecter dans la vue
|
|
|
84 |
* @param String $ext l'extension du fichier du squelette (par défaut : ".tpl.html"
|
| 120 |
aurelien |
85 |
*
|
| 151 |
jpm |
86 |
* @return boolean false si la vue n'existe pas, sinon la chaine résultat.
|
| 120 |
aurelien |
87 |
*/
|
| 212 |
jpm |
88 |
final protected function getVue($nom_squelette, &$donnees = array(), $ext = '.tpl.html') {
|
| 172 |
aurelien |
89 |
$donnees = $this->preTraiterDonnees($donnees);
|
| 192 |
jpm |
90 |
$chemin_squelette = ($this->registre->get('base_chemin_squelette')).$nom_squelette.$ext;
|
| 196 |
aurelien |
91 |
|
| 152 |
jpm |
92 |
$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
|
| 162 |
aurelien |
93 |
|
| 151 |
jpm |
94 |
return $sortie;
|
|
|
95 |
}
|
| 162 |
aurelien |
96 |
|
| 151 |
jpm |
97 |
/**
|
| 166 |
aurelien |
98 |
* Fonction prenant en paramètre un tableau de données et effectuant un traitement dessus.
|
| 165 |
aurelien |
99 |
* Cette fonction est à surcharger dans les classes filles pour automatiser un traitement
|
|
|
100 |
* avant chaque chargement de vue.
|
|
|
101 |
*
|
|
|
102 |
* @param Array $donnees Le tableau de données à traiter
|
|
|
103 |
*
|
|
|
104 |
* @return Array $donnees Le tableau de données traité
|
|
|
105 |
*/
|
| 212 |
jpm |
106 |
protected function preTraiterDonnees(&$donnees) {
|
| 162 |
aurelien |
107 |
return $donnees;
|
|
|
108 |
}
|
| 5 |
aurelien |
109 |
}
|
|
|
110 |
?>
|