Subversion Repositories eFlore/Projets.eflore-projets

Rev

Rev 767 | Rev 847 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

<?php
/**
* Classe Commun.php est une classe abstraite qui contient les méthodes de base communes à tous les
* sous-services des projets.
*
* Encodage en entrée : utf8
* Encodage en sortie : utf8
* @package eflore-projets
* @author Jennifer DHÉ <jennifer.dhe@tela-botanica.org>
* @author Delphine CAUQUIL <delphine@tela-botanica.org>
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
* @version 1.0
* @copyright 1999-2011 Tela Botanica (accueil@tela-botanica.org)
*/

abstract class Commun {

        /** Objet Bdd. */
        private $Bdd = null;
        /** Objet Rest Client. */
        private $RestClient = null;

        /** Contients les paramètres. Doit remplacer table_param. */
        protected $parametres = array();
        /** Contients les ressources. Doit remplacer table_ressources. */
        protected $ressources = array();
        /** Le nom du service courrant. */
        protected $serviceNom = null;

        //Classe commune à tous les services web d'un projet. Contient par exemple les fonctions permettant de
        //renvoyer la réponse http...
        protected $entete_http; // Entete de la réponse correspondant au code de réponse de la requete http */
        protected $corps_http; // Tableau de résultat à retourner au format json ou la description de l'erreur si elle existe */
        protected $service; // Nom du service appelé
        /** Stocke la version du projet demandée dans la requete
         *  - "*" : (/#projet/* /meta-donnees) Renvoi les meta-données de toutes les versions du projet
         *  - "numero de la version" : (/#projet/2.00/meta-donnees) Renvoi les meta-données de la version 2.00 du projet */
        protected $version_projet = '+';
        protected $table_version; //Stocke les noms des tables de toutes les versions du projet disponibles
        /** tableau contenant tous les champs d'une table (est rempli par la fonction Commun::recupererNomChamp($table)) */
        protected $champs_table = array();
        private static $tri_multi_dimension = array();
        private static $tri_type = '';

        public function __construct($config = null) {
                $this->config = is_null($config) ? Config::get($this->serviceNom) : $config;
        }

        public function consulter($ressources, $parametres) {
                $this->ressources = $ressources;
                $this->parametres = $parametres;
                $this->chargerNomDuService();

                $this->traiterParametres();
                $this->traiterVersionProjet();

                $resultats = '';
                foreach ($this->table_version as $version) {
                        $this->table = $version; //on stocke le nom de la table correspondant à la version du projet en cours
                        $this->recupererNomChamp($this->table); //on récupère les noms des champs disponibles (Ds Commun.php)
                        $this->traiterRessources(); //dans CommunNomsTaxons.php
                        $requete = $this->assemblerLaRequete();// dans Noms ou Taxons...
                        $resultat = $this->getBdd()->recupererTous($requete . ' -- ' . __FILE__ . ':' . __LINE__ . ' (' .$this->table . ')');
                        $versionResultat = $this->traiterResultat($resultat, $version, $requete);
                        if (count($this->table_version) > 1) {
                                $resultats[$version] = $versionResultat;
                        } else {
                                $resultats = $versionResultat;
                        }
                }

                return $resultats;
        }

        private function chargerNomDuService() {
                $this->serviceNom = get_class($this);
        }

        public function traiterResultat($resultat, $version) {
                $versionResultat = null;
                if ($resultat == '') {
                        //cas ou la requete comporte des erreurs
                        $message = 'La requête SQL formée comporte une erreur!';
                        $code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
                        throw new Exception($message, $code);
                } elseif ($resultat) {
                        $versionResultat = $this->retournerResultatFormate($resultat, $version);
                } else {
                        $message = 'Les données recherchées sont introuvables.';
                        $code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
                        throw new Exception($message, $code);
                }
                return $versionResultat;
        }

