Subversion Repositories Applications.framework

Rev

Rev 239 | Rev 356 | 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 
 *
239 jpm 8 
 * @category	php 5.2
9 
 * @package	Framework
151 jpm 10 
 * @author		Aurélien PERONNET <aurelien@tela-botanica.org>
11 
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
239 jpm 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
14 
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
15 
 * @version	$Id: Controleur.php 241 2010-12-06 15:19:07Z 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 
 
239 jpm 23 
	/** Chemin de base vers les classes métiers de la partie Modèle de l'application. */
24 
	private $base_chemin_modele = null;
25 
 
26 
	/** Chemin de base vers les fichiers squelette de la partie Vue de l'application. */
27 
	private $base_chemin_squelette = null;
28 
 
29 
	/** Chemin de base vers les classes controleurs de la partie Controleur de l'application. */
30 
	private $base_chemin_controleur = null;
31 
 
241 jpm 32 
	/** Objet URL contant l'url de la base de l'application. */
239 jpm 33 
	private $base_url_applicaton = null;
120 aurelien 34 
 
241 jpm 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');
37 
 
120 aurelien 38 
	/**
39 
	 * Constructeur par défaut
40 
	 */
141 jpm 41 
	public function __construct() {
241 jpm 42 
		Config::verifierPresenceParametres($this->parametres_obligatoires);
43 
		$this->base_chemin_modele = Config::get('chemin_modeles');
44 
		$this->base_chemin_squelette = Config::get('chemin_squelettes');
45 
		$this->base_chemin_controleur = Config::get('chemin_controleurs');
46 
		$this->base_url_application = new Url(Config::get('base_url_application'));
120 aurelien 47 
	}
48 
 
49 
	/**
50 
	* Charge un modele donné et le rend disponible sous la forme $this->nom_modele
51 
	*
165 aurelien 52 
	* @param string $nom_modele le nom du modèle à  charger
120 aurelien 53 
	*
165 aurelien 54 
	* @return boolean false si le chargement a échoué, sinon true.
120 aurelien 55 
	*/
196 aurelien 56 
	final public function chargerModele($nom_modele) {
165 aurelien 57 
		$sortie = true;
215 jpm 58 
		if (!isset($this->$nom_modele)) {
59 
			$modele = $this->getModele($nom_modele);
60 
			if ($modele !== false) {
61 
				$this->$nom_modele = new $nom_modele;
62 
			} else {
63 
				$sortie = false;
64 
			}
120 aurelien 65 
		}
165 aurelien 66 
		return $sortie;
67 
	}
162 aurelien 68 
 
165 aurelien 69 
	/**
70 
	* Retourne un modele donné
71 
	*
215 jpm 72 
	* @param string $nom_modele	le nom du fichier modèle à charger sans son extension
73 
	* @param String $ext			l'extension du fichier du modèel (par défaut : ".php"
165 aurelien 74 
	*
75 
	* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.
76 
	*/
192 jpm 77 
	final protected function getModele($nom_modele, $ext = '.php') {
165 aurelien 78 
		$sortie = false;
204 aurelien 79 
 
192 jpm 80 
		$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.$ext;
165 aurelien 81 
		if (file_exists($chemin_modele)) {
82 
			include_once $chemin_modele;
83 
			if (class_exists($nom_modele)) {
84 
				$sortie = new $nom_modele;
85 
			}
120 aurelien 86 
		}
165 aurelien 87 
		return $sortie;
120 aurelien 88 
	}
162 aurelien 89 
 
120 aurelien 90 
	/**
91 
	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,
151 jpm 92 
	 * en extrait les variables, charge le squelette et retourne le résultat des deux combinés.
120 aurelien 93 
	 *
215 jpm 94 
	 * @param String $nom_squelette	le nom du squelette sans son extension
95 
	 * @param Array  $donnees			un tableau associatif contenant les variables a injecter dans la vue
96 
	 * @param String $ext				l'extension du fichier du squelette (par défaut : ".tpl.html"
120 aurelien 97 
	 *
151 jpm 98 
	 * @return boolean false si la vue n'existe pas, sinon la chaine résultat.
120 aurelien 99 
	 */
212 jpm 100 
	final protected function getVue($nom_squelette, &$donnees = array(), $ext = '.tpl.html') {
172 aurelien 101 
		$donnees = $this->preTraiterDonnees($donnees);
241 jpm 102 
 
103 
		$chemin_squelette = $this->base_chemin_squelette.$nom_squelette.$ext;
152 jpm 104 
		$sortie = SquelettePhp::analyser($chemin_squelette, $donnees);
162 aurelien 105 
 
151 jpm 106 
		return $sortie;
107 
	}
162 aurelien 108 
 
151 jpm 109 
	/**
166 aurelien 110 
	 * Fonction prenant en paramètre un tableau de données et effectuant un traitement dessus.
165 aurelien 111 
	 * Cette fonction est à surcharger dans les classes filles pour automatiser un traitement
112 
	 * avant chaque chargement de vue.
113 
	 *
114 
	 * @param Array $donnees Le tableau de données à traiter
115 
	 *
116 
	 * @return Array $donnees Le tableau de données traité
117 
	 */
212 jpm 118 
	protected function preTraiterDonnees(&$donnees) {
162 aurelien 119 
		return $donnees;
120 
	}
5 aurelien 121 
}
122 
?>