Subversion Repositories Applications.framework

Rev

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

Rev Author Line No. Line
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
15 
 * @version		SVN: $$Id: Controleur.php 172 2010-04-02 14:02:42Z aurelien $$
16 
 * @link		/doc/framework/
129 aurelien 17 
 *
18 
 */
80 jpm 19 
abstract class Controleur {
120 aurelien 20 
	/**
21 
	 * Registre global, normalement accessible partout
22 
	 */
23 
	private $registre;
24 
 
25 
	/**
26 
	 * Constructeur par défaut
27 
	 */
141 jpm 28 
	public function __construct() {
120 aurelien 29 
		if (Config::existe('fw_html_errors')) {
30 
			ini_set('html_errors', Config::get('fw_html_errors'));
31 
		}
32 
 
33 
		$this->registre = Registre::getInstance();
34 
		$this->registre->set('base_chemin_modele', Config::get('chemin_modeles'));
35 
		$this->registre->set('base_chemin_squelette', Config::get('chemin_squelettes'));
36 
		$this->registre->set('base_chemin_controleur', Config::get('chemin_controleurs'));
37 
		$this->registre->set('base_url_application', new Url(Config::get('url_base')));
166 aurelien 38 
		$this->verifierEtReencoderTableauRequete();
120 aurelien 39 
	}
40 
 
41 
	/**
42 
	* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
43 
	*
165 aurelien 44 
	* @param string $nom_modele le nom du modèle à  charger
120 aurelien 45 
	*
165 aurelien 46 
	* @return boolean false si le chargement a échoué, sinon true.
120 aurelien 47 
	*/
48 
	final protected function chargerModele($nom_modele) {
165 aurelien 49 
		$sortie = true;
50 
		$modele = $this->getModele($nom_modele);
51 
		if ($modele !== false) {
52 
			$this->$nom_modele = new $nom_modele;
53 
		} else {
54 
			$sortie = false;
120 aurelien 55 
		}
165 aurelien 56 
		return $sortie;
57 
	}
162 aurelien 58 
 
165 aurelien 59 
	/**
60 
	* Retourne un modele donné
61 
	*
62 
	* @param string $nom_modele le nom du modèle à  charger
63 
	*
64 
	* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
65 
	*/
66 
	final protected function getModele($nom_modele) {
67 
		$sortie = false;
68 
		$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.'.php';
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 
	 *
82 
	 * @param String $nom_squelette le nom du squelette
83 
	 * @param Array  $donnees	   un tableau associatif contenant les variables a injecter dans la vue
84 
	 *
151 jpm 85 
	 * @return boolean false si la vue n'existe pas, sinon la chaine résultat.
120 aurelien 86 
	 */
151 jpm 87 
	final protected function getVue($nom_squelette, $donnees = array()) {
172 aurelien 88 
 
89 
		$donnees = $this->preTraiterDonnees($donnees);
120 aurelien 90 
		$chemin_squelette = ($this->registre->get('base_chemin_squelette')).$nom_squelette.'.tpl.html';
166 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 
	 */
106 
	protected function preTraiterDonnees($donnees) {
162 aurelien 107 
		return $donnees;
108 
	}
166 aurelien 109 
 
110 
	/**
111 
	 * Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
112 
	 */
113 
	protected function verifierEtReencoderTableauRequete() {
168 jpm 114 
		if (Config::get('sortie_encodage') != Config::get('appli_encodage')) {
115 
			$_POST = $this->encoderTableau($_POST, Config::get('appli_encodage'), Config::get('sortie_encodage'));
116 
			$_GET = $this->encoderTableau($_GET, Config::get('appli_encodage'), Config::get('sortie_encodage'));
166 aurelien 117 
		}
118 
	}
119 
 
120 
	/**
121 
	 * 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
123 
	 * @param $encodage_sortie String l'encodage vers lequel on doit transcoder
124 
	 * @param $encodage_entree String l'encodage original des chaines du tableau (optionnel)
125 
	 * @return Array Le tableau encodé dans l'encodage de sortie
126 
	 *
127 
	 */
168 jpm 128 
	final protected function encoderTableau($tableau, $encodage_sortie, $encodage_entree = null) {
166 aurelien 129 
		if (is_array($tableau)) {
130 
			foreach ($tableau as $cle => $valeur) {
131 
				if (is_array($valeur)) {
172 aurelien 132 
				 	$tableau[$cle] = $this->encoderTableau($tableau[$cle], $encodage_sortie, $encodage_entree);
168 jpm 133 
				} else {
134 
					$tableau[$cle] = mb_convert_encoding($valeur, $encodage_sortie, $encodage_entree);
166 aurelien 135 
				}
136 
			}
137 
		}
138 
 
139 
		return $tableau;
140 
	}
5 aurelien 141 
}
142 
?>