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;
        }
}
?>