Subversion Repositories Applications.referentiel

<?php
/**
 * Service fournissant des informations sur les référentiels répondant aux critères de recherche
 * fournis en paramètre.
 * Encodage en entrée : utf8
 * Encodage en sortie : utf8
 * @author              Delphine CAUQUIL <delphine@tela-botanica.org>
 * @author              Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @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             $Id$
 * @copyright   2010 Tela-Botanica
 */

class Recherche extends Ref {

        /**
         * Méthode principale appelée avec une requête de type GET.
         * Elle sert d'aiguilleur pour appeller la méthode correspondant au type de recherche passé en paramêtre.
         */
        public function getElement($param = array()) {
                // Initialisation des variables
                $info = array();
                                
                // Nous recherchons le type de requête demandé
                $type = $param[0];
                                 
                $methode = 'getElement'.$type;
                if (method_exists($this, $methode)) {
                        array_shift($param);
                        $info = $this->$methode($param);
                } else {
                        $this->messages[] = "Le type de recherche demandé '$type' n'est pas disponible.";
                }
                
                // Envoie sur la sortie standard
                $this->envoyer($info);
        }
        
/* Méthode pour récupérer le nombre de taxons répondant à la requête
         * Appelée avec les paramètres d'url suivant :
         * /Recherche/Nombre/_
         * ou les _ représentent dans l'ordre : référentiel, mots, paramétres avancés
         * Si un des paramètres est absent, il prendre la valeur *
         */
        public function getElementNombre($param) {
                // Initialisation des variables
                $info = array();
                                
                // Pré traitement des paramètres
                $p = $this->pretraiterParametresUrl($param);
                $referentiel = substr($p['ref'], 2, -2); 

                // Construction de la requête
                // Il est important de compter le nombre de taxons pour l'affichage
                $requete =      (($this->distinct) ? 'SELECT DISTINCT' : 'SELECT').' COUNT(num_nom) AS nbre FROM '.$referentiel.
                                        $this->construireWhere($p).' ';

                // Récupération des résultats
                try {
                        $donnees = $this->bdd->query($requete)->fetch(PDO::FETCH_ASSOC);
                        if ($donnees === false) {
                                $this->messages[] = "La requête a retourné aucun résultat.";
                        } else {
                                $info = $donnees['nbre'];
                        }
                } catch (PDOException $e) {
                        $this->messages[] = sprintf($this->getTxt('sql_erreur'), $e->getFile(), $e->getLine(), $e->getMessage());
                }

                return $info;
        }
        
        /* Méthode pour récupérer une liste de taxons
         * Appelée avec les paramêtres d'url suivant :
         * /Recherche/ParDefaut/_
         * ou les _ représentent dans l'ordre : référentiel, mots, paramétres avancés
         * Si un des paramètres est absent, il prendre la valeur *
         */
        public function getElementParDefaut($param) {
                // Initialisation des variables
                $info = array();
                                
                // Pré traitement des paramètres
                $p = $this->pretraiterParametresUrl($param);
                $referentiel = substr($p['ref'], 2, -2); 
                
                // Construction de la requête          
                $requete =      (($this->distinct) ? 'SELECT DISTINCT' : 'SELECT').' num_nom, nom_complet, auteur, annee, '.
                                'biblio_origine, nom_addendum, num_nom_retenu FROM '.$referentiel.$this->construireWhere($p).
                                'ORDER BY '.((!is_null($this->orderby)) ? $this->orderby  : 'num_nom ASC, nom_complet ASC').' '.
                                "LIMIT $this->start, $this->limit ";
                                        
                // Récupération des résultats
                try {
                        $donnees = $this->bdd->query($requete)->fetchAll(PDO::FETCH_ASSOC);
                        if ($donnees === false) {
                                $this->messages[] = "La requête a retourné aucun résultat.";
                        } else {
                                $info = $donnees;
                        }
                } catch (PDOException $e) {
                        $this->messages[] = sprintf($this->getTxt('sql_erreur'), $e->getFile(), $e->getLine(), $e->getMessage());
                }
                return $info;
        }
        
        
        /* Méthode pour récupérer le nombre de taxons répondant à une requête sur la synonymie
         * Appelée avec les paramètres d'url suivant :
         * /Recherche/Nombre/_
         * ou les _ représentent dans l'ordre : référentiel, mots, paramétres avancés
         * Si un des paramètres est absent, il prendre la valeur *
         */
        public function getElementNombreTaxon($param) {
                // Initialisation des variables
                $info = array();
                                
                // Pré traitement des paramètres
                $p = $this->pretraiterParametresUrl($param);
                $referentiel = substr($p['ref'], 2, -2); 

                
                // Construction de la requête
                // Il est important de compter le nombre de taxons pour l'affichage
                $requete =      'SELECT count(DISTINCT num_nom_retenu) as nbr FROM '.$referentiel.$this->construireWhere($p).';';

                // Récupération des résultats
                try {
                        $donnees = $this->bdd->query($requete)->fetch(PDO::FETCH_ASSOC);
                        if ($donnees === false) {
                                $this->messages[] = "La requête a retourné aucun résultat.";
                        } else {
                                $info = $donnees['nbr'];
                        }
                } catch (PDOException $e) {
                        $this->messages[] = sprintf($this->getTxt('sql_erreur'), $e->getFile(), $e->getLine(), $e->getMessage());
                }

                return $info;
        }
        
