* @copyright 2010 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$ */ abstract class AppliControleur extends Controleur { const RENDU_TETE = 'tete'; const RENDU_CORPS = 'corps'; const RENDU_PIED = 'pied'; const RENDU_NAVIGATION = 'navigation'; const RENDU_MENU = 'menu'; // FIXME : voir s'il est plus intéressant d'utiliser une méthode dans les classes filles protected $url = null; private $parametres = array(); protected $manuel = null; private $sortie = array(); private $messages = null; //+----------------------------------------------------------------------------------------------------------------+ // Constructeur public function __construct() { $registre = Registre::getInstance(); $this->parametres = $registre->get('parametres'); $this->url = $this->parametres['url']; // Chargement des infos du manuel technique des référentiels $this->manuel = parse_ini_file(Config::get('chemin_appli').DS.'..'.DS.'configurations'.DS.Config::get('manuel')); parent::__construct(); } //+----------------------------------------------------------------------------------------------------------------+ // Accesseurs /** * Retourne le tableau de sortie à utiliser dans le controleur principal de l'application. */ public function getSortie() { return $this->sortie; } /** * Attribue à la bonne position de sortie un contenu. */ protected function setSortie($position, $contenu, $fusionner = false) { if ($this->verifierExistencePosition($position)) { if ($fusionner) { $this->sortie[$position] .= $contenu; } else { $this->sortie[$position] = $contenu; } } } /** * Retourne le tableau des messages */ protected function getMessages() { return $this->messages; } /** * Ajoute un message */ protected function addMessage($message) { if ('' != $message) { $this->messages[] = $message; } } //+----------------------------------------------------------------------------------------------------------------+ // Méthodes /** * Vérifie l'existence de la position indiquée pour son utilisation dans le tableau de sortie. * @param string la position à tester. * @return bool true si la position est valide, sinon false. */ private function verifierExistencePosition($position) { $existe = true; if ($position != self::RENDU_TETE && $position != self::RENDU_CORPS && $position != self::RENDU_PIED && $position != self::RENDU_NAVIGATION && $position != self::RENDU_MENU) { trigger_error("La position '$position' n'est pas une valeur prédéfinie.", E_USER_WARNING); $existe = false; } return $existe; } /** * Execute l'action d'un module donnée et fusionne le résultat avec le tableau de sortie. */ protected function executerAction($ClasseModule, $action) { $module = new $ClasseModule(); $module->$action(); $this->fusionnerSortie($module->getSortie()); } protected function executerActionReferentiel($ClasseModule, $action, $referentiel, $afficheMoteur = null) { $module = new $ClasseModule(); $module->$action($referentiel, $afficheMoteur); $this->fusionnerSortie($module->getSortie()); } /** * Fusionne un tableau de sortie par défaut avec le tableau passé en paramêtre. * @param array le tableau à fusionner */ private function fusionnerSortie($sortie) { $this->sortie = array_merge($this->sortie, $sortie); } protected function postraiterDonnees(&$tableau) { if (count($tableau) > 0) { foreach ($tableau as $cle => &$valeur) { if ($valeur == '') { $valeur = ' '; } else if (is_string($valeur)) { $valeur = $this->remplacerEsperluette($valeur); } else if (is_array($valeur)) { $this->postraiterDonnees($valeur); } } } } protected function traiterEsperluette(&$tableau) { if (count($tableau) > 0) { foreach ($tableau as $cle => &$valeur) { if (is_string($valeur)) { $valeur = $this->remplacerEsperluette($valeur); } else if (is_array($valeur)) { $this->traiterEsperluette($valeur); } } } } protected function remplacerEsperluette($txt) { $txt = preg_replace('/&(?!([a-z]+|#[0-9]+|#x[0-9a-f]+);)/i', '&', $txt, -1); return $txt; } protected function supprimerSlash($doc) { if (is_string($doc)) { $doc = stripslashes($doc); } else if (is_array($doc) && count($doc) > 0) { foreach ($doc as $cle => $valeur) { $doc[$cle] = $this->supprimerSlash($valeur); } } return $doc; } protected function initialiserModulePrincipal() { $GLOBALS['module_principal'] = null; } protected function definirCommeModulePrincipal($module_nom) { $GLOBALS['module_principal'] = $module_nom; } private function getModulePrincipalCourant() { return $GLOBALS['module_principal']; } /** * Construction du menu et stockage dans le conteneur de sortie RENDU_MENU. * * @param string $referentiel code du référentiel. */ protected function construireMenu($referentiel) { $menu['nom'] = 'Accueil'; $menu['url'] = $this->obtenirUrlMenuAccueil(); $menu['activite'] = (($this->getModulePrincipalCourant() == 'Accueil') ? 'actif' : 'inactif'); $menu['title'] = "Liste des référentiels consultables."; $donnees['menus'][] = $menu; $menu['nom'] = 'Consultation'; $menu['url'] = $this->obtenirUrlMenuConsultation($referentiel); $menu['activite'] = ((preg_match('/^(?:Consultation|Recherche|FicheTaxon)$/', $this->getModulePrincipalCourant())) ? 'actif' : 'inactif'); $menu['title'] = "Interroger la base en cours de travail."; $donnees['menus'][] = $menu; $menu['nom'] = 'Arbre taxo'; $menu['url'] = $this->obtenirUrlMenuArbre($referentiel); $menu['activite'] = (($this->getModulePrincipalCourant() == 'Arbre') ? 'actif' : 'inactif'); $menu['title'] = "Consulter l'aborescence du référentiel"; $donnees['menus'][] = $menu; $menu['nom'] = 'Tests'; $menu['url'] = $this->obtenirUrlMenuTest($referentiel); $menu['activite'] = (($this->getModulePrincipalCourant() == 'Test') ? 'actif' : 'inactif securise'); $menu['title'] = "Réservé aux coordinateurs. Contrôler les données saisies."; $donnees['menus'][] = $menu; $menu['nom'] = 'Versionnage'; $menu['url'] = $this->obtenirUrlMenuVersionnage($referentiel); $menu['activite'] = (($this->getModulePrincipalCourant() == 'Versionnage') ? 'actif' : 'inactif securise'); $menu['title'] = "Réservé aux coordinateurs. Générer une version de la base."; $donnees['menus'][] = $menu; $menu['nom'] = 'Informations et téléchargements'; $menu['url'] = $this->obtenirUrlMenuInformations($referentiel); $menu['activite'] = (($this->getModulePrincipalCourant() == 'Informations') ? 'actif' : 'inactif'); $menu['title'] = "Informations sur le projet et téléchargements."; $donnees['menus'][] = $menu; $this->setSortie(self::RENDU_MENU, $this->getVue('menu', $donnees), false); } /** * Construction du fil d'ariane et stockage dans le conteneur de sortie RENDU_NAVIGATION. * * $referentiel code du référentiel * $id_traitement id du traitement * $id_resultat id du résultat */ protected function construireFilAriane($referentiel = null, $id_traitement = null, $id_resultat = null) { $entree['nom'] = 'Accueil'; $entree['url'] = $this->obtenirUrlMenuAccueil(); $donnees['entrees'][] = $entree; if (isset($referentiel)) { $entree['nom'] = 'Informations '.strtoupper($referentiel); $entree['url'] = $this->obtenirUrlDetailReferentiel($referentiel); $donnees['entrees'][] = $entree; $module_principal = $this->getModulePrincipalCourant(); if (isset($module_principal)) { $entree['nom'] = $module_principal; $entree['url'] = $this->obtenirUrlMenu($module_principal, $referentiel); $donnees['entrees'][] = $entree; } if (isset($id_traitement)) { $entree['nom'] = "Traitement #$id_traitement"; $entree['url'] = $this->obtenirUrlFicheTraitement($referentiel, $id_traitement); $donnees['entrees'][] = $entree; } if (isset($id_resultat)) { $entree['nom'] = "Résultat #$id_resultat"; $entree['url'] = $this->obtenirUrlFicheResultat($referentiel, $id_resultat); $donnees['entrees'][] = $entree; } } $this->setSortie(self::RENDU_NAVIGATION, $this->getVue('fil_ariane', $donnees), false); } protected function obtenirUrlDetailReferentiel($referentiel) { $this->url->setRequete(false); $this->url->setVariableRequete('module', 'Informations'); $this->url->setVariableRequete('ref', $referentiel); $url = $this->url->getURL(); $this->url->unsetVariablesRequete(array('module', 'action', 'ref')); return $url; } protected function obtenirUrlDetailReferentielTelechargement($referentiel) { $this->url->setRequete(false); $this->url->setVariableRequete('module', 'Informations'); $this->url->setVariableRequete('action', 'telecharger'); $this->url->setVariableRequete('ref', $referentiel); $url = $this->url->getURL(); $this->url->unsetVariablesRequete(array('module', 'action', 'ref')); return $url; } protected function obtenirUrlMenuInformations($referentiel) { return $this->obtenirUrlMenu('Informations', $referentiel); } protected function obtenirUrlMenuAccueil() { return $this->obtenirUrlMenu('Accueil'); } protected function obtenirUrlMenuTest($referentiel) { return $this->obtenirUrlMenu('Test', $referentiel); } protected function obtenirUrlMenuVersionnage($referentiel) { return $this->obtenirUrlMenu('Versionnage', $referentiel); } protected function obtenirUrlDemandeVersionnage($referentiel) { $this->url->setRequete(false); $this->url->setVariableRequete('module', 'Versionnage'); $this->url->setVariableRequete('action', 'demanderTraitement'); $this->url->setVariableRequete('ref', $referentiel); $url = $this->url->getURL(); $this->url->unsetVariablesRequete(array('module', 'action', 'ref')); return $url; } protected function obtenirUrlMenuConsultation($referentiel) { return $this->obtenirUrlMenu('Consultation', $referentiel); } protected function obtenirUrlMenuArbre($referentiel) { return $this->obtenirUrlMenu('Arbre', $referentiel); } protected function obtenirUrlMenuBranche($referentiel, $num_nom) { $this->url->setRequete(false); $this->url->setVariableRequete('module', 'Arbre'); $this->url->setVariableRequete('action', 'afficherBranche'); $this->url->setVariableRequete('ref', $referentiel); $this->url->setVariableRequete('num_nom', $num_nom); $url = $this->url->getURL(); $this->url->unsetVariablesRequete(array('module', 'action', 'ref', 'num_nom')); return $url; } protected function obtenirUrlMenuBrancheSynonyme($referentiel, $num_nom) { $this->url->setRequete(false); $this->url->setVariableRequete('module', 'Arbre'); $this->url->setVariableRequete('action', 'afficherBrancheSynonyme'); $this->url->setVariableRequete('ref', $referentiel); $this->url->setVariableRequete('num_nom', $num_nom); $url = $this->url->getURL(); $this->url->unsetVariablesRequete(array('module', 'action', 'ref', 'num_nom')); return $url; } private function obtenirUrlMenu($menu, $referentiel = null) { $this->url->setRequete(false); $this->url->setVariableRequete('module', $menu); if (isset($referentiel)) { $this->url->setVariableRequete('ref', $referentiel); } $url = $this->url->getURL(); $this->url->unsetVariablesRequete(array('module', 'ref')); return $url; } protected function obtenirUrlFicheTraitement($referentiel, $id_traitement) { $this->url->setRequete(false); $this->url->setVariableRequete('module', 'Traitement'); $this->url->setVariableRequete('id-t', $id_traitement); $this->url->setVariableRequete('ref', $referentiel); $url = $this->url->getURL(); $this->url->unsetVariablesRequete(array('module', 'id-t', 'ref')); return $url; } protected function obtenirUrlFicheResultat($referentiel, $id_resultat) { $this->url->setRequete(false); $this->url->setVariableRequete('module', 'Resultat'); $this->url->setVariableRequete('id-r', $id_resultat); $this->url->setVariableRequete('ref', $referentiel); $url = $this->url->getURL(); $this->url->unsetVariablesRequete(array('module', 'id-r', 'ref')); return $url; } protected function obtenirUrlRecherche($referentiel = null, $txt = null) { $this->url->setRequete(false); if (!is_null($referentiel)) { $this->url->setVariableRequete('ref', $referentiel); } $this->url->setVariableRequete('module', 'Recherche'); $this->url->setVariableRequete('action', 'rechercher'); if (!is_null($txt)) { $this->url->setVariableRequete('recherche', $txt); } $url = $this->url->getURL(); $this->url->unsetVariablesRequete(array('ref', 'module', 'action', 'recherche')); return $url; } protected function obtenirUrlFicheTaxon($referentiel, $num_nom = null) { $this->url->setRequete(false); $this->url->setVariableRequete('ref', $referentiel); $this->url->setVariableRequete('module', 'FicheTaxon'); if (!is_null($num_nom)) { $this->url->setVariableRequete('num_nom', $num_nom); } $url = clone $this->url; $this->url->unsetVariablesRequete(array('module', 'id')); return $url->getURL(); } /** * Lance l'ajout d'un traitement */ protected function ajouterTraitement($referentiel_code, $script_nom) { $this->ajouterTraitementParametre($referentiel_code, null, $script_nom); } /** * Lance l'ajout d'un traitement */ protected function ajouterTraitementParametre($referentiel_code, $parametres_serialises, $script_nom) { if (is_null($referentiel_code)) { $this->addMessage("Aucun code de projet de référentiel n'est indiqué (Ex. bdtfx)."); } else { $traitements_a_supprimer = null; $traitementDao = new TraitementDao(); $resultat_traitement_en_attente = $traitementDao->getTraitementsEnAttente($referentiel_code, $script_nom); if ($resultat_traitement_en_attente) { foreach ($resultat_traitement_en_attente as $traitement) { $difference = $this->differenceEnSecondeEntreDeuxDates($traitement['meta_date_creation'], date ("Y-m-d H:i:s")); Debug::printr("Différence attente : $difference > ".Config::get('ddv_traitement_attente')); if ($difference > Config::get('ddv_traitement_attente')) { $traitements_a_supprimer[] = $traitement['id_traitement']; $this->addMessage("Le traitement #{$traitement['id_traitement']} était en attente depuis plus de 5mn, il a été supprimé."); } else { $this->addMessage("Un traitement est déjà en attente..."); } } } else { $resultat_traitement_en_cours = $traitementDao->getTraitementsEnCours($referentiel_code, $script_nom); if ($resultat_traitement_en_cours) { foreach ($resultat_traitement_en_cours as $traitement) { $difference = $this->differenceEnSecondeEntreDeuxDates($traitement['date_debut'], date ("Y-m-d H:i:s")); Debug::printr("Différence en cours : $difference > ".Config::get('ddv_traitement_en_cours')); if ($difference > Config::get('ddv_traitement_en_cours')) { $traitements_a_supprimer[] = $traitement['id_traitement']; $this->addMessage("Le traitement #{$traitement['id_traitement']} était en cours depuis plus de 5mn, il a été supprimé."); } else { $this->addMessage("Un traitement est déjà en cours..."); } } } else { $resultat = $traitementDao->ajouterTraitementParametre($referentiel_code, $parametres_serialises, $script_nom); if ($resultat != false) { $this->addMessage("Le traitement #'$resultat' a été ajouté."); $this->lancerScript($referentiel_code, $script_nom); } else { $this->addMessage("Un problème est survenu lors de la tentative d'ajout du traitement."); } } } // Suppression des traitements posant problème if (count($traitements_a_supprimer) > 0) { $traitementDao->supprimer($traitements_a_supprimer); } } } private function differenceEnSecondeEntreDeuxDates($date_01, $date_02) { if (floatval(phpversion()) >= 5.3 ) { $d1 = new DateTime($date_01); $d2 = new DateTime($date_02); $difference_absolue = true; $diff = $d1->diff($d2, $difference_absolue); $nbre_secondes = $diff->format('s'); } else { $nbre_secondes = abs(round((strtotime($date_01) - strtotime($date_02)))); } return $nbre_secondes; } /** * Lance le script d'execution des traitements */ protected function lancerScript($referentiel_code, $script_nom) { $php = Config::get('chemin_bin_php'); $exe = Config::get('chemin_script'); $action = 'tout'; $log = Config::get('chemin_script_log'); $limite_memoire = Config::get('script_limite_memoire'); $commande = "$php -d memory_limit=$limite_memoire -f $exe $script_nom -p $referentiel_code -a $action > $log &"; if ($this->verifierSafeModeOff() === false) { $e = "Le safe_mode est actif sur ce serveur."; } else if ($this->verifierAccesFonctionExec() === false) { $e = "La fonction 'exec()' fait partie des fonctions désactivées sur ce serveur (voir disable_functions)."; } else { $this->addMessage("Lancement du script effectuant les traitements."); exec($commande); } // Affichage des message de paramêtrage du serveur si nécessaire if (Config::get('script_messages') == true) { $message_erreur_tpl = "%s\n.". "Il est nécessaire de configurer le lancement du script via une tache dans le cron.\n". "La commande à lancer est : $commande"; $this->addMessage(sprintf($message_erreur_tpl, $e)); } } private function verifierSafeModeOff() { return ('1' == ini_get('safe_mode')) ? false : true; } private function verifierAccesFonctionExec() { $disabled = explode(', ', ini_get('disable_functions')); return !in_array('exec', $disabled); } //+----------------------------------------------------------------------------------------------------------------+ // GESTION DES FICHIERS A TELECHARGER /** * Crée la liste d'url des fichiers à télécharger pour un traitement donné * @param Array $infos_traitement tableau contenant les informations du traitement * * @return Array un tableau contenant la liste des urls des fichiers à télécharger */ protected function obtenirUrlsZipPourTraitement($infos_traitement) { $urls_zip = array(); if (isset($infos_traitement['script']) && $infos_traitement['script'] == 'versionnage') { $meta = unserialize($infos_traitement['script_parametres']); $projet = strtolower($infos_traitement['referentiel_code']); $version = str_replace('.', '_', $meta['version']); $fichier_zip_bdnt = $projet.'_v'.$version.'.zip'; $url_zip_bdnt = sprintf(Config::get('url_zip_tpl'), $fichier_zip_bdnt); if ($this->testerUrl($url_zip_bdnt)) { $urls_zip[$fichier_zip_bdnt] = $url_zip_bdnt; } } return $urls_zip; } /** * Teste une url donnée, en tentant de l'ouvrir et de la fermer * * @return boolean un booléen indiquant le succès ou non de l'opération */ protected function testerUrl($url) { //TODO: voir si on peut inclure cette fonction dans le framework ini_set('allow_url_fopen', '1'); return (@fclose(@fopen($url, 'r'))) ? true : false; } //+----------------------------------------------------------------------------------------------------------------+ // GESTION DU CLIENT REST protected function getRestClient() { if (! isset($this->restClient)) { $this->restClient = new RestClient(); } return $this->restClient; } //+----------------------------------------------------------------------------------------------------------------+ // GESTION DE L'IDENTIFICATION protected function getAuthIdentifiant() { $id = (isset($_SERVER['PHP_AUTH_USER'])) ? $_SERVER['PHP_AUTH_USER'] : null; return $id; } protected function getAuthMotDePasse() { $mdp = (isset($_SERVER['PHP_AUTH_PW'])) ? $_SERVER['PHP_AUTH_PW'] : null; return $mdp; } public function authentifierCoordinateur() { $message_accueil = "Veuillez vous identifier avec votre adresse Tela Botanica et le mot de passe fourni."; $message_echec = "Accès limité aux coordinateurs du projet.\n". "Votre tentative d'identification a échoué.\n". "Actualiser la page pour essayer à nouveau si vous êtes bien inscrit comme coordinateur."; return $this->authentifier($message_accueil, $message_echec); } private function authentifier($message_accueil, $message_echec) { $id = $this->getAuthIdentifiant(); if (!isset($id)) { $this->envoyerAuth($message_accueil, $message_echec); } else { $autorisation = $this->etreCoordinateurAutorise($id); if ($autorisation == false) { $this->envoyerAuth($message_accueil, $message_echec); } } return true; } public function etreCoordinateurAutorise($identifiant) { $mdp = $this->getAuthMotDePasse(); $existe = ($mdp === Config::get('authentification.mdp')) ? true : false; $admin = $this->etreCoordinateur($identifiant) ? true : false; $autorisation = ($existe && $admin) ? true : false; return $autorisation; } public function etreCoordinateur($courriel) { $coordinateurs = Config::get('authentification.coordinateurs'); $courriels_autorises = explode(',', $coordinateurs); $autorisation = (in_array($courriel, $courriels_autorises)) ? true : false ; return $autorisation; } private function envoyerAuth($message_accueil, $message_echec) { header('HTTP/1.0 401 Unauthorized'); header('WWW-Authenticate: Basic realm="'.mb_convert_encoding($message_accueil, 'ISO-8859-1', 'UTF-8').'"'); header('Content-type: text/plain; charset=UTF-8'); print $message_echec; exit(0); } }