| 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 php 5.2
|
8 |
* @category php 5.2
|
| 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 Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org)
|
12 |
* @copyright Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org)
|
| 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 $Id: Controleur.php 415 2012-04-04 09:05:55Z jpm $
|
15 |
* @version $Id: Controleur.php 485 2014-08-08 08:32:24Z mathias $
|
| 16 |
* @link /doc/framework/
|
16 |
* @link /doc/framework/
|
| 17 |
*
|
17 |
*
|
| 18 |
*/
|
18 |
*/
|
| 19 |
abstract class Controleur {
|
19 |
abstract class Controleur {
|
| 20 |
/** Variable statique indiquant que les tableaux _GET et _POST ont déjà été encodé au format de l'appli. */
|
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;
|
21 |
protected static $encodage = false;
|
| 22 |
|
22 |
|
| 23 |
/** Chemin de base vers les classes métiers de la partie Modèle de l'application. */
|
23 |
/** Chemin de base vers les classes métiers de la partie Modèle de l'application. */
|
| 24 |
private $base_chemin_modele = null;
|
24 |
protected $base_chemin_modele = null;
|
| 25 |
|
25 |
|
| 26 |
/** Chemin de base vers les fichiers squelette de la partie Vue de l'application. */
|
26 |
/** Chemin de base vers les fichiers squelette de la partie Vue de l'application. */
|
| 27 |
private $base_chemin_squelette = null;
|
27 |
protected $base_chemin_squelette = null;
|
| 28 |
|
28 |
|
| 29 |
/** Chemin de base vers les classes controleurs de la partie Controleur de l'application. */
|
29 |
/** Chemin de base vers les classes controleurs de la partie Controleur de l'application. */
|
| 30 |
private $base_chemin_controleur = null;
|
30 |
protected $base_chemin_controleur = null;
|
| 31 |
|
31 |
|
| 32 |
/** Objet URL contant l'url de la base de l'application. */
|
32 |
/** Objet URL contant l'url de la base de l'application. */
|
| 33 |
private $base_url_applicaton = null;
|
33 |
protected $base_url_applicaton = null;
|
| 34 |
|
34 |
|
| 35 |
/** Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.*/
|
35 |
/** Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.*/
|
| 36 |
protected $parametres_obligatoires = array('chemin_modeles', 'chemin_squelettes', 'chemin_controleurs', 'base_url_application');
|
36 |
protected $parametres_obligatoires = array('chemin_modeles', 'chemin_squelettes', 'chemin_controleurs', 'base_url_application');
|
| 37 |
|
37 |
|
| 38 |
/**
|
38 |
/**
|
| 39 |
* Constructeur par défaut
|
39 |
* Constructeur par défaut
|
| 40 |
*/
|
40 |
*/
|
| 41 |
public function __construct() {
|
41 |
public function __construct() {
|
| 42 |
Config::verifierPresenceParametres($this->parametres_obligatoires);
|
42 |
Config::verifierPresenceParametres($this->parametres_obligatoires);
|
| 43 |
|
43 |
|
| 44 |
$this->base_chemin_modele = Config::get('chemin_modeles');
|
44 |
$this->base_chemin_modele = Config::get('chemin_modeles');
|
| 45 |
if (Registre::existe('tbf.chemin_modeles')) {
|
45 |
if (Registre::existe('tbf.chemin_modeles')) {
|
| 46 |
$this->base_chemin_modele = Registre::get('tbf.chemin_modeles');
|
46 |
$this->base_chemin_modele = Registre::get('tbf.chemin_modeles');
|
| 47 |
}
|
47 |
}
|
| 48 |
|
48 |
|
| 49 |
$this->base_chemin_squelette = Config::get('chemin_squelettes');
|
49 |
$this->base_chemin_squelette = Config::get('chemin_squelettes');
|
| 50 |
if (Registre::existe('tbf.chemin_squelettes')) {
|
50 |
if (Registre::existe('tbf.chemin_squelettes')) {
|
| 51 |
$this->base_chemin_squelette = Registre::get('tbf.chemin_squelettes');
|
51 |
$this->base_chemin_squelette = Registre::get('tbf.chemin_squelettes');
|
| 52 |
}
|
52 |
}
|
| 53 |
|
53 |
|
| 54 |
$this->base_chemin_controleur = Config::get('chemin_controleurs');
|
54 |
$this->base_chemin_controleur = Config::get('chemin_controleurs');
|
| 55 |
if (Registre::existe('tbf.chemin_controleurs')) {
|
55 |
if (Registre::existe('tbf.chemin_controleurs')) {
|
| 56 |
$this->base_chemin_squelette = Registre::get('tbf.chemin_controleurs');
|
56 |
$this->base_chemin_controleur = Registre::get('tbf.chemin_controleurs');
|
| 57 |
}
|
57 |
}
|
| 58 |
|
58 |
|
| 59 |
$this->base_url_application = new Url(Config::get('base_url_application'));
|
59 |
$this->base_url_application = new Url(Config::get('base_url_application'));
|
| 60 |
}
|
60 |
}
|
| 61 |
|
61 |
|
| 62 |
/**
|
62 |
/**
|
| 63 |
* Permet de récupérer le chemin vers les squelettes.
|
63 |
* Permet de récupérer le chemin vers les squelettes.
|
| 64 |
*
|
64 |
*
|
| 65 |
* @return String $chemin chemin vers les squelettes
|
65 |
* @return String $chemin chemin vers les squelettes
|
| 66 |
*/
|
66 |
*/
|
| 67 |
protected function getCheminSquelette() {
|
67 |
protected function getCheminSquelette() {
|
| 68 |
return $this->base_chemin_squelette;
|
68 |
return $this->base_chemin_squelette;
|
| 69 |
}
|
69 |
}
|
| 70 |
|
70 |
|
| 71 |
/**
|
71 |
/**
|
| 72 |
* Permet de définir dynamiquement le chemin vers les squelettes.
|
72 |
* Permet de définir dynamiquement le chemin vers les squelettes.
|
| 73 |
*
|
73 |
*
|
| 74 |
* @param String $chemin chemin vers les squelettes
|
74 |
* @param String $chemin chemin vers les squelettes
|
| 75 |
*/
|
75 |
*/
|
| 76 |
protected function setCheminSquelette($chemin) {
|
76 |
protected function setCheminSquelette($chemin) {
|
| 77 |
$this->base_chemin_squelette = $chemin;
|
77 |
$this->base_chemin_squelette = $chemin;
|
| 78 |
}
|
78 |
}
|
| 79 |
|
79 |
|
| 80 |
/**
|
80 |
/**
|
| 81 |
* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
|
81 |
* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
|
| 82 |
*
|
82 |
*
|
| 83 |
* @param string $nom_modele le nom du modèle à charger
|
83 |
* @param string $nom_modele le nom du modèle à charger
|
| 84 |
*
|
84 |
*
|
| 85 |
* @return boolean false si le chargement a échoué, sinon true.
|
85 |
* @return boolean false si le chargement a échoué, sinon true.
|
| 86 |
*/
|
86 |
*/
|
| 87 |
public function chargerModele($nom_modele) {
|
87 |
public function chargerModele($nom_modele) {
|
| 88 |
$sortie = true;
|
88 |
$sortie = true;
|
| 89 |
if (!isset($this->$nom_modele)) {
|
89 |
if (!isset($this->$nom_modele)) {
|
| 90 |
$modele = $this->getModele($nom_modele);
|
90 |
$modele = $this->getModele($nom_modele);
|
| 91 |
if ($modele !== false) {
|
91 |
if ($modele !== false) {
|
| 92 |
$this->$nom_modele = new $nom_modele;
|
92 |
$this->$nom_modele = new $nom_modele;
|
| 93 |
} else {
|
93 |
} else {
|
| 94 |
$sortie = false;
|
94 |
$sortie = false;
|
| 95 |
}
|
95 |
}
|
| 96 |
}
|
96 |
}
|
| 97 |
return $sortie;
|
97 |
return $sortie;
|
| 98 |
}
|
98 |
}
|
| 99 |
|
99 |
|
| 100 |
/**
|
100 |
/**
|
| 101 |
* Retourne un modele donné
|
101 |
* Retourne un modele donné
|
| 102 |
*
|
102 |
*
|
| 103 |
* @param string $nom_modele le nom du fichier modèle à charger sans son extension
|
103 |
* @param string $nom_modele le nom du fichier modèle à charger sans son extension
|
| 104 |
* @param String $ext l'extension du fichier du modèle (par défaut : ".php")
|
104 |
* @param String $ext l'extension du fichier du modèle (par défaut : ".php")
|
| 105 |
*
|
105 |
*
|
| 106 |
* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
|
106 |
* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
|
| 107 |
*/
|
107 |
*/
|
| 108 |
protected function getModele($nom_modele, $ext = '.php') {
|
108 |
protected function getModele($nom_modele, $ext = '.php') {
|
| 109 |
$sortie = false;
|
109 |
$sortie = false;
|
| 110 |
|
110 |
|
| 111 |
$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.$ext;
|
111 |
$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.$ext;
|
| 112 |
if (file_exists($chemin_modele)) {
|
112 |
if (file_exists($chemin_modele)) {
|
| 113 |
include_once $chemin_modele;
|
113 |
include_once $chemin_modele;
|
| 114 |
if (class_exists($nom_modele)) {
|
114 |
if (class_exists($nom_modele)) {
|
| 115 |
$sortie = new $nom_modele;
|
115 |
$sortie = new $nom_modele;
|
| 116 |
}
|
116 |
}
|
| 117 |
}
|
117 |
}
|
| 118 |
return $sortie;
|
118 |
return $sortie;
|
| 119 |
}
|
119 |
}
|
| 120 |
|
120 |
|
| 121 |
/**
|
121 |
/**
|
| 122 |
* Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
|
122 |
* Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
|
| 123 |
* en extrait les variables, charge le squelette et retourne le résultat des deux combinés.
|
123 |
* en extrait les variables, charge le squelette et retourne le résultat des deux combinés.
|
| 124 |
*
|
124 |
*
|
| 125 |
* @param String $nom_squelette le nom du squelette sans son extension si elle vaut ".tpl.html"
|
125 |
* @param String $nom_squelette le nom du squelette sans son extension si elle vaut ".tpl.html"
|
| 126 |
* @param Array $donnees un tableau associatif contenant les variables a injecter dans la vue
|
126 |
* @param Array $donnees un tableau associatif contenant les variables a injecter dans la vue
|
| 127 |
* @since 0.4 suppression du paramètre 'ext' => le mettre directement dans le nom du squelette
|
127 |
* @since 0.4 suppression du paramètre 'ext' => le mettre directement dans le nom du squelette
|
| 128 |
*
|
128 |
*
|
| 129 |
* @return boolean false si la vue n'existe pas, sinon la chaine résultat.
|
129 |
* @return boolean false si la vue n'existe pas, sinon la chaine résultat.
|
| 130 |
*/
|
130 |
*/
|
| 131 |
protected function getVue($nom_squelette, $donnees = array()) {
|
131 |
protected function getVue($nom_squelette, $donnees = array()) {
|
| 132 |
$donnees = $this->preTraiterDonnees($donnees);
|
132 |
$donnees = $this->preTraiterDonnees($donnees);
|
| 133 |
$chemin_squelette = $this->base_chemin_squelette.$nom_squelette.'.tpl.html';
|
133 |
$chemin_squelette = $this->base_chemin_squelette.$nom_squelette.'.tpl.html';
|
| - |
|
134 |
echo "Chesqueu 1 : " . $chemin_squelette . "<br/>";
|
| 134 |
if (file_exists($chemin_squelette) === false) {
|
135 |
if (file_exists($chemin_squelette) === false) {
|
| 135 |
$chemin_squelette = $this->base_chemin_squelette.$nom_squelette;
|
136 |
$chemin_squelette = $this->base_chemin_squelette.$nom_squelette;
|
| - |
|
137 |
echo "Chesqueu 2 : " . $chemin_squelette . "<br/>";
|
| 136 |
}
|
138 |
}
|
| 137 |
$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
|
139 |
$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
|
| 138 |
|
140 |
|
| 139 |
return $sortie;
|
141 |
return $sortie;
|
| 140 |
}
|
142 |
}
|
| 141 |
|
143 |
|
| 142 |
/**
|
144 |
/**
|
| 143 |
* Fonction prenant en paramètre un tableau de données et effectuant un traitement dessus.
|
145 |
* Fonction prenant en paramètre un tableau de données et effectuant un traitement dessus.
|
| 144 |
* Cette fonction est à surcharger dans les classes filles pour automatiser un traitement
|
146 |
* Cette fonction est à surcharger dans les classes filles pour automatiser un traitement
|
| 145 |
* avant chaque chargement de vue.
|
147 |
* avant chaque chargement de vue.
|
| 146 |
*
|
148 |
*
|
| 147 |
* @param Array $donnees Le tableau de données à traiter
|
149 |
* @param Array $donnees Le tableau de données à traiter
|
| 148 |
*
|
150 |
*
|
| 149 |
* @return Array $donnees Le tableau de données traité
|
151 |
* @return Array $donnees Le tableau de données traité
|
| 150 |
*/
|
152 |
*/
|
| 151 |
protected function preTraiterDonnees(&$donnees) {
|
153 |
protected function preTraiterDonnees(&$donnees) {
|
| 152 |
return $donnees;
|
154 |
return $donnees;
|
| 153 |
}
|
155 |
}
|
| 154 |
}
|
156 |
}
|
| 155 |
?>
|
157 |
?>
|