        /* Méthode pour récupérer une liste de taxons
         * Appelée avec les paramêtres d'url suivant :
         * /Recherche/ParDefaut/_
         * ou les _ représentent dans l'ordre : référentiel, mots, paramétres avancés
         * Si un des paramètres est absent, il prendre la valeur *
         */
        public function getElementParTaxon($param) {
                // Initialisation des variables
                $info = array();
                                
                // Pré traitement des paramètres
                $p = $this->pretraiterParametresUrl($param);
                $referentiel = substr($p['ref'], 2, -2); 
                
                $liste_nom = $this->getNomRetenu($param);
                // Construction de la requête
                // si recherche des synonymes
                $requete = (($this->distinct) ? 'SELECT DISTINCT' : 'SELECT').' num_nom, nom_complet, auteur, annee, '.
                                        'biblio_origine, nom_addendum, num_nom_retenu FROM '.$referentiel.' WHERE num_nom_retenu IN ('
                                        .$liste_nom.') ORDER BY num_nom ASC ';
                try {
                        $info = '';
                                $donnees = $this->bdd->query($requete)->fetchAll(PDO::FETCH_ASSOC);
                                $info = $donnees;
                } catch (PDOException $e) {
                        $this->messages[] = sprintf($this->getTxt('sql_erreur'), $e->getFile(), $e->getLine(), $e->getMessage());
                }
                return $info;
        }
        
        /* Méthode pour récupérer une liste de noms retenus
         */
        public function getNomRetenu($param) {
                // Initialisation des variables
                $info = array();
                                
                // Pré traitement des paramètres
                $p = $this->pretraiterParametresUrl($param);
                $referentiel = substr($p['ref'], 2, -2); 
                
                // Construction de la requête
                // si recherche des synonymes
                $requete_nom_retenu =   'SELECT DISTINCT num_nom_retenu FROM '.$referentiel.$this->construireWhere($p)
                        ."ORDER BY num_nom ASC LIMIT $this->start, $this->limit ".';';
                try {
                        $info = '';
                        $donnees_nom_retenu = $this->bdd->query($requete_nom_retenu)->fetchAll(PDO::FETCH_ASSOC);

                        if ($donnees_nom_retenu === false) {
                                $this->messages[] = "La requête n'a retourné aucun résultat.";
                        } else {
                                $liste_nom = '';
                                foreach ($donnees_nom_retenu as $donnees_nom) {
                                        if ($donnees_nom['num_nom_retenu'] != '') {
                                                $liste_nom .= (!empty($liste_nom) ? ', ' : '').'"'.$donnees_nom['num_nom_retenu'].'"';
                                        }
                                }
                                $info = $liste_nom;
                        }
                } catch (PDOException $e) {
                        $this->messages[] = sprintf($this->getTxt('sql_erreur'), $e->getFile(), $e->getLine(), $e->getMessage());
                }
                return $info;
        }
        
        private function pretraiterParametresUrl($param) {
                // Tableau des paramètres qui peuvent être passés dans l'url
                $params_passes = array('ref' => 'str',
                        'mots' => 'str',
                        'sg' => 'str', 
                        'gen' => 'str', 
                        'sp' => 'str',
                        'ssp' => 'str',
                        'au' => 'str',
                        'an' => 'str',
                        'nn' => 'int',
                        'bib' => 'str',
                        'nr' => 'bool',
                        'tax' => 'bool');
                
                $p = $this->traiterParametresUrl(array_keys($params_passes), $param, false);
                $this->debug[] = $param;
                foreach ($params_passes as $param_passe => $type) {
                        if (isset($p[$param_passe])) {
                                // Suppression des éventuels espaces en début et fin de chaine
                                $valeur = trim($p[$param_passe]);
                                
                                // Type de paramètre chaine
                                if ($type == 'str') {
                                        // Suppression des slash
                                        $valeur = stripslashes($valeur);
                                        
                                        // Utilisation d'une recherche de chaîne exacte
                                        if (preg_match('/^"(.*)"$/', $valeur, $match)) {
                                                $valeur = '%'.$match[1].'%';
                                        } else {
                                                // Recherche de mots non liés
                                                $mots = explode(' ', $valeur);
                                                $valeur = '%'.implode ('%', $mots).'%';
                                        }
                                        // Mise en place des quotes pour l'interrogation dans la bdd
                                        $valeur = $this->bdd->quote($valeur);
                                }
                                // Type de paramètre booléen
                                if ($type == 'bool') {
                                        if (preg_match('/^[0]$/', $valeur)) {
                                                $valeur = false;
                                        } else if (preg_match('/^[1]$/', $valeur)) {
                                                $valeur = true;
                                        } else {
                                                $this->messages[] = "Le paramètre '$param_passe' attend une valeur de type 0 ou 1 et non '$valeur'.";
                                                $valeur = null;
                                        }
                                        
                                }
                                // Type de paramètre entier
                                if ($type == 'int') {
                                        if (!preg_match('/^(?:[0-9]+,\s*)*[0-9]+$/', $valeur)) {
                                                $this->messages[] = "Le paramètre '$param_passe' attend une ou plusieurs valeurs de type entiers ".
                                                        "séparés par des virgules et non '$valeur'.";
                                                $valeur = null;
                                        }
                                }
                                
                                $p[$param_passe] = $valeur;
                        }
                }
                
                return $p;
        }
        