        //+------------------------------------------------------------------------------------------------------+
        // Méthodes concernant les paramètres
        /**
         *  Permet de récupérer une liste des noms des champs de la table passée en paramètre
         *  @param $table : Nom de la table dont on souhaite connaitre les champs
         */
        public function recupererNomChamp($table) {
                $requete = 'SHOW FIELDS FROM '.$table;
                $resultat = $this->getBdd()->recupererTous($requete);
                if ($resultat == '') {
                        $e = 'La requête SQL formée comporte une erreur!';
                        $this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e);
                } elseif ($resultat) {
                        foreach ($resultat as $info) {
                                $this->champs_table[] = $info['Field'];
                        }
                } else {
                        $m = "La table recherchée n'existe pas";
                        $this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $m);
                }
        }

        /**
         * Fonction permettant de creer la table dont le nom est passé en paramètre (champs_api, champs_bdtfx,
         * correspondance_champs...). Les données de chaque table sont présentes dans le fichier de configuration config.ini
         * @param String $table : Peut contenir plusieurs nom de table dont on souhaite récupérer les données : table,table,table.
         *      Ex : recupererTableConfig('champs_api,champs_bdtfx')
         */
        public function recupererTableConfig($table) {
                $tables = explode(',', $table);
                foreach ($tables as $tab) {
                        $tableau = explode(',', Config::get($tab));
                        $tableau = array_map('trim', $tableau);
                        foreach ($tableau as $champ) {
                                list($code, $rang) = explode('=', $champ);
                                $tab_tampon[$code] = $rang;
                        }
                        $this->$tab = $tab_tampon;
                        $tab_tampon = array();
                }
        }

        public function renvoyerErreur($entete, $message) {
                throw new Exception($message, $entete);
        }

        /**
         * Permet de remplir la variable version_projet et de retirer cette donnée du tableau des ressources
         * @param $ressources
         */
        public function traiterVersionProjet() {
                if (isset($this->parametres['version.projet'])) {
                        if (preg_match('/^[0-9]+(?:[._][0-9]+|)$/', $this->parametres['version.projet'])) {
                                $this->version_projet = $this->parametres['version.projet'];
                                $this->version_projet = 'v'.str_replace('.', '_', $this->version_projet);
                        } else  {
                                $this->version_projet = $this->parametres['version.projet'];
                        }
                }
                //si la liste des noms est demandée pr toutes les versions, on affiche seulement la dernière version :
                if ($this->version_projet == '*' && $this->ressources == array()) {
                        $message = "L'affichage de plusieurs versions ne fonctionne que pour les ressources de type /ressources/#id";
                        $code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
                        throw new Exception($message, $code);
                }
                //on recupère les versions du projet disponible dans la table des meta-donnees (utilisation service MetaDonnees)
                $table_num_version = $this->recupererVersionDisponible();
                //on recupere la liste des noms des tables de la bdd correspondant aux differentes versions du projet en fct de la ou les versions demandées
                $this->recupererListeNomTablePrChaqueVersion($table_num_version);
        }

        /**
         * Recupération des versions disponibles par appel du service metaDonnees
         * Verification de l'existance du service recherché dans la requete (si précisé : hors *)
         * @return array  : tableau contenant le numéro de chaque version disponible
         */
        public function recupererVersionDisponible() {
                $versions_dispo = '';
                $req_version = 'SELECT version FROM '.Config::get('bdd_table_meta');
                $res_version = $this->getBdd()->recupererTous($req_version);
                if ($res_version == '') { //cas ou la requete comporte des erreurs
                        $e = "La requête SQL de versionnage formée comporte une erreur : $req_version";
                        $this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e);
                } elseif ($res_version) {
                        foreach ($res_version as $version) {
                                $versions_dispo[] = $version['version'];
                        }
                } else {
                        $m = 'Versions introuvables dans la table des méta-données';
                        $this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $m);
                }
                return $versions_dispo;
        }

        public function recupererListeNomTablePrChaqueVersion($table_num_version) {
                switch ($this->serviceNom) {
                        case 'Ontologies' :
                                $prefixe_table = 'bdd_table_ontologies';
                                break;
                        default:
                                $prefixe_table = 'bdd_table';
                }
                switch ($this->version_projet) {
                        case '+' :
                                $derniere_version = $table_num_version[count($table_num_version) - 1];
                                $this->table_version[] = Config::get($prefixe_table).'_v'.str_replace('.', '_', $derniere_version);
                                break;
                        case '*' :
                                foreach ($table_num_version as $num_version) {
                                        $this->table_version[] = Config::get($prefixe_table).'_v'.str_replace('.', '_', $num_version);
                                }
                                break;
                        default  :
                                $this->table_version[] = Config::get($prefixe_table).'_'.$this->version_projet;
                                break;
                }
        }

        //valeur * signifie pas de limites
        public function definirNavigationLimite($valeur){
                if (isset($this->parametres['navigation.limite'])  ) {
                        if ((preg_match('/^([0-9]+)$/', $valeur) && $valeur != 0 ) || $valeur == '*' ){
                                $this->limite_requete['limite'] = $valeur;
                        } else {
                                $e = "Erreur : valeur erronnée pour le paramètre navigation.limite.";
                                throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
                        }
                }
        }

        public function definirNavigationDepart($valeur){
                if (isset($this->parametres['navigation.depart'])) {
                        if(preg_match('/^([0-9]+)$/', $valeur)){
                                $this->limite_requete['depart'] = $valeur;
                        } else {
                                $e = "Erreur : valeur erronnée pour le paramètre navigation.depart.";
                                throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
                        }
                } else {
                        $e = "indiquez également la valeur pour le paramètre navigation.limite.";
                        throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
                }
        }
        /**
         * Est appelée pour former l'url complete des resultats precedants ou suivants.
         * @param int : Permet de connaitre le nombre de noms obtenus par la requete
         * @return string Retourne l'url complete des resultats precedents ou suivant sous la forme d'un tableau
         */
        public function formulerUrl($nb_resultat, $id = null) {
                $url = array();
                $debut_url = Config::get('url_service').$id.'?';
                //on recréé l'url sans les parametres de navigation qui seront rajoutés ci-apres. On les enlève dc de la table des parametres
                foreach($this->parametres as $cle => $val) {
                        $param_url[str_replace('_', '.', $cle)] = $val;
                }

                $this->recupererLesLimitesSuivantes($nb_resultat, $param_url);
                if (isset($param_url['navigation.depart']) && isset($param_url['navigation.limite'])) {
                        $url['suivant'] = $debut_url.http_build_query($param_url);
                }

                $this->recupererLesLimitesPrecedentes($param_url);
                if (isset($param_url['navigation.depart']) && isset($param_url['navigation.limite'])) {
                        $url['precedent'] = $debut_url.http_build_query($param_url);
                }
                return $url;
        }

        public function supprimerNavigation(&$param_url) {
                unset($param_url['navigation.depart']);
                unset($param_url['navigation.limite']);
        }

        /**
         * Description :
         * Permet de former les limites de la requete retournant les résultats suivants.
         * Cette url sera afficher dans l'entete de la reponse retournée en format JSON (retour.format=defaut).
         * @param int : $nb_resultat : Permet de connaitre le nombre de résultats obtenus par la requete
         * @return string : la fin de l'url decrivant les limites des resultats suivants. Si aucun résultats ne suient,
         * une chaine de caractère vide est retournée
         */
        public function recupererLesLimitesSuivantes($nb_resultat, &$param_url_suiv) {
                $this->supprimerNavigation($param_url);
                $depart = $this->limite_requete['depart'];
                $limite = $this->limite_requete['limite'];
                $depart_suivant = $depart + $limite;
                $limite_suivant = $limite;
                if ($nb_resultat > $depart_suivant) {
                        $param_url_suiv['navigation.depart'] = $depart_suivant;
                        $param_url_suiv['navigation.limite'] = $limite_suivant;
                } else {
                        $param_url_suiv['navigation.depart'] = null;
                        $param_url_suiv['navigation.limite'] = null;
                }
        }

        /**
         * Description :
         * Permet de former les limites de la requete retournant les résultats precedents.
         * Cette url sera afficher dans l'entete de la taxons/105reponse retournée en format JSON (retour.format=defaut)
         * @return string : la fin de l'url decrivant les limites des resultats precedents.
         * Si aucun résultats ne precedent, une chaine de caractère vide est retournée
         */
        public function recupererLesLimitesPrecedentes(&$param_url) {
                $this->supprimerNavigation($param_url);
                $depart = $this->limite_requete['depart'];
                $limite = $this->limite_requete['limite'];
                if ($depart == 0) {
                        $url_precedente = '';
                } else {
                        if (($depart - $limite) < 0) {
                                $depart_precedent = 0;
                        } else {
                                $depart_precedent = $depart - $limite;
                        }
                        $param_url['navigation.depart'] = $depart_precedent;
                        $param_url['navigation.limite'] = $limite;
                }
        }

        static function getDureeCache() {
                $dureecache = 0;
                $dureecache = Config::get('dureecache');
                if ($dureecache == null || !is_numeric($dureecache) || $dureecache < 0) {
                        $dureecache = 0;
                }
                return (int) $dureecache;
        }

        public function ajouterHref($service, $val) {
                // http://tela-botanica.org/service:eflore:0.1/[projet]/[version_projet]/[service]/[ressource]:[valeur]
                if ($this->version_projet == '+') {
                        $url = Config::get('url_service_base').Config::get('nom_projet').'/'.$service.'/'.$val;
                } else {
                        $url = Config::get('url_service_base').Config::get('nom_projet').'/'.$service.'/'.$val.'?version.projet='.ltrim($this->version_projet, 'v');
                }
                return $url;
        }

        public function ajouterHrefAutreProjet($service, $ressource, $valeur, $projet = null, $param = null) {
                //on enleve les GA et Co, les meta ou les "_"
                $this->transliterer($service, $valeur);
                //on définit les nom des projets, des services et des ressources de l'url (dans les méta-donnees)
                $tab = array(
                        'langue'                          => array('service' => 'langues', 'projet' => 'iso-639-1', 'ressource' => ''),
                        'couverture_spatiale' => array('service' => 'zone-geo', 'projet' => 'iso-3166-1', 'ressource' => ''),
                        'type'                            => array('service' => 'ontologies', 'projet' => 'eflore', 'ressource' => 'contactType:'),
                        'datum'                           => array('service' => 'ontologies', 'projet' => 'eflore', 'ressource' => 'datum:')
                );
                if (array_key_exists($service, $tab)) {
                        extract($tab[$service]);
                } else {
                        if (strpos(Config::get('nom_projet'), 'bd') === 0 && $projet == null) {
                                $projet                 = 'bdnt';
                                $service                = 'ontologies';
                                $ressource              = '';
                        }
                }
                $param = ($param) ? "?".$param : "";
                $url = Config::get('url_service_base').$projet.'/'.$service.'/'.$ressource.$valeur.$param;
                return $url;
        }

        /**Permet de consulter une url et retourne le résultat ou une erreur
         * @param $url   */
        public function consulterHref($url) {
                $res = $this->getRestClient()->consulter($url);
                $entete = $this->getRestClient()->getReponseEntetes();
                //Si le service meta-donnees fonctionne correctement, l'entete comprend la clé wrapper_data
                if (isset($entete['wrapper_data'])) {
                        $res = json_decode($res);
                        return $res;
                } else {
                        $u = 'L\'url <a href="'.$url.'">'.$url.'</a> lancée via RestClient renvoie une erreur';
                        $this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $u);
                }
        }

        public function transliterer(&$service, &$val) {
                if (preg_match('/^.+:(.+)$/', $val, $match)) {
                        $val = $match[1];
                }
                $service = str_replace(array('_Ga','_Co','_meta'), '', $service);
                if ($service == 'rang') {
                        $ressource = 'rangTaxo';
                } elseif (preg_match('/^(statut)(?:_|-)([^_-]+)$/', $service, $match)) {
                        $service = $match[1].ucfirst($match[2]);
                } elseif (strrpos($service, 'datum') !== false) {
                        $service = 'datum';
                }
        }

        // prend en arguments la valeur de la recherche, les résultats approchés, le paramétre recherche
        // retourne le tableau trié en fonction de la ressemblance entre le résultat approché et la valeur recherchée
        public function trierRechercheFloue($nom_demande, $tab_approchee, $nom) {
                $trie = '';
                $resultat = array();
                foreach ($tab_approchee as $id => $tab) {
                        $nom_demande_ss = strtolower(Chaine::supprimerAccents($nom_demande));
                        $nom_flou_ss = strtolower(Chaine::supprimerAccents($tab[$nom]));
                        $stat = array();
                        // Prime pour la ressemblance globale :
                        $score = 500 - levenshtein($nom_flou_ss, $nom_demande_ss);
                        // On affine
                        $score = $score + (similar_text($nom_demande_ss, $nom_flou_ss) * 3);
                        $stat['score'] = $score;
                        foreach ($tab as $key => $valeur) {
                                $stat[$key] = $valeur;
                        }
                        $resultat[] = $stat;
                }


                // Vérification que nous avons bien trouvé un nom approché
                if (count($resultat) > 0) {
                        $trie = Tableau::trierMD($resultat, array('score' => SORT_DESC));
                }
                return $trie;
        }

        protected function recupererTableauConfig($param) {
                $tableau = array();
                $tableauPartiel = explode(',', Config::get($param));
                $tableauPartiel = array_map('trim', $tableauPartiel);
                foreach ($tableauPartiel as $champ) {
                        if (strpos($champ, '=') === false) {
                                $tableau[] = $champ;
                        } else {
                                list($cle, $val) = explode('=', $champ);
                                $tableau[$cle] = $val;
                        }
                }
                return $tableau;
        }

        //+------------------------------------------------------------------------------------------------------+
        // Méthodes d'accès aux objets du Framework
        /**
         * Méthode de connection à la base de données sur demande.
         * Tous les services web n'ont pas besoin de s'y connecter.
         */
        protected function getBdd() {
                if (! isset($this->Bdd)) {
                        $this->Bdd = new Bdd();
                }
                return $this->Bdd;
        }

        /**
         * Méthode permettant de faire appel à un client REST en fonction des besoins du service.
         */
        protected function getRestClient() {
                if (! isset($this->RestClient)) {
                        $this->RestClient = new RestClient();
                }
                return $this->RestClient;
        }
}
?>