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 php5
|
8 |
* @category php5
|
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 2009 Tela-Botanica
|
12 |
* @copyright 2009 Tela-Botanica
|
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 SVN: $Id: Controleur.php 196 2010-06-22 13:21:58Z aurelien $
|
15 |
* @version SVN: $Id: Controleur.php 204 2010-07-19 13:23:56Z aurelien $
|
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 |
private static $encodage = false;
|
22 |
|
22 |
|
23 |
/** Registre global, normalement accessible partout */
|
23 |
/** Registre global, normalement accessible partout */
|
24 |
private $registre;
|
24 |
private $registre;
|
25 |
|
25 |
|
26 |
/**
|
26 |
/**
|
27 |
* Constructeur par défaut
|
27 |
* Constructeur par défaut
|
28 |
*/
|
28 |
*/
|
29 |
public function __construct() {
|
29 |
public function __construct() {
|
30 |
$this->registre = Registre::getInstance();
|
30 |
$this->registre = Registre::getInstance();
|
31 |
$this->registre->set('base_chemin_modele', Config::get('chemin_modeles'));
|
31 |
$this->registre->set('base_chemin_modele', Config::get('chemin_modeles'));
|
32 |
$this->registre->set('base_chemin_squelette', Config::get('chemin_squelettes'));
|
32 |
$this->registre->set('base_chemin_squelette', Config::get('chemin_squelettes'));
|
33 |
$this->registre->set('base_chemin_controleur', Config::get('chemin_controleurs'));
|
33 |
$this->registre->set('base_chemin_controleur', Config::get('chemin_controleurs'));
|
34 |
$this->registre->set('base_url_application', new Url(Config::get('url_base')));
|
34 |
$this->registre->set('base_url_application', new Url(Config::get('base_url_application')));
|
- |
|
35 |
|
35 |
$this->verifierEtReencoderTableauRequete();
|
36 |
$this->verifierEtReencoderTableauRequete();
|
36 |
}
|
37 |
}
|
37 |
|
38 |
|
38 |
/**
|
39 |
/**
|
39 |
* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
|
40 |
* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
|
40 |
*
|
41 |
*
|
41 |
* @param string $nom_modele le nom du modèle à charger
|
42 |
* @param string $nom_modele le nom du modèle à charger
|
42 |
*
|
43 |
*
|
43 |
* @return boolean false si le chargement a échoué, sinon true.
|
44 |
* @return boolean false si le chargement a échoué, sinon true.
|
44 |
*/
|
45 |
*/
|
45 |
final public function chargerModele($nom_modele) {
|
46 |
final public function chargerModele($nom_modele) {
|
46 |
$sortie = true;
|
47 |
$sortie = true;
|
47 |
$modele = $this->getModele($nom_modele);
|
48 |
$modele = $this->getModele($nom_modele);
|
48 |
if ($modele !== false) {
|
49 |
if ($modele !== false) {
|
49 |
$this->$nom_modele = new $nom_modele;
|
50 |
$this->$nom_modele = new $nom_modele;
|
50 |
} else {
|
51 |
} else {
|
51 |
$sortie = false;
|
52 |
$sortie = false;
|
52 |
}
|
53 |
}
|
53 |
return $sortie;
|
54 |
return $sortie;
|
54 |
}
|
55 |
}
|
55 |
|
56 |
|
56 |
/**
|
57 |
/**
|
57 |
* Retourne un modele donné
|
58 |
* Retourne un modele donné
|
58 |
*
|
59 |
*
|
59 |
* @param string $nom_modele le nom du fichier modèle à charger sans son extension
|
60 |
* @param string $nom_modele le nom du fichier modèle à charger sans son extension
|
60 |
* @param String $ext l'extension du fichier du modèel (par défaut : ".php"
|
61 |
* @param String $ext l'extension du fichier du modèel (par défaut : ".php"
|
61 |
*
|
62 |
*
|
62 |
* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
|
63 |
* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
|
63 |
*/
|
64 |
*/
|
64 |
final protected function getModele($nom_modele, $ext = '.php') {
|
65 |
final protected function getModele($nom_modele, $ext = '.php') {
|
65 |
$sortie = false;
|
66 |
$sortie = false;
|
- |
|
67 |
|
66 |
$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.$ext;
|
68 |
$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.$ext;
|
67 |
if (file_exists($chemin_modele)) {
|
69 |
if (file_exists($chemin_modele)) {
|
68 |
include_once $chemin_modele;
|
70 |
include_once $chemin_modele;
|
69 |
if (class_exists($nom_modele)) {
|
71 |
if (class_exists($nom_modele)) {
|
70 |
$sortie = new $nom_modele;
|
72 |
$sortie = new $nom_modele;
|
71 |
}
|
73 |
}
|
72 |
}
|
74 |
}
|
73 |
return $sortie;
|
75 |
return $sortie;
|
74 |
}
|
76 |
}
|
75 |
|
77 |
|
76 |
/**
|
78 |
/**
|
77 |
* Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
|
79 |
* Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
|
78 |
* en extrait les variables, charge le squelette et retourne le résultat des deux combinés.
|
80 |
* en extrait les variables, charge le squelette et retourne le résultat des deux combinés.
|
79 |
*
|
81 |
*
|
80 |
* @param String $nom_squelette le nom du squelette sans son extension
|
82 |
* @param String $nom_squelette le nom du squelette sans son extension
|
81 |
* @param Array $donnees un tableau associatif contenant les variables a injecter dans la vue
|
83 |
* @param Array $donnees un tableau associatif contenant les variables a injecter dans la vue
|
82 |
* @param String $ext l'extension du fichier du squelette (par défaut : ".tpl.html"
|
84 |
* @param String $ext l'extension du fichier du squelette (par défaut : ".tpl.html"
|
83 |
*
|
85 |
*
|
84 |
* @return boolean false si la vue n'existe pas, sinon la chaine résultat.
|
86 |
* @return boolean false si la vue n'existe pas, sinon la chaine résultat.
|
85 |
*/
|
87 |
*/
|
86 |
final protected function getVue($nom_squelette, $donnees = array(), $ext = '.tpl.html') {
|
88 |
final protected function getVue($nom_squelette, $donnees = array(), $ext = '.tpl.html') {
|
87 |
|
89 |
|
88 |
$donnees = $this->preTraiterDonnees($donnees);
|
90 |
$donnees = $this->preTraiterDonnees($donnees);
|
89 |
$chemin_squelette = ($this->registre->get('base_chemin_squelette')).$nom_squelette.$ext;
|
91 |
$chemin_squelette = ($this->registre->get('base_chemin_squelette')).$nom_squelette.$ext;
|
90 |
|
92 |
|
91 |
$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
|
93 |
$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
|
92 |
|
94 |
|
93 |
return $sortie;
|
95 |
return $sortie;
|
94 |
}
|
96 |
}
|
95 |
|
97 |
|
96 |
/**
|
98 |
/**
|
97 |
* Fonction prenant en paramètre un tableau de données et effectuant un traitement dessus.
|
99 |
* Fonction prenant en paramètre un tableau de données et effectuant un traitement dessus.
|
98 |
* Cette fonction est à surcharger dans les classes filles pour automatiser un traitement
|
100 |
* Cette fonction est à surcharger dans les classes filles pour automatiser un traitement
|
99 |
* avant chaque chargement de vue.
|
101 |
* avant chaque chargement de vue.
|
100 |
*
|
102 |
*
|
101 |
* @param Array $donnees Le tableau de données à traiter
|
103 |
* @param Array $donnees Le tableau de données à traiter
|
102 |
*
|
104 |
*
|
103 |
* @return Array $donnees Le tableau de données traité
|
105 |
* @return Array $donnees Le tableau de données traité
|
104 |
*/
|
106 |
*/
|
105 |
protected function preTraiterDonnees($donnees) {
|
107 |
protected function preTraiterDonnees($donnees) {
|
106 |
return $donnees;
|
108 |
return $donnees;
|
107 |
}
|
109 |
}
|
108 |
|
110 |
|
109 |
/**
|
111 |
/**
|
110 |
* Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
|
112 |
* Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
|
111 |
*/
|
113 |
*/
|
112 |
protected function verifierEtReencoderTableauRequete() {
|
114 |
protected function verifierEtReencoderTableauRequete() {
|
113 |
if (self::$encodage == false && Config::get('sortie_encodage') != Config::get('appli_encodage')) {
|
115 |
if (self::$encodage == false && Config::get('sortie_encodage') != Config::get('appli_encodage')) {
|
114 |
$_POST = $this->encoderTableau($_POST, Config::get('appli_encodage'), Config::get('sortie_encodage'));
|
116 |
$_POST = $this->encoderTableau($_POST, Config::get('appli_encodage'), Config::get('sortie_encodage'));
|
115 |
$_GET = $this->encoderTableau($_GET, Config::get('appli_encodage'), Config::get('sortie_encodage'));
|
117 |
$_GET = $this->encoderTableau($_GET, Config::get('appli_encodage'), Config::get('sortie_encodage'));
|
- |
|
118 |
|
116 |
self::$encodage = true;
|
119 |
self::$encodage = true;
|
117 |
}
|
120 |
}
|
- |
|
121 |
|
- |
|
122 |
// traitement des magic quotes
|
- |
|
123 |
$this->verifierEtTraiterSlashTableauRequete();
|
- |
|
124 |
}
|
- |
|
125 |
|
- |
|
126 |
/**
|
- |
|
127 |
* Procédure vérifiant l'activation des magic quotes et remplacant les slash dans les tableaux de requete
|
- |
|
128 |
*/
|
- |
|
129 |
private function verifierEtTraiterSlashTableauRequete() {
|
- |
|
130 |
|
- |
|
131 |
if ( get_magic_quotes_gpc() ) {
|
- |
|
132 |
|
- |
|
133 |
if (!function_exists('stripslashes_deep')) {
|
- |
|
134 |
function stripslashes_deep( $value ) {
|
- |
|
135 |
|
- |
|
136 |
return ( is_array($value) )
|
- |
|
137 |
? array_map('stripslashes_deep', $value)
|
- |
|
138 |
: stripslashes($value);
|
- |
|
139 |
|
- |
|
140 |
} // end of 'stripslashes_deep()'
|
- |
|
141 |
|
- |
|
142 |
$_GET = array_map('stripslashes_deep', $_GET);
|
- |
|
143 |
$_POST = array_map('stripslashes_deep', $_POST);
|
- |
|
144 |
$_COOKIE = array_map('stripslashes_deep', $_COOKIE);
|
- |
|
145 |
}
|
- |
|
146 |
}
|
118 |
}
|
147 |
}
|
119 |
|
148 |
|
120 |
/**
|
149 |
/**
|
121 |
* Fonction récursive transcodant toutes les valeurs d'un tableau de leur encodage d'entrée vers un encodage de sortie donné
|
150 |
* Fonction récursive transcodant toutes les valeurs d'un tableau de leur encodage d'entrée vers un encodage de sortie donné
|
122 |
* @param $tableau Array Un tableau de données à encoder
|
151 |
* @param $tableau Array Un tableau de données à encoder
|
123 |
* @param $encodage_sortie String l'encodage vers lequel on doit transcoder
|
152 |
* @param $encodage_sortie String l'encodage vers lequel on doit transcoder
|
124 |
* @param $encodage_entree String l'encodage original des chaines du tableau (optionnel)
|
153 |
* @param $encodage_entree String l'encodage original des chaines du tableau (optionnel)
|
125 |
* @return Array Le tableau encodé dans l'encodage de sortie
|
154 |
* @return Array Le tableau encodé dans l'encodage de sortie
|
126 |
*
|
155 |
*
|
127 |
*/
|
156 |
*/
|
128 |
final protected function encoderTableau($tableau, $encodage_sortie, $encodage_entree = null) {
|
157 |
final protected function encoderTableau($tableau, $encodage_sortie, $encodage_entree = null) {
|
129 |
if (is_array($tableau)) {
|
158 |
if (is_array($tableau)) {
|
130 |
foreach ($tableau as $cle => $valeur) {
|
159 |
foreach ($tableau as $cle => $valeur) {
|
131 |
if (is_array($valeur)) {
|
160 |
if (is_array($valeur)) {
|
132 |
$tableau[$cle] = $this->encoderTableau($valeur, $encodage_sortie, $encodage_entree);
|
161 |
$tableau[$cle] = $this->encoderTableau($valeur, $encodage_sortie, $encodage_entree);
|
133 |
} else {
|
162 |
} else {
|
134 |
$tableau[$cle] = mb_convert_encoding($valeur, $encodage_sortie, $encodage_entree);
|
163 |
$tableau[$cle] = mb_convert_encoding($valeur, $encodage_sortie, $encodage_entree);
|
135 |
}
|
164 |
}
|
136 |
}
|
165 |
}
|
137 |
}
|
166 |
}
|
138 |
return $tableau;
|
167 |
return $tableau;
|
139 |
}
|
168 |
}
|
140 |
}
|
169 |
}
|
141 |
?>
|
170 |
?>
|