WebSVN – eFlore/Applications.eflore-consultation – /trunk/controleurs/AppControleur.php

<?php
// declare(encoding='UTF-8');
/**
 * AppControleur est le controlleur principal de l'application.
 * Elle repartie les demandes utilisateurs dans les différents modules, executent les actions et redistribue le code
 * html dans les différentes fonctions d'affichage.
 * C'est une Singleton.
 *
 * @category    PHP 5.2
 * @package             eflore-consultation
 * @author              Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @author              Delphine CAUQUIL <delphine@tela-botanica.org>
 * @copyright   2011 Tela-Botanica
 * @license             http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3
 * @license             http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
 * @version             $Id$
 */

class AppControleur extends Controleur {

        /**
         * Instance de la classe pointant sur elle même (pour le pattern singleton)
         */
        private static $instance = null;

        /**
         * Paramètres d'AppControleur
         */
        private static $parametres = array();

        /**
         * Constructeur vide
         */
        public function __construct() {
                $sortie = array(
                        'titre' => '', 'description' => '', 'tags' => '',
                        'entete' => '', 'tags' => '',
                        'corps' => '', 'tete' => '', 'pied' => '',
                        'navigation' => '', 'menu' => '');

                self::$parametres = array(
                        'referentiel' => Config::get('referentiel_defaut'),
                        'module' => Config::get('module_defaut'),
                        'action' => Config::get('action_defaut'),
                        'niveau' => Config::get('niveau_defaut'),
                        'sortie' => $sortie);
                parent::__construct();
        }

        /**
         * Initialisation du controleur principal en fonction des paramêtres de l'url.
         */
        public static function initialiser() {
                self::verifierCreationInstance();
                self::gererSession();

                self::nettoyerGet();
                self::capturerParametres();
                self::initialiserRegistre();
                self::chargerConfigReferentiel();

                spl_autoload_register(array(get_class(), 'chargerClasse'));

                self::executerModule();
        }

        // "public" pour pouvoir être appelée distinctememnt de "initialiser" lors des tests PHPUnit
        public static function verifierCreationInstance() {
                if (empty(self::$instance)) {
                        self::$instance = new AppControleur();
                }
        }

        private static function gererSession() {
                if (Config::get('session_demarrage')) {
                        // Attribution d'un nom à la session
                        session_name(Config::get('session_nom'));
                        // Démarrage de la session
                        session_start();
                }
        }

        private static function nettoyerGet() {
                foreach ($_GET as $cle => $valeur) {
                        $verifier = array('NULL', "\n", "\r", "\\", "'", '"', "\x00", "\x1a", ';');
                        $_GET[$cle] = strip_tags(str_replace($verifier, '', $valeur));
                }
        }

        private static function capturerParametres() {
                if (isset($_GET['referentiel'])) {
                        self::$parametres['referentiel'] = $_GET['referentiel'];
                }
                if (isset($_GET['module'])) {
                        self::$parametres['module'] = $_GET['module'];
                }
                if (isset($_GET['action'])) {
                        self::$parametres['action'] = $_GET['action'];
                }
                if (isset($_GET['niveau'])) {
                        self::$parametres['niveau'] = $_GET['niveau'];
                }
        }

        // "public" pour pouvoir être appelée distinctememnt de "initialiser" lors des tests PHPUnit
        public static function initialiserRegistre() {
                Registre::set('eFlore.urlBase', new Url(Config::get('base_url_application_index')));
                Registre::set('eFlore.urlBaseDossier', new Url(Config::get('base_url_application')));
                Registre::set('eFlore.urlCourante', self::getUrlCourante());
                Registre::set('eFlore.urlRedirection', self::getUrlRedirection());
                Registre::set('eFlore.urlPopUp', new Url(Config::get('base_url_application_popup')));
                Registre::set('eFlore.urlMobileTpl', Config::get('base_url_mobile'));

                Registre::set('parametres.referentiel', self::$parametres['referentiel']);
                Registre::set('parametres.module', self::$parametres['module']);
                Registre::set('parametres.action', self::$parametres['action']);
                Registre::set('parametres.niveau', self::$parametres['niveau']);
        }

        private static function chargerConfigReferentiel() {
                $chemin = Config::get('chemin_configurations').strtolower(self::$parametres['referentiel']).'.ini';
                Config::charger($chemin);
        }

        private static function getUrlCourante() {
                $url = false;
                if (isset($_SERVER['REQUEST_URI'])) {
                        $url = $_SERVER['REQUEST_URI'];
                }
                return ($url) ? new Url($url) : $url;
        }

        private static function getUrlRedirection() {
                $url = false;
                if (isset($_SERVER['REDIRECT_URL']) && !empty($_SERVER['REDIRECT_URL'])) {
                        if (isset($_SERVER['REDIRECT_QUERY_STRING']) && !empty($_SERVER['REDIRECT_QUERY_STRING'])) {
                                $url = $_SERVER['REDIRECT_URL'].'?'.$_SERVER['REDIRECT_QUERY_STRING'];
                        } else {
                                $url = $_SERVER['REDIRECT_URL'];
                        }
                }
                return ($url) ? new Url($url) : $url;
        }

        private static function chargerClasse($nom_classe) {
                $dossiers_classes = array(
                        Config::get('chemin_modules').self::getNomDossierModuleCourrant().DS,
                        Config::get('chemin_modules').self::getNomDossierDepuisClasse($nom_classe).DS,
                        Config::get('chemin_modeles').'api_0.1'.DS);

                foreach ($dossiers_classes as $chemin) {
                        $fichier_a_tester = $chemin.$nom_classe.'.php';
                        if (file_exists($fichier_a_tester)) {
                                include_once $fichier_a_tester;
                                return null;
                        }
                }
        }

