Subversion Repositories Applications.framework

<?php

// declare(encoding='UTF-8');

/**

 * Classe Controleur, coeur d'une application, c'est normalement la seule classe d'une application

 * qui devrait être appelée de l'extérieur.

 * Elle est abstraite donc doit obligatoirement être étendue.

 *

 * @category	php5

 * @package		Framework

 * @author		Aurélien PERONNET <aurelien@tela-botanica.org>

 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>

 * @copyright	2009 Tela-Botanica

 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL

 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL

 * @version		SVN: $$Id$$

 * @link		/doc/framework/

 *

 */

abstract class Controleur {

	/**

	 * Registre global, normalement accessible partout

	 */

	private $registre;

	/**

	 * Constructeur par défaut

	 */

	public function __construct() {

		if (Config::existe('fw_html_errors')) {

			ini_set('html_errors', Config::get('fw_html_errors'));

		}

		$this->registre = Registre::getInstance();

		$this->registre->set('base_chemin_modele', Config::get('chemin_modeles'));

		$this->registre->set('base_chemin_squelette', Config::get('chemin_squelettes'));

		$this->registre->set('base_chemin_controleur', Config::get('chemin_controleurs'));

		$this->registre->set('base_url_application', new Url(Config::get('url_base')));

	}

	/**

	* Charge un modele donné et le rend disponible sous la forme $this->nom_modele

	*

	* @param string $nom_modele le nom du modèle à charger

	*

	* @return boolean false si le chargement a échoué, sinon true.

	*/

	final protected function chargerModele($nom_modele) {

		$sortie = true;

		$modele = $this->getModele($nom_modele);

		if ($modele !== false) {

			$this->$nom_modele = new $nom_modele;

		} else {

			$sortie = false;

		}

		return $sortie;

	}

	/**

	* Retourne un modele donné

	*

	* @param string $nom_modele le nom du modèle à charger

	*

	* @return mixed false si le chargement a échoué, sinon l'objet du modèle demandé.

	*/

	final protected function getModele($nom_modele) {

		$sortie = false;

		$chemin_modele = $this->registre->get('base_chemin_modele').$nom_modele.'.php';

		if (file_exists($chemin_modele)) {

			include_once $chemin_modele;

			if (class_exists($nom_modele)) {

				$sortie = new $nom_modele;

			}

		}

		return $sortie;

	}

	/**

	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,

	 * en extrait les variables, charge le squelette et retourne le résultat des deux combinés.

	 *

	 * @param String $nom_squelette le nom du squelette

	 * @param Array  $donnees	   un tableau associatif contenant les variables a injecter dans la vue

	 *

	 * @return boolean false si la vue n'existe pas, sinon la chaine résultat.

	 */

	final protected function getVue($nom_squelette, $donnees = array()) {

		$sortie = false;

		$chemin_squelette = ($this->registre->get('base_chemin_squelette')).$nom_squelette.'.tpl.html';

		if (file_exists($chemin_squelette)) {

			// Extraction des variables du tableau de données

			extract($donnees);

			// Démarage de la bufferisation de sortie

			ob_start();

			// si les tags courts sont désactivés

			if ((bool) @ini_get('short_open_tag') === false) {

				// Remplacement des tags courts par la syntaxe classique avec echo

				echo eval('?>'.$this->traiterTagsCourts($chemin_squelette));

			} else {

				// sinon, on se contente d'inclure le squelette

				include $chemin_squelette;

			}

			// Récupèration du contenu du buffer

			$sortie = ob_get_contents();

			// Suppression du buffer

			@ob_end_clean();

		}

		// Retour du contenu

		return $sortie;

	}

	/**

	 * Fonction prenant en paramètre le nom d'un squelette et un tableau associatif de données,

	 * en extrait les variables, charge le squelette et crée une variable de classe portant le nom du squelette

	 * contenant les deux combinés.

	 *

	 * @param String $nom_squelette le nom du squelette

	 * @param Array  $donnees	   un tableau associatif contenant les variables a injecter dans la vue

	 *

	 * @return boolean false si la vue n'existe pas, sinon true.

	 */

	final protected function chargerVue($nom_squelette, $donnees = array()) {

		$sortie = false;

		$rendu = $this->getVue($nom_squelette, $donnees);

		if ($rendu !== false) {

			// Création d'une variable de classe contenant le rendu

			$this->$nom_squelette = $rendu;

			$sortie = true;

		}

		return $sortie;

	}

	/**

	 * Fonction chargeant le contenu du squelette et remplaçant les tags court php (<?= ...) par un tag long avec echo.

	 *

	 * @param String $chemin_squelette le chemin du fichier du squelette

	 *

	 * @return string le contenu du fichier du squelette php avec les tags courts remplacés.

	 */

	private function traiterTagsCourts($chemin_squelette) {

		$contenu = file_get_contents($chemin_squelette);

		// Remplacement de tags courts par un tag long avec echo

		$contenu = str_replace('<?=', '<?php echo ',  $contenu);

		// FIXME : à quoi sert ce deuxième remplacement?

		$contenu = preg_replace("/;*\s*\?>/", "; ?>", $contenu);

		return $contenu;

	}

}

?>