Subversion Repositories Applications.framework

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
467 jpm 1 
<?php
2 
// declare(encoding='UTF-8');
3 
/**
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.
6 
 * Elle est abstraite donc doit obligatoirement être étendue.
7 
 *
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
15 
 * @version		SVN: $Id: Controleur.php 191 2010-04-29 15:34:49Z jpm $
16 
 * @link		/doc/framework/
17 
 *
18 
 */
19 
abstract class Controleur {
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;
22 
 
23 
	/** Registre global, normalement accessible partout */
24 
	private $registre;
25 
 
26 
	/**
27 
	 * Constructeur par défaut
28 
	 */
29 
	public function __construct() {
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'));
34 
		$this->registre->set('base_url_application', new Url(Config::get('url_base')));
35 
		$this->verifierEtReencoderTableauRequete();
36 
	}
37 
 
38 
	/**
39 
	* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
40 
	*
41 
	* @param string $nom_modele le nom du modèle à  charger
42 
	*
43 
	* @return boolean false si le chargement a échoué, sinon true.
44 
	*/
45 
	final protected function chargerModele($nom_modele) {
46 
		$sortie = true;
47 
		$modele = $this->getModele($nom_modele);
48 
		if ($modele !== false) {
49 
			$this->$nom_modele = new $nom_modele;
50 
		} else {
51 
			$sortie = false;
52 
		}
53 
		return $sortie;
54 
	}
55 
 
56 
	/**
57 
	* Retourne un modele donné
58 
	*
59 
	* @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 
	*
62 
	* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
63 
	*/
64 
	final protected function getModele($nom_modele, $ext = '.php') {
65 
		$sortie = false;
66 
		$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.$ext;
67 
		if (file_exists($chemin_modele)) {
68 
			include_once $chemin_modele;
69 
			if (class_exists($nom_modele)) {
70 
				$sortie = new $nom_modele;
71 
			}
72 
		}
73 
		return $sortie;
74 
	}
75 
 
76 
	/**
77 
	 * 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.
79 
	 *
80 
	 * @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
82 
	 * @param String $ext 			l'extension du fichier du squelette (par défaut : ".tpl.html"
83 
	 *
84 
	 * @return boolean false si la vue n'existe pas, sinon la chaine résultat.
85 
	 */
86 
	final protected function getVue($nom_squelette, $donnees = array(), $ext = '.tpl.html') {
87 
		$donnees = $this->preTraiterDonnees($donnees);
88 
		$chemin_squelette = ($this->registre->get('base_chemin_squelette')).$nom_squelette.$ext;
89 
		$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
90 
 
91 
		return $sortie;
92 
	}
93 
 
94 
	/**
95 
	 * Fonction prenant en paramètre un tableau de données et effectuant un traitement dessus.
96 
	 * Cette fonction est à surcharger dans les classes filles pour automatiser un traitement
97 
	 * avant chaque chargement de vue.
98 
	 *
99 
	 * @param Array $donnees Le tableau de données à traiter
100 
	 *
101 
	 * @return Array $donnees Le tableau de données traité
102 
	 */
103 
	protected function preTraiterDonnees($donnees) {
104 
		return $donnees;
105 
	}
106 
 
107 
	/**
108 
	 * Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
109 
	 */
110 
	protected function verifierEtReencoderTableauRequete() {
111 
		if (self::$encodage == false && Config::get('sortie_encodage') != Config::get('appli_encodage')) {
112 
			$_POST = $this->encoderTableau($_POST, Config::get('appli_encodage'), Config::get('sortie_encodage'));
113 
			$_GET = $this->encoderTableau($_GET, Config::get('appli_encodage'), Config::get('sortie_encodage'));
114 
			self::$encodage = true;
115 
		}
116 
	}
117 
 
118 
	/**
119 
	 * Fonction récursive transcodant toutes les valeurs d'un tableau de leur encodage d'entrée vers un encodage de sortie donné
120 
	 * @param $tableau Array Un tableau de données à encoder
121 
	 * @param $encodage_sortie String l'encodage vers lequel on doit transcoder
122 
	 * @param $encodage_entree String l'encodage original des chaines du tableau (optionnel)
123 
	 * @return Array Le tableau encodé dans l'encodage de sortie
124 
	 *
125 
	 */
126 
	final protected function encoderTableau($tableau, $encodage_sortie, $encodage_entree = null) {
127 
		if (is_array($tableau)) {
128 
			foreach ($tableau as $cle => $valeur) {
129 
				if (is_array($valeur)) {
130 
				 	$tableau[$cle] = $this->encoderTableau($valeur, $encodage_sortie, $encodage_entree);
131 
				} else {
132 
					$tableau[$cle] = mb_convert_encoding($valeur, $encodage_sortie, $encodage_entree);
133 
				}
134 
			}
135 
		}
136 
		return $tableau;
137 
	}
138 
}
139 
?>