        private function construireWhere($p) {
                // Initialisation de variables
                $where = ' WHERE ';
                
                // Construire where en fonction des paramêtres 
                if (isset($p['mots'])) {
                        $where .= 'AND ('.      
                                " num_nom LIKE {$p['mots']} ".
                                " OR num_nom_retenu LIKE {$p['mots']} ".
                                " OR num_tax_sup LIKE {$p['mots']} ".
                                " OR rang LIKE {$p['mots']} ".
                                " OR nom_complet LIKE {$p['mots']} ".
                                " OR nom_supra_generique LIKE {$p['mots']} ".
                                " OR genre LIKE {$p['mots']} ".
                                " OR epithete_infra_generique LIKE {$p['mots']} ".
                                " OR epithete_sp LIKE {$p['mots']} ".
                                " OR type_epithete LIKE {$p['mots']} ".
                                " OR epithete_infra_sp LIKE {$p['mots']} ".
                                " OR cultivar_groupe LIKE {$p['mots']} ".
                                " OR cultivar LIKE {$p['mots']} ".
                                " OR nom_commercial LIKE {$p['mots']} ".
                                " OR auteur LIKE {$p['mots']} ".
                                " OR annee LIKE {$p['mots']} ".
                                " OR biblio_origine LIKE {$p['mots']} ".
                                " OR notes LIKE {$p['mots']} ".
                                " OR nom_addendum LIKE {$p['mots']} ".
                                " OR homonyme LIKE {$p['mots']} ".
                                " OR basionyme LIKE {$p['mots']} ".
                                " OR synonyme_proparte LIKE {$p['mots']} ".
                                " OR synonyme_douteux LIKE {$p['mots']} ".
                                " OR synonyme_mal_applique LIKE {$p['mots']} ".
                                " OR synonyme_orthographique LIKE {$p['mots']} ".
                                " OR biblio_statut LIKE {$p['mots']} ".
                                " OR hybride_parent_01 LIKE {$p['mots']} ".
                                " OR hybride_parent_01_notes LIKE {$p['mots']} ".
                                " OR hybride_parent_02 LIKE {$p['mots']} ".
                                " OR hybride_parent_02_notes LIKE {$p['mots']} ".
                                " OR nom_francais LIKE {$p['mots']} ".
                                " OR presence LIKE {$p['mots']} ".
                                " OR statut_origine LIKE {$p['mots']} ".
                                " OR statut_introduction LIKE {$p['mots']} ".
                                " OR statut_culture LIKE {$p['mots']} ".
                                ') ';
                }
                if (isset($p['sg'])) {
                        $where .= "AND nom_supra_generique LIKE {$p['sg']} ";
                }
                if (isset($p['gen'])) {
                        $where .= "AND genre LIKE ({$p['gen']}) ";
                }
                if (isset($p['sp'])) {
                        $where .= "AND epithete_sp LIKE {$p['sp']} ";
                }
                if (isset($p['ssp'])) {
                        $where .= "AND epithete_infra_sp LIKE {$p['ssp']} ";
                }
                if (isset($p['au'])) {
                        $where .= "AND auteur LIKE {$p['au']} ";
                }
                if (isset($p['an'])) {
                        $where .= "AND annee LIKE ({$p['an']}) ";
                }
                if (isset($p['nn'])) {
                        $where .= "AND num_nom LIKE ({$p['nn']}) ";
                }       
                if (isset($p['bib'])) {
                        $where .= "AND biblio_origine LIKE ({$p['bib']}) ";
                }
                if (isset($p['nr']) && $p['nr'] == true) {
                        $where .= "AND num_nom_retenu = num_nom ";
                }
                
                
                $where = str_replace('WHERE AND', ' WHERE ', $where);
                
                
                // Retour du Where associé
                if (count($p) == 0) {
                        $where = "";
                }
                return $where;
        }
}
?>