        public static function getNomDossierDepuisParametre($parametre) {
                $dossier = str_replace('-', '_', strtolower($parametre));
                return $dossier;
        }

        public static function getNomDossierDepuisClasse($nomClasse) {
                $dossier = str_replace(' ', '_', strtolower(preg_replace('/(?<!^)([A-Z])/',' $0', $nomClasse)));
                return $dossier;
        }

        private static function getNomDossierModuleCourrant() {
                $dossier = self::getNomDossierDepuisParametre(self::$parametres['module']);
                return $dossier;
        }

        private static function getNomClasseModule() {
                $dossier = str_replace(' ', '', ucwords(str_replace('-', ' ', strtolower(self::$parametres['module']))));
                return $dossier;
        }

        private static function getNomMethodeAction() {
                $methode = 'executer'.
                        str_replace(' ', '', ucwords(str_replace('-', ' ', strtolower(self::$parametres['action']))));
                return $methode;
        }

        private static function executerModule() {
                $classeModule = self::getNomClasseModule();
                $action = self::getNomMethodeAction();
                // Nous vérifions que le module existe
                if (class_exists($classeModule)) {
                        $module = new $classeModule();

                        // Chargement Entete et Pied de page par défaut
                        $module->chargerEnteteGeneral();
                        $module->chargerMenuGeneral();
                        $module->chargerPiedGeneral();

                        // Initialisation du module demandé
                        if (method_exists($module, 'initialiser')) {
                                $module->initialiser();
                        }
                        // Lancement de l'action demandé du module chargé
                        if (method_exists($module, $action)) {
                                $module->$action();
                        } else {
                                $m = "La méthode '$action' du controleur '$classeModule' est introuvable.";
                                trigger_error($m, E_USER_ERROR);
                        }

                        self::fusionnerSortie($module->getSortie());
                } else {
                        $m = "La classe du controleur '$classeModule' est introuvable.";
                        trigger_error($m, E_USER_ERROR);
                }
        }

        /**
         * Fusionne un tableau de sortie par défaut avec le tableau renvoyé par l'action du module.
         * @param array le tableau à fusionner
         */
        private static function fusionnerSortie($sortie) {
                self::$parametres['sortie'] = array_merge(self::$parametres['sortie'], $sortie);
        }

        /**
         * Retourne le titre du contenu de l'application.
         */
        public static function getMetaTitre() {
                $contenu = self::$parametres['sortie']['titre'];
                $sortie = self::convertirEncodage($contenu);
                return $sortie;
        }

        /**
         * Retourne la description du contenu de l'application.
         */
        public static function getMetaDescription() {
                $contenu = self::$parametres['sortie']['description'];
                $sortie = self::convertirEncodage($contenu);
                return $sortie;
        }

        /**
         * Retourne les mots-clés (tags) du contenu de l'application.
         */
        public static function getMetaTags() {
                $contenu = self::$parametres['sortie']['tags'];
                $sortie = self::convertirEncodage($contenu);
                return $sortie;
        }

        /**
         * Retourne les informations à placer dans la balise HEAD du HTML.
         */
        public static function getEntete() {
                $contenu = self::$parametres['sortie']['entete'];
                $sortie = self::convertirEncodage($contenu);
                return $sortie;
        }

        /**
         * Retourne le contenu du corps de l'application.
         */
        public static function getContenuCorps() {
                $contenu = self::$parametres['sortie']['corps'];
                $sortie = self::convertirEncodage($contenu);
                return $sortie;
        }

        /**
         * Retourne le contenu de la tête de l'application.
         */
        public static function getContenuTete() {
                $contenu = self::$parametres['sortie']['tete'];
                $sortie = self::convertirEncodage($contenu);
                return $sortie;
        }

        /**
         * Retourne le contenu du pied de l'application.
         */
        public static function getContenuPied() {
                $contenu = self::$parametres['sortie']['pied'];
                $sortie = self::convertirEncodage($contenu);
                return $sortie;
        }

        /**
         * Retourne les éléments de navigation (onglet, fils d'ariane) de l'application.
         */
        public static function getContenuNavigation() {
                $contenu = self::$parametres['sortie']['navigation'];
                $sortie = self::convertirEncodage($contenu);
                return $sortie;
        }

        /**
         * Retourne les éléments du menu de l'application.
         */
        public static function getContenuMenu() {
                $contenu = self::$parametres['sortie']['menu'];
                $sortie = self::convertirEncodage($contenu);
                return $sortie;
        }

        /**
         * Retourne les chronos pris dans l'appli
         */
        public static function getChrono() {
                $sortie = '';
                if (Config::get('benchmark_chrono')) {
                        $chrono = Chronometre::afficherChrono();
                        $sortie = self::convertirEncodage($chrono);
                }
                return $sortie;
        }

        /**
         * Retourne les messages d'exceptions et d'erreurs.
         */
        public static function getExceptions() {
                $contenu = (Config::get('debogage')) ? GestionnaireException::getExceptions() : '';
                $sortie = self::convertirEncodage($contenu);
                return $sortie;
        }

        /**
         * Convertion du contenu de l'application (voir fichier config.ini : appli_encodage),
         * dans le format de sortie désiré (voir fichier config.ini : sortie_encodage).
         * Cette convertion a lieu seulement si les formats sont différents.
         */
        private static function convertirEncodage($contenu) {
                if (Config::get('sortie_encodage') != Config::get('appli_encodage')) {
                        $contenu = mb_convert_encoding($contenu, Config::get('sortie_encodage'), Config::get('appli_encodage'));
                }
                return $contenu;
        }
}
?>
Subversion Repositories eFlore/Applications.eflore-consultation

(root)/trunk/controleurs/AppControleur.php – Rev 1190
