eFlore/Projets.eflore-projetsApplications.annuaireApplications.bazarApplications.dictionnaireApplications.frameworkApplications.galerieApplications.gttApplications.papyrusApplications.projetApplications.referentielApplications.reseauApplications.wikinieFlore/Applications.bibliobotaeFlore/Applications.celeFlore/Applications.cel-consultationeFlore/Applications.coeleFlore/Applications.coel-consultationeFlore/Applications.deleFlore/Applications.eflore-consultationeFlore/Applications.moissonnageeFlore/Archives.cel-v1eFlore/Archives.cel-v2eFlore/Archives.chorologieeFlore/Archives.eflore-consultation-v1eFlore/Archives.eflore-consultation-v2eFlore/Archives.eflore-xuleFlore/Archives.herbierseFlore/Projets.communesSites.gentiana.orgSites.obs-saisons.frSites.outils-naturalistes.frSites.tela-botanica.org

BlueGreycalmElegant

Català-Valencià – Catalan中文 – Chinese (Simplified)中文 – Chinese (Traditional)Česky – CzechDansk – DanishNederlands – DutchEnglish – EnglishSuomi – FinnishFrançais – FrenchDeutsch – Germanעברית – Hebrewहिंदी – HindiMagyar – HungarianBahasa Indonesia – IndonesianItaliano – Italian日本語 – Japanese한국어 – KoreanМакедонски – Macedonianमराठी – MarathiNorsk – NorwegianPolski – PolishPortuguês – PortuguesePortuguês – Portuguese (Brazil)Русский – RussianSlovenčina – SlovakSlovenščina – SlovenianEspañol – SpanishSvenska – SwedishTürkçe – TurkishУкраїнська – UkrainianOëzbekcha – Uzbek

Compare Revisions

• This comparison shows the changes necessary to convert path

  → /branches/v5.12-baouque/services/modules @ 1172

  → /branches/v5.12-baouque/services/modules @ 1175

  ↔ Reverse comparison

• Compare Path:	Rev

  With Path:	Rev

No changes between revisions

Ignore whitespace Rev 1172 → Rev 1175

/branches/v5.12-baouque/services/modules/0.1/coste/A_LIRE.txt
New file
0,0 → 1,6
!!!Attention à vérifier dans le config.ini de eflore-consultation que cette ligne existe bien avec le paramètre
num_taxonomique : ( utile pour le web service Images )!!!
nomsRechercheDeterminationTpl = "{ref:nomsTpl}?masque={valeur}&recherche={type}
&ns.format=txt&retour.champs=nom_retenu,nom_retenu.*,num_taxonomique&navigation.limite=3000"
Property changes:
Added: svn:eol-style
+native
\ No newline at end of property
Added: svn:executable
+*
\ No newline at end of property

/branches/v5.12-baouque/services/modules/0.1/coste/Images.php
New file
0,0 → 1,213
<?php
/**
* classe pour web service qui affiche les images de Coste.
* il n'existe qu'une seule version pour les images de Coste : 2.00
* retour en application/json
*
* exemple d'appel du service :
* .../service:eflore:0.1/coste/images?masque.nt=1053
* .../service:eflore:0.1/coste/images?masque.nn=39594,39601
* .../service:eflore:0.1/coste/images
*
* paramètres disponibles : navigation.depart, navigation.limite, masque.nn, masque.nt
*
* @package eFlore/services
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @author Mathilde Salthun-Lassalle <mathilde@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)
*/
class Images extends Commun {
protected $table ;
private $requete_condition = array(" image != '' ");
private $champs_recherches = " num_nom, image, flore_bdtfx_nn, flore_bdtfx_nt ";
private $total_resultat;
protected $limite_requete = array('depart' => 0, 'limite' => 100);
private $masque = array();
public function consulter($ressources, $parametres) {
$this->ressources = $ressources;
$this->parametres = $parametres;
$this->traiterRessources();
$this->traiterParametres();
$this->table = config::get('bdd_table').'_v2_00';
$requete = $this->assemblerLaRequete();
$resultat = $this->getBdd()->recupererTous($requete);
$resultats = $this->formaterResultat($resultat);
return $resultats;
}
//+-----------------------------------traitement ressources et paramètres --------------------------------+
public function traiterRessources() {
if (empty($this->ressources) ) {
if (isset($this->parametres['masque.nn']) == false
&& isset($this->parametres['masque.nt']) == false) {
$this->requete_condition[] = " flore_bdtfx_nt != '' AND flore_bdtfx_nn != '' ";
}
} else {
$e = "La ressource {$this->ressources[0]} n'existe pas.";
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,$e);
}
}
public function traiterParametres() {
foreach ($this->parametres as $param => $val ) {
switch ($param) {
case 'masque.nt' :
$this->analyserMasque($val,'nt');
break;
case 'masque.nn' :
$this->analyserMasque($val,'nn');
break;
case 'referentiel' :
// ce paramètre est ignoré dans le cas de coste
// car seul le cel le prend en compte pour le moment
// on l'indique ici dans le switch car ce sont les mêmes url
// qui sont appelées pour le cel et coste (à retirer donc si ça change)
break;
case 'navigation.depart' :
$this->limite_requete['depart'] = $val;
break;
case 'navigation.limite' :
$this->limite_requete['limite'] = $val;
break;
default :
$e = 'Erreur dans les paramètres de recherche de votre requête : </br> Le parametre " '
.$param.' " n\'existe pas.';
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,$e);
break;
}
}
}
private function analyserMasque($valeur, $type_masque) {
$this->masque[] = "$type_masque=$valeur";
if (!$valeur) {
$e = 'renseignez une valeur pour masque.nn';
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,$e);
}
$arr = array_filter(array_map('intval', explode(',', $valeur)));
if(!$arr) $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, "valeur incorrecte pour masque.".$type_masque);
$this->requete_condition[] = sprintf(" flore_bdtfx_%s IN (%s)", $type_masque, implode(',', array_unique($arr)));
}
//+-------------------------------------------formatage résultats---------------------------------------------+
public function formaterResultat($resultat) {
$versionResultat['entete'] = $this->formaterEnteteResultat();;
if ($resultat == '') {
$message = 'La requête SQL formée comporte une erreur!';
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
throw new Exception($message, $code);
} elseif ($resultat) {
$versionResultat = $this->retournerResultatFormate($resultat);
} else {
$versionResultat['resultats'] = array();
}
return $versionResultat;
}
public function retournerResultatFormate($resultat) {
$resultat_json = array();
foreach ($resultat as $tab) {
$num_coste = $tab['num_nom'];
unset($tab['num_nom']);
$resultat_json['resultats'][$num_coste]['num_nomenclatural'] = $tab['flore_bdtfx_nn'];
$resultat_json['resultats'][$num_coste]['num_taxonomique'] = $tab['flore_bdtfx_nt'];
$resultat_json['resultats'][$num_coste]['binaire.href'] = $this->formaterUrlImage($tab['image']);
$resultat_json['resultats'][$num_coste]['mime'] = "images/png";
}
return $resultat_json;
}
public function formaterUrlImage($fichier) {
$chemin = config::get('donnees')."2.00/img/$fichier";
return $chemin;
}
public function formaterEnteteResultat() {
$entete['depart'] = $this->limite_requete['depart'];
$entete['limite'] = $this->limite_requete['limite'];
$entete['total'] = $this->total_resultat;
$entete['masque'] = empty($this->masque) ? 'aucun' : implode('&', $this->masque);
$url = $this->formulerUrl($this->total_resultat, '/images');
if (isset($url['precedent']) && $url['precedent'] != '') {
$entete['href.precedent'] = $url['precedent'];
}
if (isset($url['suivant']) && $url['suivant'] != '') {
$entete['href.suivant'] = $url['suivant'];
}
return $entete;
}
//+--------------------------FONCTIONS D'ASSEMBLAGE DE LA REQUETE-------------------------------------------+
public function assemblerLaRequete() {
$requete = ' SELECT '.$this->champs_recherches.' FROM '.$this->table.' '
.$this->retournerRequeteCondition().' '
.$this->delimiterResultatsRequete();
return $requete;
}
public function retournerRequeteCondition() {
$condition = '';
if (empty($this->requete_condition) == false) {
$condition = ' WHERE '.implode(' AND ', $this->requete_condition);
}
return $condition;
}
public function calculerTotalResultat() {
$requete = 'SELECT count(*) as nombre FROM '.$this->table.' '
.$this->retournerRequeteCondition();
$res = $this->getBdd()->recuperer($requete);
if ($res) {
$this->total_resultat = $res['nombre'];
} else {
$this->total_resultat = 0;
$e = 'Données introuvables dans la base';
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e);
}
}
public function delimiterResultatsRequete() {
$this->calculerTotalResultat();
$requete_limite = '';
if ((count($this->ressources)) == 0) {
if (($this->limite_requete['depart'] < $this->total_resultat) &&
(($this->limite_requete['limite'] + $this->limite_requete['depart'] )
< $this->total_resultat )) {
$requete_limite = 'LIMIT '.$this->limite_requete['depart'].', '
.$this->limite_requete['limite'];
}
}
return $requete_limite;
}
}
?>

/branches/v5.12-baouque/services/modules/0.1/coste/CommunNomsTaxons.php
New file
0,0 → 1,785
<?php
abstract class CommunNomsTaxons extends Commun {
protected $table_param = array(); /** Permet de stocker le tableau des parametres (= $parametres) */
protected $table_ressources = array(); /** Permet de stocker le tableau des ressources (= $ressources) */
protected $table_retour; /** Permet de stocker le tableau de résultat (non encodé en json)*/
protected $resultat_req; /** Permet de stocker le résultat de la requete principale. */
/** Permet de stocker sous forme de tableau les composant du nom à ajouter au nom scientifique (fonction du paramètre ns.structure) */
protected $compo_nom;
protected $ordre_masque = array('masque', 'masque_sg', 'masque_gen', 'masque_sp', 'masque_ssp', 'masque_au',
'masque_an', 'masque_bib', 'masque_ad', 'masque_nn', 'masque_rg' );
protected $tab_nom_sci = array('nom_supra_generique', 'genre', 'epithete_infra_generique', 'epithete_sp',
'type_epithete', 'epithete_infra_sp', 'cultivar_groupe', 'cultivar', 'nom_commercial');
protected $retour_format = 'max';
protected $html = 'txt'; /** Valeur du paramètre de requete ns.format */
protected $table_version; /** Stocke les noms des tables de toutes les versions du projet disponibles */
/** Nom de la table dans laquelle on récupèrera les données (remplace Config::get('bdd_table') dans les requetes SQL */
protected $table;
protected $total_resultat = null;
/** Stocke le service appelé correspondant. Est utilisé principalement lors de l'affichage du href d'un synonyme
(ex id=12, basionyme num 25 est un synonyme) dans le service taxon */
protected $service_href = null;
//----------------------------------Fonctions d'analyse des ressources--------------------------------------------------
/** Permet de remplir la variable version_projet et de retirer cette donnée du tableau des ressources */
public function traiterVersionProjet(&$ressources) {
if (isset($ressources) && !empty($ressources)) {
if (preg_match('/(?:[0-9]+(?:_|[.])[0-9]+|[*])/', $ressources[0])) {
$this->version_projet = array_shift($ressources);
$this->version_projet = str_replace('_', '.', $this->version_projet);
} else {
if ($ressources[0] == ' ') array_shift($ressources); //si un + a été ajouté
$this->version_projet = '+';
}
}
//si la liste des noms est demandée pr toutes les versions, on affiche seulement la dernière version pour :
// - la liste des noms et taxons: /noms et /taxons
// - la liste des taxons inferieurs/supérieur : /taxons/relations/inferieurs et /taxons/relations/superieurs
// - la liste des relations : /taxons/relations ou /noms/relations
if ($this->version_projet == '*' && ($ressources == array()
|| (isset($ressources[1]) && $ressources[1] == 'relations' && isset($ressources[2]) && in_array($ressources[2], array('superieurs', 'inferieurs')))
|| (isset($ressources[1]) && $ressources[1] == 'relations' && !isset($ressources[2])) )) {
$this->version_projet = '+';
}
//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);
}
public function traiterRessources($ressources) {
$this->table_ressources = $ressources;
if (isset($ressources) && !empty($ressources)) {
if ($this->estUnIdentifiant()) { //l'identifiant peut etre de type /#id ou /nt:#id
$this->traiterRessourcesIdentifiant(); // dans le service noms ou taxons
} elseif ($this->table_ressources[0] == 'stats') { //ressource = noms/stats
$this->traiterRessourcesStats();
} else {
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur dans votre requete </br> Ressources disponibles : <br/>
<li> /'.$this->service.'/#id (id : L\'identifiant du nom rechercher)</li>
<li> /'.$this->service.'/nt:#id (id : Numero du taxon recherche)</li>
<li> /'.$this->service.'/stats </li>' );
}
}
}
public function traiterRessourcesStats() {
$this->format_reponse = $this->service.'/stats';
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) {
switch ($this->table_ressources[1]) {
case 'annees' :
$this->traiterRessourceStatsAnnees();
break;
case 'rangs' :
$this->traiterRessourceStatsRangs();
break;
case 'initiales' :
$this->traiterRessourceStatsInitiales();
break;
default :
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur dans votre requete </br> Ressources disponibles : <br/>
<li> /'.$this->service.'/stats/annees </li>
<li> /'.$this->service.'/stats/rangs </li>
<li> /'.$this->service.'/stats/initiales </li>' );
break;
}
} else {
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur dans votre requete </br> Ressources disponibles : <br/>
<li> /'.$this->service.'/stats/annees </li>
<li> /'.$this->service.'/stats/rangs </li>
<li> /'.$this->service.'/stats/initiales </li>' );
}
}
/** Vérifie si la première valeur de la table de ressource est un identifiant : un numerique ou un numéro
* taxonomique sous la forme nt:xx */
public function estUnIdentifiant() {
return (is_numeric($this->table_ressources[0]) || (strrpos($this->table_ressources[0],'nt:') !== false
&& is_numeric(str_replace('nt:','',$this->table_ressources[0]))));
}
//---------------------------------------------Fonction d'analyse des parametres----------------------------------------
/** Permet de remplir le tableau compo_nom. Il comprendra en fct du paramètre ns.structure les éléments à rajouter
* au nom_sci (annee, auteur, biblio ou addendum).*/
public function remplirTableCompositionNom($valeur) {
$structure_nom = explode(",",$valeur);
foreach ($structure_nom as $structure) {
switch ($structure) {
case 'au' : $this->compo_nom['au'] = 'auteur'; break;
case 'an' : $this->compo_nom['an'] = 'annee'; break;
case 'bib' : $this->compo_nom['bib'] = 'biblio_origine'; break;
case 'ad' : $this->compo_nom['ad'] = 'nom_addendum'; break;
default : $this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur : Le parametre "'.$structure.'" n\'existe pas. <br/><br/>
Les parametres du nom possibles sont : <li> au (auteur)</li><li> an (annee)</li>
<li> bib (bibliographie)</li><li> ad (nom_addendum)</li>');
break;
}
}
}
/** Permet de recupérer le nom scientigfique au format html. Le champ nom_sci de la requete sql est remplacé par
* le champ nom_sci_html */
public function mettreAuFormat() {
if ($this->html == 'htm') {
if (strrpos($this->requete_champ, 'nom_sci_html as nom_sci') === false) {
$this->requete_champ = str_replace('nom_sci', 'nom_sci_html as nom_sci', $this->requete_champ);
}
} elseif ($this->html != 'txt') {
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur dans votre requete </br> ns.format = htm ou txt (par defaut)' );
}
}
//--------------------------------fonctions de formatage----------------------------------------------------------
/** 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 : recupererTableSignification('champs_api,champs_bdtfx') */
public function recupererTableSignification($table) {
$tables = explode(',', $table);
foreach ($tables as $tab) {
if ($tab == 'champs_comp') {
$champ_bdnff_api = array_keys($this->champs_api); //on recupère le nom des champ ds la bdd
$this->champs_comp = array_diff($this->champs_table, $champ_bdnff_api);
} elseif ($tab == 'champs_api') {
foreach ($this->correspondance_champs as $key => $val) {
preg_match('/(hybride[.]parent_0[12](?:[.]notes)?|nom_sci[.][^.]+|[^.]+)(?:[.](id|code))?/', $val, $match);
$val = $match[1];
$this->champs_api[$key] = $val;
}
} else {
$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 formaterEnOss($resultat) {
$res = array();
$table_nom = array();
foreach ($resultat as $version => $res_version) {
$oss = '';
foreach ($res_version as $tab) {
if (isset($tab['nom_sci']) ) {
if (!in_array($tab['nom_sci'], $table_nom)) {
$table_nom[] = $tab['nom_sci'];
$oss [] = $tab['nom_sci'].$this->ajouterCompositionNom($tab);
}
}
}
$masque = $this->ordonnerMasque();
if ($masque == '') $masque = 'Pas de masque';
$table_retour_oss = array($masque, $oss);
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version
$res = $this->afficherVersionOuPas($version, $table_retour_oss, $res);
}
return $res;
}
/** Permet de récupérer le masque de rang superieur parmi les parametres de la requete.
* Sera affiche dans l'entete du fichier json (clé 'masque') et oss.
* @return string le masque de rang supérieur ou '' si aucun masque n'a été mis en parametre de
* requete (la clé masque ne sera alors pas affichée dans l'entete).*/
public function ordonnerMasque() {
$masque = '';
foreach ($this->ordre_masque as $key => $filtre) {
if (isset($this->table_param[$filtre])) {
$masque .= '&'.$filtre.'='.$this->table_param[$filtre];
}
}
$masque = ltrim($masque, '&'); //on enlève le & du début
$masque = str_replace('masque_','',$masque);
return $masque;
}
/** Affiche l'entete du résultat pour le service /noms et /noms/relations. L'entete comprend le rang (s'il est un
* filtre), le départ, la limite, le total des résultats et les urls suivante et precedente. */
public function afficherEnteteRangBorneTotalUrls($resultat, $url_service) {
if (isset($this->table_param['masque_rg'])) $this->afficherDonnees('rang', $this->table_param['masque_rg']);
$this->table_retour['depart'] = $this->limite_requete['depart'];
$this->table_retour['limite'] = $this->limite_requete['limite'];
$this->table_retour['total'] = $this->total_resultat;
//formuler les urls precedentes et suivantes
$url = $this->formulerUrl($this->total_resultat, $url_service);
if ($url['precedent'] != '') { $this->table_retour['href.precedent'] = $url['precedent']; }
if ($url['suivant'] != '') { $this->table_retour['href.suivant'] = $url['suivant']; }
}
//----------------------------Fonction de formatage pour les services /#id/---------------------------------------------
/** Ajout du numero de la version au tableau de résultat à retourner :
* 'bdtfx_v2_00' : {'infos' : 'toto' ...}, 'bdtfx_v3_00' : {'infos' : 'tata' ...}
* @param string $num_version : numéro de version (sous la forme de l'intitulé du nom de la table bdd)
* @param array $tab : tableau contenant le resultat à retourner pour une version donnée
* @param array $res : tableau contenant le resultat à retourner pour toutes les versions disponibles */
public function afficherVersionOuPas($version, &$tab, &$res) {
if (count($this->table_version) > 1) {
$res[$version] = $tab;
$tab = array();
} else {
$res = $tab;
}
return $res;
}
public function formaterId($resultat) {
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
$res = array();
foreach ($resultat as $version => $res_version) {
$res_version = $res_version[0];
$this->resultat_req = $res_version;
foreach ($res_version as $key => $valeur) {
if ($valeur != '') {
$this->afficherDonnees($key, $valeur);
}
}
unset($this->table_retour['href']);
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version
$res = $this->afficherVersionOuPas($version, $this->table_retour, $res);
}
return $res;
}
public function formaterIdChamp($resultat) {
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
$res = array();
foreach ($resultat as $version => $res_version) {
$res_version = $res_version[0];
$this->resultat_req = $res_version;
$this->table_retour['id'] = $res_version['num_nom'];
//on récupère les champs (le + est transformé en espace par le navigateur)
$tab_ress = explode(' ', $this->table_ressources[1]);
foreach ($tab_ress as $nom_champ_api) {
if ($this->verifierValiditeChamp($nom_champ_api)) {
switch ($nom_champ_api) {
case 'nom_sci' : $this->afficherNomSci($res_version); break;
case 'nom_sci.*' : $this->afficherNomSciPointEpithete($res_version); break;
case 'hybride.*' :
$this->afficherChamps('hybride.parent_01.*', $res_version['hybride_parent_01']);
$this->afficherChamps('hybride.parent_02.*', $res_version['hybride_parent_02']); break;
default :
$this->afficherChamps($nom_champ_api,
$res_version[$this->trouverChampBddCorrespondant($nom_champ_api)]); break;
}
}
}
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version
$res = $this->afficherVersionOuPas($version, $this->table_retour, $res);
}
return $res;
}
/** Les champs passés dans l'url lors de la requete /noms|taxons/#id/#champ+#champ son sous la forme de l'api.
* Les noms de l'api ne st pas les meme que ceux des champs de la base de données.
* Cette fct permet de récupérer le nom du champs de la base de données */
public function trouverChampBddCorrespondant($champ) {
$radical_champ = $champ;
if ($this->estUnPoint($champ) && strrpos($champ, '.notes') === false) {
preg_match('/^(?:([^.]+\.parent_0[12]|[^.]+))(?:\.(.+))?$/', $champ, $match);
$radical_champ = $match[1];
}
// - Soit un champ de l'api est recherché (pour les champs du référentiel : les noms des champs ont été modifiés),
// - Soit un champ complementaire de la bdnff (les noms de ces champs complementaire sont les memes que ds la base)
if ($this->estChampApi($radical_champ)) {
$champ_bdd = array_search($radical_champ, $this->champs_api);
} elseif ($this->estDansBdnff($radical_champ)) {
$champ_bdd = $radical_champ;
} else {
$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Fct trouverChampBddCorrespondant : Le parametre "'.$radical_champ.'" n\'existe pas. <br/><br/>');
}
return $champ_bdd;
}
/** Permet d'afficher des informations précisées des données liées. Utilisé par le service id/champ
* lors de l'appel d'un champ tel que : champ.id, champ.code, champ.*, champ.href. */
public function afficherChamps($champ, $valeur) {
$reponse = $this->table_retour;
$this->table_retour = array();
if ($valeur == '') {
$this->table_retour[$champ] = null;
} else {
preg_match('/^(?:([^.]+\.parent_0[12]|[^.]+))(?:\.(.+))?$/', $champ, $match);
//si on a un point etoile
if (isset($match[2]) && $match[2] == '*') {
$this->afficherPointEtoile($match[1], $valeur);
//si le champ comprend plusieurs identifiants : pour le champ proparte (liste ou .details recherché, pas de .href)
} elseif ($this->presentePlusieursId($match[1], $valeur)) {
if (isset($match[2]) && $match[2] != 'id') {
$this->afficherInfosPrecises($match[1], $match[2], $valeur);
} else {
$this->table_retour[str_replace('.id', '', $champ)] = $valeur;
}
//si on est en présence d'une donnée liée (la donnée représente un identifiant ou un code)
} elseif ($this->correspondAUnId($match[1]) || $champ == 'id' || $this->correspondAUnCode($match[1])) {
if (isset($match[2])) { //si un .id, un .code ou un .href est demandé :
$this->afficherInfosPrecises($match[1], $match[2], $valeur);
} else {
$this->afficherInfosPrecises($match[1], 'signification', $valeur);
}
//sinon on affiche tel quel
} else {
$this->table_retour[$champ] = $valeur;
}
}
$this->table_retour = array_merge($reponse, $this->table_retour);
}
/**Vérifie la validité d'un champ passé dans la requete /#id/#champ+#champ */
public function verifierValiditeChamp($champ) {
preg_match('/^(?:([^.]+\.parent_0[12]|[^.]+))(?:\.(.+))?$/', $champ, $match);
$radical_champ = $match[1];
$validite_ressource = true;
//on verifie si le nom du champ existe bien
if (!$this->estChampApi($radical_champ) && !$this->estDansBdnff($radical_champ)) {
$validite_ressource = false;
$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Fct verifierValiditeChamp : Le parametre "'.$radical_champ.'" n\'existe pas. <br/><br/>');
} elseif ($this->estUnPoint($champ)) {
$suffixe = $match[2];
//On verifie les suffixes pour les identifiants
if ($this->correspondAUnId($radical_champ) || $radical_champ == 'id') {
$this->verificationSuffixesIdentifiant($suffixe, $radical_champ, $validite_ressource);
//On verifie les suffixes pour les codes
} elseif ($this->correspondAUnCode($radical_champ)) {
$this->verficationSuffixesCodes($suffixe, $radical_champ, $validite_ressource);
} elseif ($radical_champ == 'nom_sci' && $suffixe != '*') {
$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur : Le suffixe demand&eacute; n\'existe pas pour le champ "'.$radical_champ.'".<br/>
Les suffixes possibles sont les suivants : <li> * </li>');
} else {
$validite_ressource = false;
$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur : Le parametre "'.$radical_champ.'" ne peut pas pr&eacute;senter de suffixe. <br/><br/>');
}
}
return $validite_ressource;
}
public function verficationSuffixesCodes(&$suffixe, &$radical_champ, &$validite_ressource ) {
if (!in_array($suffixe, array('*', 'code', 'href', 'details'))) {
$validite_ressource = false;
$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur : Le suffixe demand&eacute; n\'existe pas pour le champ "'.$radical_champ.'.<br/>
Les suffixes possibles sont les suivants :
<li> .* </li><li> .code </li><li> .href </li><li> .details </li>');
}
}
public function verificationSuffixesIdentifiant(&$suffixe, &$radical_champ, &$validite_ressource) {
if ((strrpos($radical_champ, 'parent') !== false && !in_array($suffixe, array('*', 'id', 'href', 'details', 'notes')))
|| !in_array($suffixe, array('*', 'id', 'href', 'details')) && strrpos($radical_champ, 'parent') === false) {
$validite_ressource = false;
$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur : Le suffixe demand&eacute; n\'existe pas pour le champ "'.$radical_champ.'".<br/>
Les suffixes possibles sont les suivants :
<li> .* </li><li> .id </li><li> .href </li><li> .details </li><li> .notes (seulement pour les hybride.parent)');
}
}
//------------------------------fonction de formatage pour les services /stats/-----------------------------------------
public function formaterStatsAnnee($resultat) {
$res = array();
foreach ($resultat as $version => $res_version) {
foreach ($res_version as $cle_annee) {
foreach ($cle_annee as $key => $val) {
switch($key) {
case 'annee' : $annee = ($val != '') ? $val : 'N.D.'; break;
case 'nombre': $nb = $val; break;
default : break;
}
}
$retour_stats_annee[$annee] = $nb;
}
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version
$res = $this->afficherVersionOuPas($version, $retour_stats_annee, $res);
}
return $res;
}
public function formaterStatsRang($resultat) {
$res = array();
foreach ($resultat as $version => $res_version) {
foreach ($res_version as $rangs) {
if ($rangs['rang'] != 0) {
foreach ($rangs as $key => $val) {
switch ($key) {
case 'rang' : $rang = $val; break;
case 'nombre' : $nombre = $val; break;
default : break;
}
}
$retour_rang[$rang] = array(
'rang' => $this->ajouterSignificationCode('rang', $rang),
'nombre' => $nombre
);
}
}
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version
$res = $this->afficherVersionOuPas($version, $retour_rang, $res);
}
return $res;
}
public function formaterStatsInitiales($resultat) {
$res = array();
$table_rang = array();
foreach ($resultat as $version => $res_version) {
foreach ($res_version as $tuple) {
if ($tuple['rang'] != 0) {
if (!isset($table_rang[$tuple['rang']])) {
$rang = $this->ajouterSignificationCode('rang', $tuple['rang']);
$table_rang[$tuple['rang']] = $rang;
} else {
$rang = $table_rang[$tuple['rang']];
}
if ($tuple['lettre'] == 'x ') {
if (isset($this->table_retour[$rang]['hyb'])) {
$this->table_retour[$rang]['hybride'] += floatval($tuple['nb']);
} else {
$this->table_retour[$rang]['hybride'] = floatval($tuple['nb']);
}
} elseif ($tuple['lettre'] == '+ ') {
if (isset($this->table_retour[$rang]['chimère'])) {
$this->table_retour[$rang]['chimère'] += floatval($tuple['nb']);
} else {
$this->table_retour[$rang]['chimère'] = floatval($tuple['nb']);
}
} else {
$l = substr($tuple['lettre'], 0, 1);
if (isset($this->table_retour[$rang][$l])) {
$this->table_retour[$rang][substr($tuple['lettre'], 0, 1)] += floatval($tuple['nb']);
} else {
$this->table_retour[$rang][substr($tuple['lettre'], 0, 1)] = floatval($tuple['nb']);
}
}
}
}
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version
$res = $this->afficherVersionOuPas($version, $this->table_retour, $res);
}
return $res;
}
//-----------------------------Fonctions d'affichage utiliser dans les fonctions de formatage---------------------------
/** Affiche les résultats en fonction du paramètre retour_format. */
public function afficherDonnees($key, $valeur) {
//on souhaite afficher le nom au format de l'api
if ($this->retour_format == 'min') {
if ($this->correspondAChampApi($key)) { //on affiche l'intitulé selon decrit dans l'api
if ($key == 'nom_sci') $valeur = $valeur.$this->ajouterCompositionNom($this->resultat_req);
$this->table_retour[$this->correspondance_champs[$key]] = $valeur;
} else {
$this->table_retour[$key] = $valeur;
}
} else {
if ($this->correspondAChampApi($key)) {
$nom_champ_api = $this->correspondance_champs[$key]; //on récupere le nom comme définit ds l'api
$this->afficherToutesLesInfos($nom_champ_api, $valeur);
} elseif ($this->estDansBdnff($key)) {
$this->table_retour[$key] = $valeur;
}
}
}
public function afficherToutesLesInfos($nom_champ_api, $valeur) {
if ($this->presentePlusieursId($nom_champ_api, $valeur)) {
preg_match('/^([^.]+\.parent_0[12]|[^.]+)(?:\.id)?$/', $nom_champ_api, $match);
$this->afficherInfosPrecises($match[1], 'details', $valeur);
$this->table_retour[$nom_champ_api] = $valeur;
} elseif (strrpos($nom_champ_api, 'parent') !== false && strrpos($nom_champ_api, 'notes') !== false) {
$this->table_retour[$nom_champ_api] = $valeur;
} elseif (($this->correspondAUnId($nom_champ_api) || $nom_champ_api == 'id') && $valeur != '0') {
preg_match('/^([^.]+\.parent_0[12]|[^.]+)(?:\.id)?$/', $nom_champ_api, $match);
$this->afficherInfosPrecises($match[1], 'id,signification,href', $valeur);
} elseif ($this->correspondAUnCode($nom_champ_api)) {
preg_match('/^([^.]+)(?:\.code)?$/', $nom_champ_api, $match);
$this->afficherInfosPrecises($match[1], 'code,signification,href', $valeur);
}
}
public function presentePlusieursId($ressource, $valeur = null) {
if ($valeur) {
$presente = strrpos($ressource, 'proparte') !== false && strrpos($valeur, ',') !== false;
} else { //pour la vérification du champ, on ignore alors la valeur de la ressource
$presente = strrpos($ressource, 'proparte') !== false;
}
return $presente;
}
public function afficherTableDetails($nom_champ_api, $valeur) {
$tab_id = explode(',',$valeur);
$tab_res = $this->table_retour;
$this->table_retour = array();
foreach ($tab_id as $id) {
$this->afficherInfosPrecises($nom_champ_api, 'id,signification,href', $id);
$tab_res[$nom_champ_api.'.details'][] = $this->table_retour;
$this->table_retour = array();
}
$this->table_retour = $tab_res;
}
public function afficherPointEtoile($champ, $valeur) {
if ($this->presentePlusieursId($champ, $valeur)) {
$this->afficherInfosPrecises($champ, 'details', $valeur);
$this->table_retour[$champ] = $valeur;
} elseif (strrpos($champ, 'parent') !== false) {
$this->afficherInfosPrecises($champ, 'id,href,notes', $valeur);
} elseif ($this->correspondAUnId($champ) || $champ == 'id') {
$this->afficherInfosPrecises($champ, 'id,href', $valeur);
} elseif ($this->correspondAUnCode($champ)) {
$this->afficherInfosPrecises($champ, 'code,href', $valeur);
}
}
public function afficherInfosPrecises($champ, $suffixe, $valeur) {
$suffixes = explode(',', $suffixe);
//on initialise au service appelé. Sera potentiellement modifié dans la fonction afficherSignification()
$this->service_href = $this->service;
foreach ($suffixes as $suff) {
switch ($suff) {
case 'id' :
$this->table_retour[str_replace('id.id', 'id', $champ.'.id')] = $valeur;
break;
case 'details' :
$this->afficherTableDetails($champ, $valeur);
break;
case 'signification' :
$this->afficherSignification($champ, $valeur);
break;
case 'href' :
if ($this->correspondAUnId($champ) || $champ == 'id') {
$service = $this->service_href;
$url = $this->ajouterHref($service, $valeur);
} else {
$service = 'ontologies';
$champ_url = $champ;
$url = $this->ajouterHrefAutreProjet($service, $val, $champ_url);
}
$this->table_retour[str_replace('id.href', 'href', $champ.'.href')] = $url;
break;
case 'code' :
$val = ( $champ == 'rang' ) ? 'bdnt.rangTaxo:'.$valeur : 'bdnt.'.rtrim($champ, '_Ga,_Co').':'.$valeur;
$this->table_retour[$champ.'.code'] = $val;
break;
case 'notes' :
$this->table_retour[$champ.'.notes'] = $this->resultat_req[str_replace('.', '_', $champ).'_notes'];
break;
default :
break;
}
}
}
public function afficherSignification($champ, $valeur) {
if ($champ == 'id' && isset($this->resultat_req['nom_sci']) && $this->resultat_req['num_nom'] == $valeur) {
//si le nom_sci du num_nom que l'on veut afficher est déjà dans la table de résultat :
$this->table_retour['nom_sci'] = $this->resultat_req['nom_sci'].$this->ajouterCompositionNom($this->resultat_req);
} elseif ($this->correspondAUnId($champ) || $champ == 'id') {
$nom = $this->recupererNomSci($valeur);
$champ = ($champ == 'id') ? 'nom_sci' : $champ;
if ($nom != array()) {
$this->table_retour[$champ] = $nom['nom_sci'];
$this->service_href = $nom['service'];
}
} elseif ($this->correspondAUnCode($champ)) {
$this->table_retour[$champ] = $this->ajouterSignificationCode($champ, $valeur);
}
}
/** Permet d'afficher les élements nomenclatural du nom_sci lors de l'appel dans le service noms/id/champ du champ^nom_sci.*/
public function afficherNomSciPointEpithete($resultat) {
foreach ($this->tab_nom_sci as $compo_nom) {
if (isset($resultat[$compo_nom]) && !empty($resultat[$compo_nom])) {
$this->table_retour['nom_sci.'.$compo_nom] = $resultat[$compo_nom];
}
}
}
/** utilisé dans le formatage de /noms/id et de /noms/id/champ seulement */
public function afficherNomSci($resultat) {
if ($this->html == 'htm') {
$this->table_retour['nom_sci'] = $resultat['nom_sci_html'].$this->ajouterCompositionNom($resultat);
} else {
$this->table_retour['nom_sci'] = $resultat['nom_sci'].$this->ajouterCompositionNom($resultat);
}
}
/** Permet d'afficher la signification d'un code pour le rang, la présence, et les differents statuts */
public function ajouterSignificationCode($champ, $valeur) {
$champ = ($champ == 'rang') ? 'rangTaxo' : rtrim($champ, '_Co,_Ga');
if (preg_match('/^([^_-]+)(?:_|-)([^_-]+)$/', $champ, $match)) {
$champ = $match[1].ucfirst($match[2]);
}
$url = Config::get('url_ontologie').$champ.':'.$valeur.'/nom';
$res = $this->consulterHref($url); //dans commun.php
$nom_code = $res->nom;
return $nom_code;
}
/** Recupere le nom_scientifique (formaté ou non en fonction du parametre ns.format) à partir du num_nom */
public function recupererNomSci($id) {
$nom = array();
if ($id != 0) {
if ($this->compo_nom == null) {
$req = 'SELECT nom_sci, num_nom_retenu FROM '.$this->table.' WHERE num_nom = '.$id;
} else { //on ajoute à la requete sql, les champs de ns.structure
$req = 'SELECT nom_sci, num_nom_retenu, '.implode(', ', $this->compo_nom)
.' FROM '.$this->table
.' WHERE num_nom = '.$id;
}
if ($this->html == 'htm') {
$req = str_replace('nom_sci', 'nom_sci_html as nom_sci', $req);
}
$res = $this->getBdd()->recuperer($req);
if ($res) {
$nom['nom_sci'] = $res['nom_sci'].$this->ajouterCompositionNom($res);
$nom['service'] = ($res['num_nom_retenu'] == $id && $this->service == 'taxons') ? 'taxons' : 'noms';
} else {
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,
'Fct recupererNomSci() : Donnees introuvables dans la base pour l\'id '.$id);
}
}
return $nom;
}
/** Permet de retourner une chaine de caractère composée des parametres du nom (ns.structure : annnée, auteur,
* bibilio et addendum). A ajouter au nom scientifique */
public function ajouterCompositionNom($tab_res) {
$nom_complet = ' ';
$this->ajouterAuteur($tab_res, $nom_complet);
$this->ajouterAnneeEtBiblio($tab_res, $nom_complet);
$this->ajouterAnneeSansBilio($tab_res, $nom_complet);
$this->ajouterBiblioSansAnnee($tab_res, $nom_complet);
$this->ajouterAddendum($tab_res, $nom_complet);
return rtrim($nom_complet);
}
public function ajouterAuteur($tab_res, &$nom_complet) {
if (isset($this->compo_nom['au']) && isset($tab_res['auteur']) && $tab_res['auteur'] != '') {
if ($this->html == 'htm') {
$nom_complet .= '<span class="auteur">'.$tab_res['auteur'].'</span> ';
} else {
$nom_complet .= $tab_res['auteur'].' ';
}
}
}
public function ajouterAnneeEtBiblio($tab_res, &$nom_complet) {
if (isset($this->compo_nom['an']) && isset($this->compo_nom['bib'])
&& isset($tab_res['annee']) && ($tab_res['annee'] != '')
&& isset($tab_res['biblio_origine']) && ($tab_res['biblio_origine'] != '')) {
if ($this->html == 'htm') {
$nom_complet .= '[<span class="annee">'.$tab_res['annee'].'</span>, <span class="biblio">'
.$tab_res['biblio_origine'].'</span>]';
} else {
$nom_complet .= '['.$tab_res['annee'].', '.$tab_res['biblio_origine'].']';
}
}
}
public function ajouterAnneeSansBilio($tab_res, &$nom_complet) {
if (isset($this->compo_nom['an']) && !isset($this->compo_nom['bib'])
&& isset($tab_res['annee']) && ($tab_res['annee'] != '')) {
if ($this->html == 'htm') {
$nom_complet .= '[<span class="annee">'.$tab_res['annee'].'</span>]';
} else {
$nom_complet .= '['.$tab_res['annee'].']';
}
}
}
public function ajouterBiblioSansAnnee($tab_res, &$nom_complet) {
if (!isset($this->compo_nom['an']) && isset($this->compo_nom['bib']) && ($tab_res['biblio_origine'] != '')) {
if ($this->html == 'htm') {
$nom_complet .= '[<span class="biblio">'.$tab_res['biblio_origine'].'</span>]';
} else {
$nom_complet .= '['.$tab_res['biblio_origine'].']';
}
}
}
public function ajouterAddendum($tab_res, &$nom_complet) {
if (isset($this->compo_nom['ad']) && ($tab_res['nom_addendum'] != '')) {
if ($this->html == 'htm') {
$nom_complet .= '[<span class="adendum">'.$tab_res['nom_addendum'].'</span>]';
} else {
$nom_complet .= '['.$tab_res['nom_addendum'].']';
}
}
}
public function correspondAUnCode($key) {
return (strrpos($key, '.code') !== false) || (in_array($key.'.code', $this->correspondance_champs));
}
public function correspondAUnId($key) {
return (strrpos($key, '.id') !== false) || (in_array($key.'.id', $this->correspondance_champs));
}
public function estChampApi($champ) {
return (in_array($champ, $this->champs_api) || in_array($champ, $this->correspondance_champs));
}
public function correspondAChampApi($champ_bdd) {
return (array_key_exists($champ_bdd, $this->champs_api) || array_key_exists($champ_bdd, $this->correspondance_champs));
}
public function estDansBdnff($champ) {
return (in_array($champ, $this->champs_comp));
}
public function estUnPoint($key) {
if (strrpos($key, 'hybride.parent') !== false) {
$key = str_replace('hybride.parent', 'hybride_parent', $key);
}
return (strrpos($key, '.') !== false);
}
}
?>
Property changes:
Added: svn:executable
+*
\ No newline at end of property

/branches/v5.12-baouque/services/modules/0.1/coste/Noms.php
New file
0,0 → 1,711
<?php
/**
* Description :
* Classe Noms.php permettant de fournir des informations sur les noms scientifiques.
* Si l'url finit par /noms on retourne une liste de noms latin et leurs identifiants (seulement les 100 premeiers noms par défaut).
* L'url peut contenir des paramètres optionnels passés après le ? : /noms?param1=val1&param2=val2&...
*
* Les paramètres de requête disponibles sont : masque, masque.gen (nom de genre), masque.sp (épithète d'espèce), masque.ssp (épithète infra-spécifique),
* masque.au (auteur du nom), masque.an (année de publication du nom), masque.bib (réf biblio de la publi d'origine du nom), masque.ad (nomen addendum),
* masque.nn (identifiant du nom), recherche, rang, distinct, retour.format, nl.format, nl.structure, navigation.depart et navigation.limite.
*
* Encodage en entrée : utf8
* Encodage en sortie : utf8
* @package framework-v3
* @author Jennifer Dhé <jennifer.dhe@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-${year} Tela Botanica (accueil@tela-botanica.org)
*/
class Noms extends CommunNomsTaxons {
/** Permet de stocker la requete formulée :
* - noms | noms/#id | noms/#id/#champ+#champ
* - noms/#id/relations | noms/#id/relations/synonymie | noms/#id/relations/homonymie | noms/#id/relations/flores
* - noms/stats/rangs | noms/stats/annees | noms/stats/initiales */
protected $format_reponse = 'noms';
protected $service = 'noms';
/** Valeur du paramètre de requete recherche : stricte etendue floue */
protected $recherche = false;
/** Valeur du paramètre de requete distinct (=0|1) */
protected $distinct = null;
/** Représente la première partie de la requete SQL (entre le SELECT et le WHERE) */
protected $requete_champ = 'num_nom, nom_sci, num_nom_retenu';
/** Représente la partie de la requete SQL ajoutant une condition (WHERE ...) */
protected $requete_condition = '';
/** Représente la partie GROUP BY de la requete SQL (GROUP BY ...) */
protected $requete_group_by = '';
/** Permet de stocker les limite de la requete SQL (par défaut seul les 100 premiers résultats seront retournés).*/
protected $limite_requete = array(
'depart' => 0,
'limite' => 100
);
public function consulter($ressources, $parametres) {
$resultat_formate = '';
$res_version = '';
$this->initialiserRestClient(); //création d'un objet RestClient
$this->traiterParametres($parametres);
//On récupère les différentes versions existantes ds la table des meta-données (WS metaDonnees) et on traite la version demandée :
$this->traiterVersionProjet($ressources);
if ($this->corps_http == '' && $this->entete_http == '') {
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($ressources); //dans CommunNomsTaxons.php
$requete = $this->assemblerLaRequete();
$resultat = $this->getBdd()->recupererTous($requete);
if ($resultat == '') { //cas ou la requete comporte des erreurs
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,
'La requ&ecirc;te SQL form&eacute;e comporte une erreur !!');
} elseif ($resultat) {
$res_version[$version] = $resultat;
} else {
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,
'Les donn&eacute;es recherch&eacute;es sont introuvables dans la version '.$version);
}
}
}
if ($this->corps_http == '' && $this->entete_http == '') {
$resultat_formate = $this->retournerResultatFormate($res_version);
}
$this->formerReponseHTTP($resultat_formate);
}
//-----------------FONCTION D'ANALYSE DES PARAMETRES--------------------------------------------------------------------
/**
*
* Permet d'analyser les paramètres
* @param array $parametres
*/
public function traiterParametres($parametres) {
$this->table_param = $parametres;
if (isset($parametres) && !empty($parametres)) {
//définition de $recherche permettant d'ajouter les % ds la requete sql (cas recherche étendue) utilisé dans la fct ajouterLeFiltreMasque()
if (isset($parametres['recherche']) && $parametres['recherche'] != '') {
$this->recherche = $parametres['recherche'];
}
foreach ($parametres as $param => $val) {
switch ($param) {
case 'ns_format' : $this->html = $val; break;
case 'ns_structure' : $this->remplirTableCompositionNom($val); //ds CommunNomsTaxons.php
$this->requete_champ .= ' ,'.implode(', ',$this->compo_nom); break;
case 'masque' : $this->ajouterLeFiltreMasque('nom_sci', $val); break;
case 'masque_sg' : $this->ajouterLeFiltreMasque('nom_supra_generique', $val); break;
case 'masque_gen' : $this->ajouterLeFiltreMasque('genre', $val); break;
case 'masque_sp' : $this->ajouterLeFiltreMasque('epithete_sp', $val); break;
case 'masque_ssp' : $this->ajouterLeFiltreMasque('epithete_infra_sp',$val); break;
case 'masque_au' : $this->ajouterLeFiltreMasque('auteur', $val); break;
case 'masque_an' : $this->ajouterLeFiltreMasque('annee', $val); break;
case 'masque_bib' : $this->ajouterLeFiltreMasque('biblio_origine',$val); break;
case 'masque_ad' : $this->ajouterLeFiltreMasque('nom_addendum', $val); break;
case 'masque_nn' : $this->requete_condition .= ' AND num_nom IN ('.$val.')'; break;
case 'masque_rg' : $this->ajouterLeFiltreMasque('rang', $val); break;
case 'navigation_depart': $this->limite_requete['depart'] = $val; break;
case 'navigation_limite': $this->limite_requete['limite'] = $val; break;
case 'retour_format' : $this->retour_format = $val; break;
case 'distinct' : $this->distinct = $val; break;
case 'recherche' : break;
default : $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur dans les parametres de recherche de votre requ&ecirc;te :
</br> Le parametre " '.$param.' " n\'existe pas.'); break;
}
}
$this->ajouterNomDistinct();
if ($this->recherche == 'floue') {
$this->rechercheFloue();
}
}
}
/**
*
* fonction d'ajout dans la requete SQL des conditions (WHERE ...) en fonctions des parametres demandés
* @param $nom_champ
* @param $valeur
* @param $masque
*/
public function ajouterLeFiltreMasque($nom_champ, $valeur) {
if ($nom_champ == 'annee' || $nom_champ == 'rang') {
$this->requete_condition .= ' AND '.$nom_champ.' = '.$this->getBdd()->proteger($valeur);
} else {
if ($this->recherche == 'etendue') {
$valeur = str_replace(' ','%', $valeur);
$valeur .= '%';
}
$this->requete_condition .= ' AND '.$nom_champ.' LIKE '.$this->getBdd()->proteger($valeur);
}
}
/**
* Permet de rajouter à la requete sql le parametre distinct. N'est utilisé qu'avec le format oss
*/
public function ajouterNomDistinct() {
if (isset($this->distinct)) {
if (($this->distinct == 1) && ($this->retour_format == 'oss')) {
if ($this->compo_nom == '') {
$this->requete_champ = ' DISTINCT nom_sci ';
} else {
$this->requete_champ = ' DISTINCT nom_sci, '.implode(', ',$this->compo_nom);
}
} elseif (($this->distinct == 1) && ($this->retour_format != 'oss')) {
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,'Erreur dans votre requ&ecirc;te </br>
L\'utilisation du parametre distinct ne se fait que sous le format oss');
}
}
}
/**
*
* Permet d'ajouter à notre requete une condition de recherche floue à l'aide de l'alhorithme soundex.
* On remplace ainsi les filtres exceptés le masque année et le filtre rang
*/
public function rechercheFloue() {
foreach ($this->ordre_masque as $masque) {
if (array_key_exists($masque, $this->table_param)) {
$radical = $this->table_param[$masque];
switch ($masque) {
case 'masque' : $this->ajoutSoundex('nom_sci', $radical); break;
case 'masque_sg' : $this->ajoutSoundex('nom_supra_generique', $radical); break;
case 'masque_gen' : $this->ajoutSoundex('genre', $radical); break;
case 'masque_sp' : $this->ajoutSoundex('epithete_sp', $radical); break;
case 'masque_ssp' : $this->ajoutSoundex('epithete_infra_sp', $radical); break;
case 'masque_au' : $this->ajoutSoundex('auteur', $radical); break;
default : break;
}
}
}
}
/** Ajoute à la requete SQL l'expression pour la recherche floue en fonction du masque demandé */
public function ajoutSoundex($champ, $radical) {
$this->requete_condition = str_replace(' AND '.$champ.' LIKE \''.$radical.'\'',
' AND (SOUNDEX('.$champ.') = SOUNDEX(\''.$radical.'\')'.
' OR SOUNDEX(REVERSE('.$champ.')) = SOUNDEX(REVERSE(\''.$radical.'\'))) ',
$this->requete_condition
);
}
//-----------------FONCTION D'ANALYSE DES RESSOURCES--------------------------------------------------------------------
public function traiterRessourcesIdentifiant() {
//on initialise la condition de la requete sql et le format de réponse
$this->requete_condition = ' num_nom = '.$this->getBdd()->proteger($this->table_ressources[0]);
$this->format_reponse = $this->service.'/id';
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) {
// requete de type noms/#id/#champ+#champ
if (($this->table_ressources[1] != 'relations')) {
$this->requete_champ = ' *, nom_sci ';
$this->format_reponse .= '/champ';
// requete de type noms/#id/relations/#relations
} elseif ($this->table_ressources[1] == 'relations') {
$this->traiterRessourceIdRelations();
} else {
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur dans votre requ&ecirc;te </br> Ressources disponibles : <br/>
<li> noms/#id/relations </li> <li> noms/#id/#champ+#champ </li>
<li> noms/#id/relations/synonymie </li> <li> noms/#id/relations/flores </li>
<li> noms/#id/relations/homonymie </li>');
}
} else {
// requete de type noms/#id : rajout du nom_sci pour récupérer le format html par la fct mettreAuFormat()
// SELECT *, nom_sci FROM bdtfx_v2_00 WHERE num_nom = X;
$this->requete_champ = ' *, nom_sci ';
}
}
public function traiterRessourceIdRelations() {
$this->format_reponse .= '/relations';
if (isset($this->table_ressources[2]) && !empty($this->table_ressources[2])) {
// requete de type noms/#id/relations/#relation
switch ($this->table_ressources[2]) {
case 'synonymie' : $this->traiterRessourceIdSynonymie(); break;
case 'flores' : $this->traiterRessourceIdFlores(); break;
case 'homonymie' : $this->traiterRessourceIdHomonymie(); break;
default : $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur dans votre requ&ecirc;te </br> Ressources disponibles : <br/>
<li> noms/#id/relations </li> <li> noms/#id/relations/synonymie </li>
<li> noms/#id/relations/flores </li> <li> noms/#id/relations/homonymie </li>'); break;
}
}
}
public function traiterRessourceIdSynonymie() {
// SELECT num_nom, nom_sci, num_nom_retenu, basionyme FROM bdtfx_v2_00 WHERE num_nom = X LIMIT 0,100;
$this->format_reponse .= '/synonymie';
if (strrpos($this->requete_champ, ', basionyme') === false) $this->requete_champ .= ', basionyme ';
$this->requete_condition = ' num_nom_retenu = (SELECT num_nom_retenu FROM '.$this->table
.' WHERE '.$this->requete_condition.')';
}
public function traiterRessourceIdHomonymie() {
// SELECT num_nom, nom_sci, num_nom_retenu FROM bdtfx_v2_00 WHERE nom_sci =
// (SELECT nom_sci FROM bdtfx_v2_00 WHERE num_nom = X);
$this->format_reponse .= '/homonymie';
$this->requete_condition = 'nom_sci = (SELECT nom_sci FROM '.$this->table
.' WHERE '.$this->requete_condition.')';
}
public function traiterRessourceIdFlores() {
$champ_flores = '';
foreach ($this->champs_table as $champ) {
if (preg_match('/^flore_.*$/', $champ)) {
$champ_flores .= ', '.$champ;
}
}
$this->format_reponse .= '/flores';
$this->requete_champ = 'num_nom'.$champ_flores;
}
public function traiterRessourceStatsRangs() {
// SELECT count(*) as nombre, rang FROM bdtfx_v2_00 [WHERE rang = 290] GROUP BY rang ORDER BY rang;
$this->format_reponse .= '/rangs';
$this->requete_champ = 'count(*) as nombre, rang ';
$this->requete_group_by = ' GROUP BY rang ORDER BY rang ';
}
public function traiterRessourceStatsAnnees() {
// SELECT count(*) as nombre, annee FROM bdtfx_v2_00 GROUP BY annee ORDER BY annee;
$this->format_reponse .= '/annees';
$this->requete_champ = 'count(*) as nombre, annee ';
$this->requete_condition = '';
$this->requete_group_by = ' GROUP BY annee ORDER BY annee ';
}
public function traiterRessourceStatsInitiales() {
// SELECT count(left( nom_sci, 2 )) as nb, rang, left(nom_sci, 2) as lettre GROUP BY rang, left(nom_sci, 2);
$this->format_reponse .= '/initiales';
$this->requete_condition = '';
$this->requete_champ = 'count(left( nom_sci, 2 )) as nb, rang, left(nom_sci, 2) as lettre ';
$this->requete_group_by = ' GROUP BY rang, left(nom_sci, 2)';
}
//-----------------------------FONCTIONS DASSEMBLAGE DE LA REQUETE-----------------------------------------------------
public function assemblerLaRequete() {
if ( strrpos($this->format_reponse, 'noms/stats/') === false ) {
$this->mettreAuFormat(); //Ds CommunNomsTaxons.php
}
if ($this->requete_condition != '') {
$this->requete_condition = ltrim($this->requete_condition, ' AND, WHERE');
$this->requete_condition = ' WHERE '.$this->requete_condition;
}
if ($this->format_reponse != 'noms' && $this->format_reponse != 'noms/id/relations/synonymie' && $this->format_reponse != 'noms/id/relations/homonymie') {
$this->requete_limite = '';
} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) {
$this->limite_requete['depart'] =
(($this->total_resultat - $this->limite_requete['limite']) < 0) ? 0 : ($this->total_resultat - $this->limite_requete['limite']);
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
} else {
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
}
$requete = ' SELECT '.$this->requete_champ.
' FROM '.$this->table
.$this->requete_condition
.$this->requete_group_by
.$this->requete_limite;
return $requete;
}
/**
* Recupere le nombre total de résultat d'une requete lancée.
* Est utilisée lors de l'affichage du total dans le résultat retourné et pr déterminer les limites et départ
* @return nombre total de résultat
*/
public function recupererTotalResultat() {
$total = null;
$requete = 'SELECT count(*) as nombre FROM '.$this->table.$this->requete_condition.$this->requete_group_by;
$res = $this->getBdd()->recuperer($requete);
if ($res) {
$total = $res['nombre'];
} else {
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,
'Fct recupererTotalResultat() : <br/>Donn&eacute;es introuvables dans la base');
}
return $total;
}
//-------------------FONCTIONS POUR LE FORMATAGE EN JSON----------------------------------------------------------------
/**
* Permet de récupérer le résultat à retourner propre à chaque requete et de l'encoder en json
* @param array $resultat
* @param array $ressources
* @return le résultat encoder en json
*/
public function retournerResultatFormate($resultat) {
switch ($this->format_reponse) {
case 'noms/id' : $reponse = $this->formaterId($resultat); break; //ds CommunNomsTaxons
case 'noms/id/champ' : $reponse = $this->formaterIdChamp($resultat); break; //ds CommunNomsTaxons
case 'noms/id/relations' : $reponse = $this->formaterIdRelations($resultat); break;
case 'noms/id/relations/synonymie' : $reponse = $this->formaterIdSynonymie($resultat); break;
case 'noms/id/relations/homonymie' : $reponse = $this->formaterIdHomonymie($resultat); break;
case 'noms/id/relations/flores' : $reponse = $this->formaterIdFlores($resultat); break; //ds CommunsNomsTaxons
case 'noms/stats/annees' : $reponse = $this->formaterStatsAnnee($resultat); break; //ds CommunNomsTaxons
case 'noms/stats/rangs' : $reponse = $this->formaterStatsRang($resultat); break; //ds CommunNomsTaxons
case 'noms/stats/initiales' : $reponse = $this->formaterStatsInitiales($resultat); break; //ds CommunNomsTaxons
case 'noms' : $reponse = $this->formaterNoms($resultat); break;
default : break;
}
return json_encode($reponse);
}
//----------------------concerne les resultats pour des requetes de type noms/id----------------------------------------
/**
* Formate et retourne toutes les relations correpondant au nom recherché : les flores, les synonyme et les homonymes
* @param array $resultat
*/
public function formaterIdRelations($resultat) {
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
$res = array();
foreach ($resultat as $version => $res_version) {
$res_version = $res_version[0];
$this->resultat_req = $res_version;
$retour_id_rel = array ('entete' => array()); //on initialise pr que l'entete apparaisse en premier lors de l'affichage
//on recupère le resultat de chaque relation (appel du WS correspondant)
$flores = $this->ajouterRelations('flores', $version);
if (isset($flores)) $retour_id_rel['resultat']['flores'] = $flores;
$homonymes = $this->ajouterRelations('homonymie', $version);
if (isset($homonymes)) $retour_id_rel['resultat']['homonymes'] = $homonymes;
$synonymes = $this->ajouterRelations('synonymie', $version);
if (isset($synonymes)) $retour_id_rel['resultat']['synonyme'] = $synonymes;
//on renvoit un tableau null si il n'existe aucune relations (on efface l'entete en premier lieu)
if (!isset($retour_id_rel['resultat'])) {
$retour_id_rel = null;
//on rajoute l'entete si des relations existent
} else {
$this->afficherDonnees('num_nom', $this->table_ressources[0]);
$retour_id_rel['entete'] = $this->table_retour;
$this->table_retour = array();
}
//recuperation du resultat de chaque version
$res = $this->afficherVersionOuPas($version, $retour_id_rel, $res);
}
return $res;
}
/**
* Recupere les relations (type de la relation passée en paramètres :[type_relation] = synonymie, homonymie ou
* flores) par l'appel du web service [version]/noms/#id/relations/[type_relation]
* @param String $relation
* @param String $version (numéro de la version)
*/
public function ajouterRelations($relation, $version) {
$version = str_replace(Config::get('bdd_table').'_v', '', $version);
$res = null;
$parametres_url = '';
if ($this->table_param != array()) $parametres_url = '?'.http_build_query($this->table_param, '', '&');
$url = Config::get('url_service').'/'.$version.'/'.$this->service.'/'.$this->table_ressources[0].'/relations/'
.$relation.$parametres_url;
$relation = $this->rest_client->consulter($url);
$entete = $this->rest_client->getReponseEntetes();
//Si le service meta-donnees fonctionne correctement, l'entete comprend la clé wrapper_data
if (isset($entete['wrapper_data'])) {
$relation = json_decode($relation);
if (isset($relation->resultat)) {
$res = $relation->resultat;
}
} else {
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,
'Le service '.$this->service.' de ce projet comporte des erreurs. url lancée : '.$url);
}
return $res;
}
/**
* Formate et retourne toutes les synonymes correpondants au nom recherché
* @param array $resultat
*/
public function formaterIdSynonymie($resultat) {
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
$res = array();
foreach ($resultat as $version => $res_version) {
$retour_id_syn = array();
if ($res_version[0]['num_nom_retenu'] == '') {
$retour_id_syn[] = 'nom_retenu N.D.';
} elseif (count($res_version) != 1) {
//on remplit d'abord l'entete du resultat
$this->table_retour['id'] = $this->table_ressources[0];
$this->afficherEnteteRangBorneTotalUrls($res_version, '/'.$this->service.'/'.$this->table_ressources[0].'/relations/synonymie');
$retour_id_syn['entete'] = $this->table_retour;
$this->table_retour = array();
//on remplit ensuite les resultats
foreach ($res_version as $tab) {
//pour chaque basionyme, on recupère le résultat : num_nom, nom_sci, basionyme et num_nom_retenu :
$this->resultat_req = $tab;
foreach ($tab as $key => $val) {
if ($val != '') {
switch ($key) {
case 'num_nom_retenu' : $retenu = ($val == $num) ? 'true' : 'false';
$this->table_retour['retenu'] = $retenu; break;
case 'basionyme' : $this->afficherDonnees($key, $val); break;
case 'num_nom' : $num = $val;
$this->afficherDonnees($key, $val);
unset($this->table_retour['id']); break;
default : break;
}
}
}
$retour_id_syn['resultat'][$num] = $this->table_retour;
$this->table_retour = array();
}
}
if (!isset($retour_id_syn['resultat']) && !in_array('nom_retenu N.D.', $retour_id_syn)) {
$retour_id_syn = null; //on initialise le resultat à null
}
$res = $this->afficherVersionOuPas($version, $retour_id_syn, $res);
}
return $res;
}
/**
* Formate et retourne toutes les homonymes correpondants au nom recherché
* @param array $resultat
*/
public function formaterIdHomonymie($resultat) {
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
$res = array();
foreach ($resultat as $version => $res_version) {
if (count($res_version) != 1) {
$this->table_retour['id'] = $this->table_ressources[0];
$this->afficherEnteteRangBorneTotalUrls($res_version, '/'.$this->service.'/'.$this->table_ressources[0].'/relations/homonymie');
$retour_id_hom['entete'] = $this->table_retour;
$this->table_retour = array();
foreach ($res_version as $homonyme) {
$this->resultat_req = $homonyme;
$id = $homonyme['num_nom'];
$this->afficherDonnees('num_nom', $id);
if ($homonyme['num_nom_retenu'] != '') {
$retenu = ($id == $homonyme['num_nom_retenu']) ? 'true' : 'false';
$this->table_retour['retenu'] = $retenu;
}
$retour_id_hom['resultat'][$id] = $this->table_retour;
unset($retour_id_hom['resultat'][$id]['id']);
$this->table_retour = array();
}
} else {
$retour_id_hom = null;
}
$res = $this->afficherVersionOuPas($version, $retour_id_hom, $res);
}
return $res;
}
public function formaterIdFlores($resultat) {
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp,noms_projets');
$res = array();
foreach ($resultat as $version => $res_version) {
$res_version = $res_version[0];
$this->resultat_req = $res_version;
$id = array_shift($res_version);
//-----formatage de l'entete du résultat
$reponse['entete']['id'] = $id;
//-----formatage du résultat
$total = 0;
foreach ($res_version as $flores => $valeur) {
if ($valeur != '' && $valeur != '0') {
$this->afficherInfosFlore($res_version, $flores, $valeur);
$total++;
}
}
$reponse['entete']['total'] = $total;
if ($this->table_retour != array()) {
$reponse['resultat'] = $this->table_retour;
$this->table_retour = array();
} else {
$reponse = null;
}
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version
$res = $this->afficherVersionOuPas($version, $reponse, $res);
}
return $res;
}
public function afficherInfosFlore(&$resultat, $flores, $valeur) {
$flore = substr($flores,0,strrpos($flores, '_'));
if (strrpos($flores, 'num') !== false) {
$projet = $this->noms_projets[$flore];
if (preg_match('/^([0-9]+)(?:[.]syn[^a-z]*|(.*))?$/', $valeur, $match)) {
$this->table_retour[$flore]['id'] = $match[1];
$this->table_retour[$flore]['href'] = $this->ajouterHrefAutreProjet('noms', $match[1], $projet);
if (isset($match[2]) && $match[2] != '') $this->table_retour[$flore]['cle'] = $match[2];
}
if (isset($resultat[$flore.'_rem']) && !empty($resultat[$flore.'_rem'])) {
$this->table_retour[$flore]['remarque'] = $resultat[$flore.'_rem'];
unset($resultat[$flore.'_rem']);
}
} elseif (strrpos($flores,'belge') !== false) {
$projet = $this->noms_projets[$flore];
if (preg_match('/^([0-9]+) (R|S)?$/', $valeur, $match)) {
if (isset($match[2])) $type = ($match[2] == 'R') ? 'taxons' : 'synonyme';
$this->table_retour[$flore]['page'] = $match[1];
$this->table_retour[$flore]['type'] = $type;
//$this->table_retour[$flore]['href'] = $this->ajouterHrefAutreProjet('noms', $match[1], $projet);
}
}
}
//----------------------concerne les resultats pour des requetes de type /noms avec ou sans paramètres------------------
/**
*
* Est utilisée pour les requetes de type /noms avec ou sans parametres. Détermine le format json ou oss.
* @param retourne le résultat sous forme de tableau, à encoder en json.
*/
public function formaterNoms($resultat) {
if ($this->retour_format == 'oss') {
$reponse = $this->formaterEnOss($resultat); //Ds CommunNomsTaxons.php
} else {
$reponse = $this->formaterEnJsonMax($resultat);
}
return $reponse;
}
/**
*
* Permet de créer un tableau ($table_retour_json) au format defaut puis de l'encoder en json (json_encode).
* Le format comprend deux parties, une partie entete (contenu dans le tableau $entete_json) et une partie
* resultat (contenu dans le tableau $resultat_json).
* @param string $resultat : résultat de la requete (liste des noms et leur identifiant)
* @return une chaine encodé json (format par default)
*/
public function formaterEnJsonMax($resultat) {
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
$res = array();
foreach ($resultat as $version => $res_version) {
//on remplit la table $table_retour_json['entete']
$masque = $this->ordonnerMasque();
if ($masque != '') $this->table_retour['masque'] = $masque;
$this->afficherEnteteRangBorneTotalUrls($res_version, '/'.$this->service);
$table_retour_json['entete'] = $this->table_retour;
$this->table_retour = array();
//on remplit la table $table_retour_json['resultat']
foreach ($res_version as $tab) {
$this->resultat_req = $tab;
foreach ($tab as $key => $val) {
if ($val != '') {
switch ($key) {
case 'num_nom' : $num = $val;
$this->afficherDonnees($key, $val); break;
case 'nom_sci' : if ($this->retour_format == 'min') {
// sinon est affiché ds afficherDonnees(num_nom, $val) ci-dessus
$this->table_retour[$key] = $val.$this->ajouterCompositionNom($tab);
} break;
case 'num_nom_retenu' :
$retenu = ($val == $num) ? 'true' : 'false';
$this->table_retour['retenu'] = $retenu; break;
default : break;
}
unset($this->table_retour['id']);
}
}
$resultat_json[$num] = $this->table_retour;
$this->table_retour = array();
}
$table_retour_json['resultat'] = $resultat_json;
$res = $this->afficherVersionOuPas($version, $table_retour_json, $res);
}
return $res;
}
}
?>
Property changes:
Added: svn:executable
+*
\ No newline at end of property

/branches/v5.12-baouque/services/modules/0.1/coste/Taxons.php
New file
0,0 → 1,732
<?php
// declare(encoding='UTF-8');// ou ISO-8859-15
/**
* Description :
* Classe Taxons.php permettant de fournir des informations sur les noms scientifiques retenu.
* Si l'url finit par /taxons on retourne une liste de noms latin et leurs identifiants (seulement les 100 premeiers noms par défaut).
* L'url peut contenir des paramètres optionnels passés après le ? : /taxons?param1=val1&param2=val2&...
*
* Les paramètres de requête disponibles sont : masque, recherche, rang, distinct, retour.format, nl.format,
* nl.structure, navigation.depart et navigation.limite.
*
* Encodage en entrée : utf8
* Encodage en sortie : utf8
* @package framework-v3
* @author Jennifer Dhé <jennifer.dhe@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-${year} Tela Botanica (accueil@tela-botanica.org)
*/
class Taxons extends CommunNomsTaxons {
/**
* Valeur du paramètre de requete recherche stricte, etendue, floue */
protected $recherche = false;
/** Permet de stocker la requete formulée :
* - taxons | taxons/#id | taxons/#id/#champ+#champ
* - taxons/#id/relations | taxons/#id/relations/synonymie | taxons/#id/relations/homonymie
* | taxons/#id/relations/flores | taxons/#id/relations/superieurs | taxons/#id/relations/inferieurs
* - taxons/stats/rangs | taxons/stats/annees | taxons/stats/initiales */
protected $format_reponse = 'taxons';
/** Représente la première partie de la requete SQL (entre le SELECT et le WHERE)*/
protected $requete_champ = 'num_nom, nom_sci, num_nom_retenu, num_tax ';
/** Représente la partie de la requete SQL ajoutant une condition (WHERE ...)*/
protected $requete_condition = 'num_nom = num_nom_retenu ';
/** Représente la partie GROUP BY de la requete SQL (GROUP BY ...) */
protected $requete_group_by = ' ';
/** Permet de stocker les limite de la requete SQL (par défaut seul les 100 premiers résultats seront retournés). */
protected $limite_requete = array('depart' => 0, 'limite' => 100);
/** Stocke le num_nom du nom retenu du num_nom recherché */
protected $num_nom_taxon;
protected $service = 'taxons';
protected $presence_num_tax = true;
public function consulter($ressources, $parametres) {
$resultat_formate = '';
$this->initialiserRestClient(); //création d'un objet RestClient
$this->traiterParametres($parametres);
$this->traiterVersionProjet($ressources) ;
if ($this->corps_http == '' && $this->entete_http == '') {
foreach ($this->table_version as $version) {
$this->table = $version; //on stocke ici la table correspondant à la version du projet analysée
$this->recupererNomChamp($this->table);
$this->gererNumTax();
$this->traiterRessources($ressources);
if ($this->corps_http == '' && $this->entete_http == '') {
$requete = $this->assemblerLaRequete();
$resultat = $this->getBdd()->recupererTous($requete);
if ($resultat == '') { //cas ou la requete comporte des erreurs
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,
'Fct consulter() : La requete form&eacute;e comporte une erreur !!');
} elseif ($resultat) {
$res_version[$version] = $resultat;
} else { //cas ou la requete renvoi un tableau vide
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,
'Donn&eacute;es introuvables dans la base '.$version.' <br/>
L\'identifiant demande n\'est pas un taxon et aucun taxon ne lui a ete attribue');
}
}
}
}
if ($this->corps_http == '' && $this->entete_http == '') {
$resultat_formate = $this->retournerResultatFormate($res_version);
}
$this->formerReponseHTTP($resultat_formate);
}
/**
*
* Permet d'analyser les paramètres
* @param array $parametres
*/
public function traiterParametres($parametres) {
$this->table_param = $parametres;
if (isset($parametres) && ($parametres)) {
if (isset($parametres['recherche']) && $parametres['recherche'] != '') {
$this->recherche = $parametres['recherche'];
}
foreach ($parametres as $param => $val) {
switch ($param) {
case 'ns_format' : $this->html = $val; break;
case 'ns_structure' : $this->remplirTableCompositionNom($val);
$this->requete_champ .= ' ,'.implode(', ',$this->compo_nom); break;
case 'masque' : $this->ajouterFiltreMasque($val); break;
case 'masque_nt' : $this->ajouterFiltreMasqueNt($val); break;
case 'masque_rg' : $this->requete_condition .= ' AND rang = '.$this->getBdd()->proteger($val); break;
case 'navigation_depart': $this->limite_requete['depart'] = $val; break;
case 'navigation_limite': $this->limite_requete['limite'] = $val; break;
case 'retour_format' : $this->retour_format = $val; break;
case 'recherche' : break;
default : $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur dans les parametres de recherche de votre
requete : </br> Le parametre " '.$param.' " n\'existe pas.');
break;
}
}
}
}
public function ajouterFiltreMasque($val) {
if ($this->recherche == 'etendue') {
$val = str_replace(' ','%', $val);
$val .= '%';
$this->requete_condition .= ' AND nom_sci LIKE '.$this->getBdd()->proteger($val);
} elseif ($this->recherche == 'floue') {
$this->requete_condition .= ' AND (SOUNDEX(nom_sci) = SOUNDEX(\''.$val.'\')'
.' OR SOUNDEX(REVERSE(nom_sci)) = SOUNDEX(REVERSE(\''
.$val.'\'))) ';
} else {
$this->requete_condition .= ' AND nom_sci LIKE '.$this->getBdd()->proteger($val);
}
}
public function ajouterFiltreMasqueNt($val) {
if (strrpos($val, ',') !== false) {
$ids_taxon = explode(",", $val);
} else {
$ids_taxon[] = $val;
}
foreach ($ids_taxon as $id) {
$this->requete_condition .= ' OR num_tax = '.$this->getBdd()->proteger($id);
}
$this->requete_condition = str_replace('num_nom = num_nom_retenu OR ',
'num_nom = num_nom_retenu AND (' , $this->requete_condition).')';
}
/**
* Permet d'ajouter à la requete_champ les parametres demandés qui composeront le nom_sci.
* Permet de remplir le tableau compo_nom qui regroupe les parametres demandés qui composeront le nom_sci.
* (parametres à ajouter aux nom_sci sous la forme : Auteur [annee, biblio] [addendum])
* @param la valeur du parametre nl.structure
*/
public function recupererParametreNom($valeur) {
$structure_nom = explode(",",$valeur);
foreach ($structure_nom as $structure) {
switch ($structure) {
case 'au' : $this->compo_nom['au'] = 'auteur'; break;
case 'an' : $this->compo_nom['an'] = 'annee'; break;
case 'bib' : $this->compo_nom['bib'] = 'biblio_origine'; break;
case 'ad' : $this->compo_nom['ad'] = 'nom_addendum'; break;
default : $this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur : Le parametre "'.$structure.'" n\'existe pas. <br/><br/>
Les parametres du nom possibles sont :
<li> au (auteur)</li><li> an (annee)</li>
<li> bib (bibliographie)</li><li> ad (nom_addendum)</li>');
break;
}
}
if (isset($this->compo_nom)) {
$this->requete_champ .= ' ,'.implode(', ',$this->compo_nom);
}
}
//------------------------------------------Fonction ressources---------------------------------------------------------------------
public function gererNumTax() {
if (!in_array('num_tax', $this->champs_table)) {
$this->presence_num_tax = false;
$this->requete_champ = str_replace(', num_tax ', '', $this->requete_champ);
} else {
$this->presence_num_tax = true;
}
}
public function traiterRessourcesIdentifiant() {
$this->format_reponse = 'taxons/id';
$this->num_nom_taxon = $this->recupererNumNomTaxon(); //on recupere le taxon correspondant au num_nom recherché
if ($this->entete_http == '') {
$this->requete_condition = ' num_nom = '.$this->num_nom_taxon;
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) {
//---------------- requete de type taxons/#id/#champ+#champ--------------------------------------
if ($this->table_ressources[1] != 'relations') {
// SELECT *, nom_sci FROM bftfx_v2_00 WHERE num_nom = X;
$this->requete_champ = ' *, nom_sci ';
$this->format_reponse .= '/champ';
//---------------- requete de type taxons/#id/relations/#relation--------------------------------
} elseif ($this->table_ressources[1] == 'relations') {
$this->traiterRessourceIdRelations();
} else {
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur dans votre requete </br> Ressources disponibles : <br/>
<li> #id/relations </li> <li> #id/#champ+#champ </li> <li> #id/relations </li>
<li> #id/relations/inferieurs </li> <li> #id/relations/superieurs </li>');
}
} else {
//--------------- requete de type taxons/#id-----------------------------------------------------
$this->requete_champ = ' *, nom_sci ';
}
}
}
/**
* Permet de récupérer le num_nom du taxon recherché. Soit le numéro taxonomique est demandé (avec nt: )
* soit un num_nom dont on recherche le num_nom_retenu
*/
public function recupererNumNomTaxon() {
$identifiant = '';
if (strrpos($this->table_ressources[0], 'nt:') !== false) {
if ($this->presence_num_tax) {
// SELECT num_nom FROM bdtfx_v2_00 WHERE num_nom = num_nom_retenu AND num_tax = X;
$this->requete_condition = ' num_nom = num_nom_retenu AND num_tax = '
.str_replace('nt:', '', $this->table_ressources[0]).' ';
} else {
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur dans votre requete : </br> Le numero taxonomique n\'existe pas dans ce projet' );
}
} else {
// SELECT num_nom FROM bdtfx_v2_00 WHERE num_nom = (SELECT num_nom_retenu FROM bdtfx_v2_00 WHERE num_nom = X);
$this->requete_condition = ' num_nom = (SELECT num_nom_retenu FROM '
.$this->table.' WHERE num_nom = '.$this->table_ressources[0].')';
}
if ($this->entete_http == '') {
//on récupere l'identifiant du taxon correspondant au num_nom ou num_tax demandé pour pouvoir l'afficher
$res = '';
$req_tax = 'SELECT num_nom FROM '.$this->table.' WHERE '.$this->requete_condition;
$res_tax = $this->getBdd()->recuperer($req_tax);
//on recherche ensuite les identifiants des taxons supérieurs ou inférieurs
if ($res_tax == '') {
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,
'Le numéro de taxon ou l\'identifiant de nom correspondant au num_nom '
.$this->table_ressources[0].' n\'existe pas dans la table '.$this->table);
} elseif ($res_tax) {
$identifiant = $res_tax['num_nom'];
} else {
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,
'Le numéro de taxon ou l\'identifiant de nom correspondant au num_nom '
.$this->table_ressources[0].' n\'existe pas dans la table '.$this->table);
}
}
return $identifiant;
}
public function traiterRessourceIdRelations() {
//----------------- requete de type taxons/#id/relations-------------------------------------------
// SELECT *, nom_sci FROM bftfx_v2_00 WHERE num_nom = X;
$this->format_reponse .= '/relations';
if (isset($this->table_ressources[2])) {
//------------- requete de type taxons/#id/relations/#relation--------------------------------
switch ($this->table_ressources[2]) {
case 'superieurs' : $rel = 'recupererIdSup';
$this->format_reponse .= '/superieurs';
$this->traiterRessourceIdRelationInfSup($rel); break;
case 'inferieurs' : $rel = 'recupererIdInf';
$this->format_reponse .= '/inferieurs';
$this->traiterRessourceIdRelationInfSup($rel); break;
default : $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,
'Erreur dans votre requ&ecirc;te </br> Ressources disponibles : <br/>
<li> taxons/#id/relations </li> <li> taxons/#id/relations/flores </li>
<li> taxons/#id/relations/homonymie </li> <li> #id/relations/inferieurs </li>
<li> #id/relations/superieurs </li>'); break;
}
}
}
public function traiterRessourceIdRelationInfSup($rel) {
//Appel de la fct récupérerIdSup ou recupererIdInf : retourne les num_nom des noms inferieurs ou superieurs
$res_relation = $this->$rel();
//analyse du résultat retourné par la requete de recherche des identifiants correspondant aux taxons inf|sup :
if ($res_relation == '') { //dans le cas ou la requete comporte des erreurs
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,
'Fct traiterRessourceIdHomonymie : La requete forme comporte une erreur !!');
} elseif ($res_relation) {
//dans le cas ou une ou plusieurs relations est retournée, on récupère les identifiants ss la forme (id, id, id)
foreach ($res_relation as $ligne) $res[] = $ligne['num_nom'];
$res = implode(',',$res);
$this->requete_condition = ' num_nom IN ('.$res.')';
$this->requete_champ .= ', rang, num_tax_sup ';
} else { //dans le cas ou aucune relation n'existe
$res = array($this->num_nom_taxon => null);
$this->corps_http = json_encode($res);
$this->entete_http = RestServeur::HTTP_CODE_OK;
}
}
public function recupererIdInf() {
//SELECT num_nom FROM bfdtx_v2_00 WHERE num_tax_sup = (SELECT num_nom FROM bdtfx_v2_00 WHERE num_nom = X);
$req_relation = 'SELECT num_nom FROM '.$this->table
.' WHERE num_tax_sup = (SELECT num_nom FROM '
.$this->table
.' WHERE '.$this->requete_condition.')';
$res_relation = $this->getBdd()->recupererTous($req_relation);
return $res_relation;
}
public function recupererIdSup() {
//SELECT num_nom FROM bfdtx_v2_00 WHERE num_nom = (SELECT num_tax_sup FROM bdtfx_v2_00 WHERE num_nom = X);
$req_relation = 'SELECT num_nom FROM '.$this->table
.' WHERE num_nom = (SELECT num_tax_sup FROM '
.$this->table
.' WHERE '.$this->requete_condition.')';
$res_relation = $this->getBdd()->recupererTous($req_relation);
return $res_relation;
}
public function traiterRessourceStatsInitiales() {
// SELECT count(nom_sci) as nb, rang, left(nom_sci, 2) as lettre FROM bdtfx_v2_00 GROUP BY rang, left(nom_sci, 2);
$this->format_reponse = 'taxons/stats/initiales';
$this->requete_champ = 'count(nom_sci) as nb, rang, left(nom_sci, 2) as lettre ';
$this->requete_group_by = ' GROUP BY rang, left(nom_sci, 2) ';
}
public function traiterRessourceStatsRangs() {
// SELECT count(*) as nombre, rang FROM bdtfx_v2_00 [WHERE rang = 290] GROUP BY rang ORDER BY rang;
$this->format_reponse = 'taxons/stats/rangs';
$this->requete_champ = 'count(*) as nombre, rang ';
$this->requete_group_by = ' GROUP BY rang ORDER BY rang ';
}
public function traiterRessourceStatsAnnees() {
// SELECT count(*) as nombre, annee FROM bdtfx_v2_00 GROUP BY annee ORDER BY annee;
$this->format_reponse = 'taxons/stats/annees';
$this->requete_champ = 'count(*) as nombre, annee ';
$this->requete_group_by = ' GROUP BY annee ORDER BY annee ';
}
//-----------------------------FONCTIONS DASSEMBLAGE DE LA REQUETE-----------------------------------------------------
public function assemblerLaRequete() {
if ($this->format_reponse != 'taxons/stats/initiales') {
$this->mettreAuFormat(); //on remplace les nom_sci par les nom_sci_html
}
if ($this->requete_condition != '') {
$this->requete_condition = ltrim($this->requete_condition, ' AND, WHERE');
$this->requete_condition = ' WHERE '.$this->requete_condition;
}
if ($this->format_reponse != 'taxons' && $this->format_reponse != 'taxons/id/relations/homonymie') {
$this->requete_limite = '';
} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) {
$this->limite_requete['depart'] = (($this->total_resultat - $this->limite_requete['limite']) < 0) ? 0 : ($this->total_resultat - $this->limite_requete['limite']);
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
} else {
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
}
$requete = ' SELECT '.$this->requete_champ.
' FROM '.$this->table
.$this->requete_condition
.$this->requete_group_by
.$this->requete_limite;
return $requete;
}
/**
* Recupere le nombre total de résultat d'une requete lancée.
* Est utilisée lors de l'affichage du total dans le résultat retourné
* @return Le nombre total de résultat
*/
public function recupererTotalResultat() {
$requete = 'SELECT count(*) as nombre FROM '.$this->table.$this->requete_condition.$this->requete_group_by;
$res = $this->getBdd()->recuperer($requete);
if ($res) {
$total = $res['nombre'];
} else {
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,
'Fct recupererTotalResultat() : <br/>Donn&eacute;es introuvables dans la base');
}
return $total;
}
//-------------------------FONCTIONS DE FORMATION DU RESULTAT-----------------------------------------------------------
/**
* Permet de récupérer le résultat à retourner propre à chaque requete et de l'encoder en json
* @param array $resultat
* @param array $ressources
* @return le résultat encoder en json
*/
public function retournerResultatFormate($resultat) {
switch ($this->format_reponse) {
case 'taxons/id' : $reponse = $this->formaterId($resultat); break; //ds CommunNomsTaxons
case 'taxons/id/champ' : $reponse = $this->formaterIdChamp($resultat); break; //ds CommunNomsTaxons
case 'taxons/id/relations' : $reponse = $this->formaterIdRelations($resultat); break;
case 'taxons/id/relations/superieurs' : $reponse = $this->formaterIdSuperieur($resultat); break;
case 'taxons/id/relations/inferieurs' : $reponse = $this->formaterIdInferieur($resultat); break;
case 'taxons/stats/annees' : $reponse = $this->formaterStatsAnnee($resultat); break; //ds CommunNomsTaxons
case 'taxons/stats/rangs' : $reponse = $this->formaterStatsRang($resultat); break; //ds CommunNomsTaxons
case 'taxons/stats/initiales' : $reponse = $this->formaterStatsInitiales($resultat); break; //ds CommunNomsTaxons
case 'taxons' : $reponse = $this->formatertaxons($resultat); break;
default : break;
}
return json_encode($reponse);
}
//----------------------concerne les resultats pour des requetes de type /noms avec ou sans paramètres--------------
/**
*
* Est utilisée pour les requetes de type /noms avec ou sans parametres. Détermine le format json ou oss.
* @param retourne le résultat sous forme de tableau, à encoder en json.
*/
public function formaterTaxons($resultat) {
if ($this->retour_format == 'oss') {
$reponse = $this->formaterEnOss($resultat);
} else {
$reponse = $this->formaterEnJsonMax($resultat);
}
return $reponse;
}
/**
*
* Permet de créer un tableau ($table_retour_json) au format defaut puis de l'encoder en json (json_encode).
* Le format comprend deux parties, une partie entete (contenu dans le tableau $entete_json) et une partie
* resultat (contenu dans le tableau $resultat_json).
* @param string $resultat : résultat de la requete (liste des noms et leur identifiant)
* @return une chaine encodé json (format par default)
*/
public function formaterEnJsonMax($resultat) {
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
$res = array();
foreach ($resultat as $version => $res_version) {
//on remplit la table $table_retour_json['entete']
if (isset($this->table_param['masque'])) $this->afficherDonnees('masque', $this->table_param['masque']);
if (isset($this->table_param['masque_nt'])) $this->afficherDonnees('masque.nt', $this->table_param['masque_nt']);
$this->afficherEnteteRangBorneTotalUrls($res_version, '/'.$this->service);
$table_retour_json['entete'] = $this->table_retour;
$this->table_retour = array();
//on remplit la table $table_retour_json['resultat']
$tab_tax_inf = $this->recupererListeTaxonInf($res_version);
foreach ($res_version as $tab) {
$this->resultat_req = $tab;
if (isset($this->table_param['masque_nt'])) $this->afficherDonnees('num_tax', $tab['num_tax']);
foreach ($tab as $key => $val) {
if ($val != '') {
switch ($key) {
case 'num_nom' : $num = $val;
$this->afficherDonnees($key, $val); break;
case 'num_nom_retenu' : $retenu = ($val == $num) ? 'true' : 'false';
$this->table_retour['retenu'] = $retenu; break;
default : break;
}
}
}
$this->afficherTaxonInfNb($num, $tab_tax_inf);
unset($this->table_retour['id']);
$resultat_json[$num] = $this->table_retour;
$this->table_retour = array(); //on vide le tableau table_retour
}
$table_retour_json['resultat'] = $resultat_json;
$res = $this->afficherVersionOuPas($version, $table_retour_json, $res);
}
return $res;
}
//--------------------concerne les resultats pour des requetes de type noms/id----------------------------------------
public function formaterIdRelations($resultat) {
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
$res = array();
foreach ($resultat as $version => $res_version) {
$this->resultat_req = $res_version;
$retour_id_rel = array ('entete' => array()); //on initialise pr que l'entete apparaisse en premier
//on affiche le resultat
$superieurs = $this->ajouterRelations('superieurs', $version);
if (isset($superieurs)) $retour_id_rel['resultat']['superieurs'] = $superieurs;
$inferieurs = $this->ajouterRelations('inferieurs', $version);
if (isset($inferieurs)) $retour_id_rel['resultat']['inferieurs'] = $inferieurs;
//on renvoit un tableau null si il n'existe aucune relations
if (!isset($retour_id_rel['resultat'])) {
$retour_id_rel = null;
//on rajoute l'entete si des relations existent
} else {
$this->afficherDonnees('num_nom', $this->num_nom_taxon); //$this->afficherEnteteRangBorneTotalUrls($resultat, '/'.$this->service.'/'.$this->table_ressources[0].'/relations/synonymie');
$retour_id_rel['entete'] = $this->table_retour;
$this->table_retour = array();
}
//recuperation du resultat de chaque version
$res = $this->afficherVersionOuPas($version, $retour_id_rel, $res);
}
return $res;
}
public function ajouterRelations($relation, $version) {
$version = str_replace(Config::get('bdd_table').'_v', '', $version);
$res = null;
$taxon = $this->num_nom_taxon;
$parametres_url = '';
if ($this->table_param != array()) $parametres_url = '?'.http_build_query($this->table_param, '', '&');
$url = Config::get('url_service').'/'.$version.'/'
.$this->service.'/'.$this->table_ressources[0].'/relations/'
.$relation.$parametres_url;
$relation = $this->rest_client->consulter($url);
$entete = $this->rest_client->getReponseEntetes();
//Si le service meta-donnees fonctionne correctement, l'entete comprend la clé wrapper_data
if (isset($entete['wrapper_data'])) {
$relation = json_decode($relation);
if (isset($relation->resultat)) {
$res = $relation->resultat;
} elseif (isset($relation->$taxon)) { //pour les relations inf et sup
$res = $relation->$taxon;
}
} else {
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,
'Le service '.$this->service.' de ce projet comporte des erreurs. url lancée : '.$url);
}
return $res;
}
public function formaterIdSuperieur($resultat) {
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
$res = array();
foreach ($resultat as $version => $res_version) {
//on remplit le tableau de formatage
if (($res_version) != '' ) {
//on recupere d'abord les rangs supérieurs
$sup = $res_version[0];
do {
$sup = $this->recupererIdSuperieur($sup['num_tax_sup'], $version);
if ($sup['rang'] == '0') $sup['rang'] = '10'; //erreur dans la base
if (isset($sup)) $res_version[] = $sup;
} while ($sup != null);
krsort($res_version);
//on les affiche ensuite
foreach ($res_version as $tab) {
$this->resultat_req = $tab;
foreach ($tab as $key => $val) {
if ($val != '') {
switch ($key) {
case 'num_nom' : $num = $val;
$this->afficherDonnees($key, $num); break;
case 'num_nom_retenu' : $retenu = ($val == $num) ? 'true' : 'false';
$this->table_retour['retenu'] = $retenu; break;
case 'rang' : $this->afficherDonnees($key, $val); break;
default : break;
}
}
}
unset($this->table_retour['id']);
$tab_inf[$num] = $this->table_retour;
$this->table_retour = array();
}
$tab_relation[$this->num_nom_taxon] = $tab_inf;
} else { //si il n'existe aucune relation
$tab_relation = null;
}
//recuperation du resultat de chaque version
$res = $this->afficherVersionOuPas($version, $tab_relation, $res);
}
return $res;
}
public function recupererIdSuperieur($id, $version) {
$req = 'SELECT num_nom, num_nom_retenu, num_tax_sup, rang FROM '
.$version.' WHERE num_nom = '.$this->getBdd()->proteger($id);
$res = $this->getBdd()->recupererTous($req);
if ($res) {
$resultat = $res[0];
} else {
$resultat = null; //on return null si il n'y a pas de taxon superieur
}
return $resultat;
}
public function formaterIdInferieur($resultat) {
$this->recupererTableSignification('champs_api,champs_comp,correspondance_champs');
$res = array();
foreach ($resultat as $version => $res_version) {
//on veut récupérer pour chacun des taxons inférieur le nb de taxons inf :
$tab_tax_inf = $this->recupererListeTaxonInf($res_version);
//on commence le formatage
if (($res_version) != '' ) {
foreach ($res_version as $tab) {
$this->resultat_req = $tab;
foreach ($tab as $key => $val) {
if ($val != '') {
switch ($key) {
case 'num_nom' : $num = $val;
$this->afficherDonnees($key, $num); break;
case 'num_nom_retenu' : $retenu = ($val == $num) ? 'true' : 'false';
$this->table_retour['retenu'] = $retenu; break;
default : break;
}
}
}
$this->afficherTaxonInfNb($num, $tab_tax_inf);
unset($this->table_retour['id']);
$tab_inf[$num] = $this->table_retour;
$this->table_retour = array(); //on vide le tableau table_retour
}
$tab_relation[$this->num_nom_taxon] = $tab_inf;
} else {
$tab_relation = null;
}
//recuperation du resultat de chaque version
$res = $this->afficherVersionOuPas($version, $tab_relation, $res);
}
return $res;
}
public function afficherTaxonInfNb($num, $tab_tax_inf) {
foreach ($tab_tax_inf as $taxNb) {
if ($taxNb['num_tax_sup'] == $num) {
$this->table_retour['taxon_inferieur_nbre'] = $taxNb['nb'];
}
}
if (!isset($this->table_retour['taxon_inferieur_nbre'])) {
$this->table_retour['taxon_inferieur_nbre'] = '0';
}
}
public function recupererListeTaxonInf($resultat) {
// SELECT num_tax_sup, count(*) as nb FROM bdtfx_v2_00 WHERE num_tax_sup IN (id, id, id) AND num_nom = num_nom_retenu GROUP BY num_tax_sup';
foreach ($resultat as $tab) {
$tab_num[] = $tab['num_nom']; //on regroupe ici les id des taxons dont on cherche le nb de taxon inf
}
$req = 'SELECT num_tax_sup, count(*) as nb FROM '.$this->table
.' WHERE num_tax_sup IN ('.implode(',',$tab_num)
.') AND num_nom = num_nom_retenu GROUP BY num_tax_sup';
$res = $this->getBdd()->recupererTous($req);
if ($res) {
$resultat = $res;
} else {
$resultat = array(); //on return un tableau vide s'il n'y a pas de taxon inférieurs
}
return $resultat;
}
}
?>

/branches/v5.12-baouque/services/modules/0.1/coste/Textes.php
New file
0,0 → 1,528
<?php
/*
* @copyright 2013 Tela Botanica (accueil@tela-botanica.org)
* @author Raphaël Droz <raphael@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>
*
* pattern: /service:eflore:0.1/coste/textes/bdtfx.nn:182,631
* params: txt.format=(htm|txt) , retour.champs=(titre,texte,...) , retour.format=(min|max), ...
*
* Ce webservice est censé pouvoir:
* 1) retourner des informations (choisies) à propos d'un ou plusieurs taxon(s) donné(s)
* (à partir de son numéro nomenclatural
* 2) retourner des informations (choisies) à propos de taxons recherchés
* (à partir de divers critères)
*
* TODO: masque.titre => masque.tag
* TODO: clarifier l'attribut "tag" retourné (tag de la description ou des clefs de détermination)
*
*/
// affecte le nombre d'ids autorisés dans le dernier segment d'URL
// *et* la valeur maximale autorisée pour navigation.limite.
define('_COSTE_TEXTE_MAX_RESULT_LIMIT', 500);
// simplifie et accélère la sanitization de l'input:
// SELECT MAX(num_nom) FROM coste_v2_00;
define('_COSTE_TEXTE_MAX_COSTE_NN', 7015 + 1000);
// SELECT MAX(page) FROM coste_v2_00;
define('_COSTE_TEXTE_MAX_COSTE_PAGE', 4126);
// SELECT MAX(tome) FROM coste_v2_00;
define('_COSTE_TEXTE_MAX_COSTE_TOME', 3);
// SELECT MAX(num_taxonomique) FROM coste_v2_00;
define('_COSTE_TEXTE_MAX_BDTFX_NT', 37809);
// SELECT MAX(num_nom) FROM bdtfx_v2_00;
define('_COSTE_TEXTE_MAX_BDTFX_NN', 120816 + 100000);
/* restore_error_handler();
error_reporting(E_ALL); */
class Textes {
// paramètres autorisés
static $allow_params = array(
'txt.format', 'retour.format', 'retour.champs', 'retour.indexBy',
'recherche',
'masque.ns', 'masque.txt', 'masque.page', 'masque.tome', 'masque.famille', 'masque.nt',
'masque.titre', // masque sur titre de la page wiki correspondante (page "clef" OR page "description")
'navigation.depart', 'navigation.limite');
// et valeurs par défaut
static $default_params = array('txt.format' => 'txt', 'retour.format' => 'max', 'retour.indexBy' => 'coste',
'recherche' => 'stricte',
'retour.champs' => 'titre,texte,determination,tag',
'navigation.depart' => 0, 'navigation.limite' => 50);
// les champs de base de coste_v2_00
// mysql -N tb_eflore<<<"SHOW FIELDS FROM coste_v2_00"|egrep -v 'page_'|awk '{print $1}'|xargs -i -n1 printf "'%s' => 'c.%s',\n" {} {}
static $allow_champs = array(
'coste:nn' => 'c.num_nom',
'bdtfx:nn' => 'IF(c.flore_bdtfx_nn = "",NULL,c.flore_bdtfx_nn)',
'bdtfx:nt' => 'IF(c.flore_bdtfx_nt = "",NULL,c.flore_bdtfx_nt)',
'num_nom' => 'c.num_nom',
'num_nom_retenu' => 'c.num_nom_retenu',
'num_tax_sup' => 'c.num_tax_sup',
'rang' => 'c.rang',
'nom_sci' => 'c.nom_sci',
'nom_supra_generique' => 'c.nom_supra_generique',
'genre' => 'c.genre',
'epithete_infra_generique' => 'c.epithete_infra_generique',
'epithete_sp' => 'c.epithete_sp',
'type_epithete' => 'c.type_epithete',
'epithete_infra_sp' => 'c.epithete_infra_sp',
'cultivar_groupe' => 'c.cultivar_groupe',
'cultivar' => 'c.cultivar',
'nom_commercial' => 'c.nom_commercial',
'auteur' => 'c.auteur',
'annee' => 'c.annee',
'biblio_origine' => 'c.biblio_origine',
'notes' => 'c.notes',
'nom_addendum' => 'c.nom_addendum',
'nom_francais' => 'c.nom_francais',
'nom_coste' => 'c.nom_coste',
'auteur_coste' => 'c.auteur_coste',
'biblio_coste' => 'c.biblio_coste',
'num_nom_coste' => 'c.num_nom_coste',
'num_nom_retenu_coste' => 'c.num_nom_retenu_coste',
'num_tax_sup_coste' => 'c.num_tax_sup_coste',
'synonymie_coste' => 'c.synonymie_coste',
'tome' => 'c.tome',
'page' => 'c.page',
'nbre_taxons' => 'c.nbre_taxons',
'flore_bdtfx_nn' => 'c.flore_bdtfx_nn',
'flore_bdtfx_nt' => 'c.flore_bdtfx_nt',
'image' => 'c.image',
'image_auteur' => 'c.image_auteur',
'nom_sci_html' => 'c.nom_sci_html',
// handly duplicate (redirigé vers nom_sci ou nom_sci_html selon que txt.format vaut "txt" ou "htm"
'titre' => 'c.nom_sci',
// champs spécifiques (et étrangères)
'texte' => 'dsc.body',
'determination' => 'cle.body',
'tag' => 'dsc.tag',
'famille' => 'b.famille', // cf sqlAddJoins()
'*' => 'XXX' // spécial
);
// les champs suivants disparaissent de la liste utilisée pour former la requête SQL
// (ils sont exclue lorsque '*' est utilisée, ce sont généralement des synonymes)
static $special_champs = array('nom_sci_html', 'nom_sci', '*', 'flore_bdtfx_nn', 'flore_bdtfx_nt', 'num_nom');
// ces champs sont toujours dans les résultats (cf sqlSelectFields()
static $champs_obligatoires = array('coste:nn', 'bdtfx:nn', 'bdtfx:nt');
// le pattern utilisé pour la recherche dite "floue"
static $soundex_scheme = '(%1$s LIKE %2$s OR SOUNDEX(%1$s) = SOUNDEX(%2$s) OR SOUNDEX(REVERSE(%1$s)) = SOUNDEX(REVERSE(%2$s)))';
// contrainte du point d'entrée d'API webservice Tela lors d'un GET
public function consulter($ressources, $parametres, $db = NULL) {
if (!$db) {
// http_response_code(500);
throw new Exception('no DB', 500);
}
// parser la requête et filtrer les paramètres valides
// en cas d'accès HTTP
if (array_key_exists('QUERY_STRING', $_SERVER)) {
self::requestParse($uri, $params);
} else {// en cas d'accès phpunit
$uri = $ressources;
}
// renvoie du plain/text d'aide (cf fin de programme)
if (count($uri) == 1 && $uri[0] == 'aide') {
die(self::aide());
}
if (is_null($parametres)) {
$parametres = Array();
}
$params = self::requestFilterParams($parametres);
// les contraintes liées aux ids (passés comme composants d'URL)
// sont ajoutées aux params [sans être accepté comme paramètre d'URL]
$params['_ids'] = self::requestFilterIds($uri);
// XXX: temporaires, passage de $db aux fonctions
// de toolkits
$req = self::getCosteInfo($params, $db);
$res = $db->recupererTous($req);
$err = mysql_error();
if (!$res && $err) {
// http_response_code(400);
// if(defined('DEBUG') && DEBUG) header("X-Debug: $req");
throw new Exception('not found', 400);
}
// rapide formatage des résultats:
$matches = 0;
if ($res) {
// nombre de matches (sans LIMIT) utilisé pour l'en-tête
$matches = $db->recuperer('SELECT FOUND_ROWS() AS total');
$matches = intval($matches['total']);
}
// reformate les résultats pour les indexer par coste:nn par défaut
// cependant le paramètre retour.indexBy permet de choisir une indexation par num_nom de bdtfx
$clef_index = $params['retour.indexBy'] == 'coste' ? 'coste:nn' : 'bdtfx:nn';
$res2 = array();
foreach ($res as $v) {
if (!$v[$clef_index]) {
throw new Exception('format error: index NULL, use retour.indexBy=coste', 409);
}
$res2[$v[$clef_index]] = $v;
}
// l'appelant s'occupera du json_encode()
// même si ça démange d'exit'er ici
if(strpos($_SERVER['SCRIPT_NAME'], 'phpunit') === FALSE) header("Content-Type: application/json; charset=utf-8");
return array('entete' => array(
'depart' => $params['navigation.depart'],
'limite' => $params['navigation.limite'],
'total' => count($res2),
'match' => $matches),
'resultats' => $res2);
}
// la fonction centrale: récupère les infos à partir de paramètres
// et une optionnelle contrainte sur coste:nn ou bdtfx:nn
static function getCosteInfo(array $params, $db) {
// contraintes (WHERE):
$constraints = self::sqlAddConstraint($params, $db);
// XXX: que faire en l'absence de contrainte ? pour l'instant : "WHERE 1"
// champs:
$champs_valides_non_formattes = NULL;
$champs_valides = self::sqlSelectFields($params, $champs_valides_non_formattes);
// joins:
$other_join = self::sqlAddJoins($params, $champs_valides_non_formattes);
$requete_tpl = "SELECT SQL_CALC_FOUND_ROWS %s ".
"FROM tb_eflore.coste_v2_00 c ".
" LEFT JOIN tela_prod_wikini.florecoste_pages dsc ON c.page_wiki_dsc = dsc.tag AND dsc.latest = 'Y' ".
" LEFT JOIN tela_prod_wikini.florecoste_pages cle ON c.page_wiki_cle = cle.tag AND cle.latest = 'Y' ".
" %s ".
"WHERE %s ORDER BY c.num_nom LIMIT %u, %u -- %s ";
$req = sprintf($requete_tpl,
$champs_valides, // dans le SELECT (parmi champs coste_v2_00)
// autre join, si nécessaire
$other_join ? $other_join : '',
// where
$constraints ? implode(' AND ', $constraints) : '1',
// limit
$params['navigation.depart'],
$params['navigation.limite'],
__FILE__ . ':' . __LINE__);
return $req;
}
// SQL helpers
// le préfix de coste_v2_00 est "c"
// le préfix de florecoste_pages sur la description est est "dsc"
// le préfix de florecoste_pages sur la clef de détermination est est "cle"
static function sqlAddConstraint($params, $db) {
$stack = array();
if (!empty($params['masque.ns'])) {
if ($params['recherche'] == 'etendue') {
$stack[] = 'c.nom_sci LIKE '.$db->proteger('%' . trim($params['masque.ns']).'%');
} elseif($params['recherche'] == 'floue') {
$stack[] = sprintf(self::$soundex_scheme,
'c.nom_sci',
$db->proteger('%'.trim($params['masque.ns']).'%'));
} else {
$stack[] = 'c.nom_sci = '.$db->proteger(trim($params['masque.ns']));
}
}
// le masque sur texte est toujours un LIKE() "étendue", sauf si "floue" spécifié
if(!empty($params['masque.txt'])) {
if($params['recherche'] == 'floue') {
$stack[] = sprintf(self::$soundex_scheme,
'dsc.body',
$db->proteger('%'.trim($params['masque.txt']).'%'));
}
else {
$stack[] = 'dsc.body LIKE '.$db->proteger('%'.trim($params['masque.txt']).'%');
}
}
if(!empty($params['masque.titre'])) {
if($params['recherche'] == 'stricte') {
$stack[] = sprintf('(dsc.tag = %1$s OR cle.tag = %1$s)',
$db->proteger(trim($params['masque.titre'])));
}
else {
$stack[] = sprintf('(dsc.tag LIKE %1$s OR cle.tag LIKE %1$s)',
$db->proteger('%'.trim($params['masque.titre']).'%'));
}
}
if(array_key_exists('masque.famille', $params)) {
$stack[] = 'b.famille LIKE '.$db->proteger(trim($params['masque.famille']));
}
if(array_key_exists('masque.page', $params)) {
$stack[] = 'c.page = '.intval($params['masque.page']);
}
if(array_key_exists('masque.tome', $params)) {
$stack[] = 'c.tome = '.intval($params['masque.tome']);
}
if(array_key_exists('masque.nt', $params)) {
$stack[] = 'c.flore_bdtfx_nt = '.intval($params['masque.nt']);
}
// ajout de la contrainte sur coste:nn ou bdtfx:nn si un composant d'URL supplémentaire
// comportant un #id existe, cf self::requestFilterIds()
$o_stack = array();
if (array_key_exists('_ids', $params) && $params['_ids']) {
if ($params['_ids']['coste.nn']) {
$o_stack[] = sprintf("c.num_nom IN (%s)", implode(',', $params['_ids']['coste.nn']));
}
if ($params['_ids']['bdtfx.nn']) {
$o_stack[] = sprintf("c.flore_bdtfx_nn IN (%s)", implode(',', $params['_ids']['bdtfx.nn']));
}
if ($params['_ids']['bdtfx.nt']) {
$o_stack[] = sprintf("c.flore_bdtfx_nt IN (%s)", implode(',', $params['_ids']['bdtfx.nt']));
}
}
if ($o_stack) {
$stack[] = '(' . implode(' OR ', $o_stack) . ')';
}
return $stack;
}
// $unmerged contient la même liste de champs que celle renvoyée
// à la différence que celle-ci n'est pas reformatée et s'avère donc
// utilisable plus aisément dans sqlAddJoins() qui peut en avoir besoin
static function sqlSelectFields($params, &$unmerged) {
$champs = $params['retour.champs'];
// champs coste_v2_00
$c = self::addSQLToFieldSynonym(explode(',', $champs));
if (isset($c['*'])) {
$t = array_diff_key(self::$allow_champs, array_flip(self::$special_champs));
} else {
// just loop below
$t = $c;
}
// si aucun des champs fournis n'est valide
// on se rappelle nous-même après avoir réinitialisé retour.champs
// avec les champs par défaut
if(!$t) {
$params['retour.champs'] = self::$default_params['retour.champs'];
return self::sqlSelectFields($params);
}
if(array_key_exists('titre', $t))
$t['titre'] = $params['txt.format'] == 'txt' ? 'c.nom_sci' : 'c.nom_sci_html';
// champs obligatoires:
$t = array_merge($t, self::addSQLToFieldSynonym(self::$champs_obligatoires));
$unmerged = $t;
// XXX: PHP-5.3
$ret = array();
foreach($t as $k => $v) {
if (strpos($k, ':') !== FALSE) {
$ret[] = "$v AS \"$k\"";
} else {
$ret[] = "$v AS $k";
}
}
return implode(',',$ret);
}
static function sqlAddJoins($params, $champs) {
$j = '';
// ces tests doivent correspondre aux champs générés par sqlSelectFields()
// ou contraintes générées par sqlAddConstraint()
if(array_key_exists('masque.famille', $params) ||
array_key_exists('famille', $champs)) {
$j .= 'LEFT JOIN tb_eflore.bdtfx_v2_00 b ON c.flore_bdtfx_nn = b.num_nom';
}
return $j;
}
// d'un tableau de type array("coste:nn", "type_epithete")
// retourne
// un tableau de type array("coste:nn" => "c.num_nom", "type_epithete" => "c.type_epithete")
// basé sur self::$allow_champs
static function addSQLToFieldSynonym(Array $syno) {
return array_intersect_key(self::$allow_champs, array_flip($syno));
}
// request handler
static function requestParse(&$ressource, &$params) {
if (isset($_SERVER['REDIRECT_URL'])) {
$uri = explode('/', $_SERVER['REDIRECT_URL']);
} else {
$uri = explode('/', $_SERVER['REQUEST_URI']);
}
if (!empty($_SERVER['QUERY_STRING'])) {
parse_str($_SERVER['QUERY_STRING'], $params);
}
$ressource = array_slice($uri, array_search('textes', $uri) + 1, 3);
}
// supprime l'index du tableau des paramètres si sa valeur ne correspond pas
// au spectre passé par $values.
static function unsetIfInvalid(&$var, $index, $values) {
if(array_key_exists($index, $var) && !in_array($var[$index], $values))
unset($var[$index]);
}
static function requestFilterParams(Array $params) {
$p = array_intersect_key($params, array_flip(self::$allow_params));
self::unsetIfInvalid($p, 'txt.format', array('txt', 'htm'));
self::unsetIfInvalid($p, 'retour.format', array('min','max'));
self::unsetIfInvalid($p, 'retour.indexBy', array('coste', 'bdtfx'));
self::unsetIfInvalid($p, 'recherche', array('stricte','etendue','floue'));
if(isset($params['masque.ns'])) $p['masque.ns'] = trim($params['masque.ns']);
if(isset($params['masque.texte'])) $p['masque.texte'] = trim($params['masque.texte']);
if(isset($params['masque.famille'])) {
// mysql -N<<<"SELECT DISTINCT famille FROM bdtfx_v2_00;"|sed -r "s/(.)/\1\n/g"|sort -u|tr -d "\n"
$p['masque.famille'] = preg_replace('/[^a-zA-Z %_]/', '', iconv("UTF-8",
"ASCII//TRANSLIT",
$params['masque.famille']));
}
// TODO: use filter_input(INPUT_GET);
// renvoie FALSE ou NULL si absent ou invalide
$p['navigation.limite'] = filter_var(@$params['navigation.limite'],
FILTER_VALIDATE_INT,
array('options' => array(
'default' => NULL,
'min_range' => 1,
'max_range' => _COSTE_TEXTE_MAX_RESULT_LIMIT)));
$p['navigation.depart'] = filter_var(@$params['navigation.depart'],
FILTER_VALIDATE_INT,
array('options' => array(
'default' => NULL,
'min_range' => 0,
'max_range' => _COSTE_TEXTE_MAX_COSTE_NN)));
$p['masque.page'] = filter_var(@$params['masque.page'],
FILTER_VALIDATE_INT,
array('options' => array(
'default' => NULL,
'min_range' => 0,
'max_range' => _COSTE_TEXTE_MAX_COSTE_PAGE)));
$p['masque.tome'] = filter_var(@$params['masque.tome'],
FILTER_VALIDATE_INT,
array('options' => array(
'default' => NULL,
'min_range' => 0,
'max_range' => _COSTE_TEXTE_MAX_COSTE_TOME)));
$p['masque.nt'] = filter_var(@$params['masque.nt'],
FILTER_VALIDATE_INT,
array('options' => array(
'default' => NULL,
'min_range' => 0,
'max_range' => _COSTE_TEXTE_MAX_BDTFX_NT)));
// on filtre les NULL, FALSE et '', mais pas les 0, d'où le callback()
// TODO: PHP-5.3
$p = array_filter($p, create_function('$a','return !in_array($a, array("",false,null),true);'));
$p = array_merge(self::$default_params, $p);
return $p;
}
static function requestFilterIds($uri) {
if(count($uri) != 1) return NULL;
// getNN* renvoient le num_nom passé comme segment d'URI:
// - soit un id selon coste (num_nom dans coste_v2_00)
// - soit un id selon bdtfx (num_nom dans bdtfx_v2_00)
// ou bien l'extrait du pattern bdtfx.nn:(#id)
$ids_coste_nn = array_filter(array_map(array(__CLASS__, 'getNNCoste'), explode(',', $uri[0])));
$ids_bdtfx_nn = array_filter(array_map(array(__CLASS__, 'getNNBdtfx'), explode(',', $uri[0])));
$ids_bdtfx_nt = array_filter(array_map(array(__CLASS__, 'getNTBdtfx'), explode(',', $uri[0])));
// en cas d'échec (tous les id sont invalides), bail-out
if(!$ids_bdtfx_nt && !$ids_bdtfx_nn && !$ids_coste_nn) {
// http_response_code(500);
throw new Exception('not supported', 500);
}
return array(
'coste.nn' => array_slice($ids_coste_nn, 0, intval(_COSTE_TEXTE_MAX_RESULT_LIMIT / 2) ),
'bdtfx.nn' => array_slice($ids_bdtfx_nn, 0, intval(_COSTE_TEXTE_MAX_RESULT_LIMIT / 2) ),
'bdtfx.nt' => array_slice($ids_bdtfx_nt, 0, intval(_COSTE_TEXTE_MAX_RESULT_LIMIT / 2) )
);
}
static function aide() {
header("Content-Type: text/plain; charset=utf-8");
return sprintf("Service coste/textes:
Retourne des informations (choisies) à propos d'un taxon donné (à partir de son numéro nomenclatural
Retourne des informations (choisies) à propos de taxons recherchés (à partir de divers critères)
Les résultats sont indexés. La clef par défaut est le num_nom d'après coste (attribut \"coste:nn\")
Usage: coste/textes[/<liste-num_nom>]?<params>
* le paramètre \"retour.indexBy\" affecte le mode d'indexation (\"bdtfx\" ou \"coste\" (defaut))
* <liste-num_nom> étant une liste de numéros nomenclaturaux de taxons séparés par des virgules au format:
- <#id>: un numéro nomenclatural dans la base coste
- <bdtfx.nn:#id>: un numéro nomenclatural dans la base bdtfx
* retour.champs une liste de champs séparés par des virgules parmi *,%s
* les paramètres acceptés sont les suivants: %s
* les champs retournés par défaut sont les suivants: %s
* le paramètre \"recherche\" affecte les masques \"ns\" et \"texte\"
* le paramètre \"famille\" est traité via LIKE et accepte les caractères '_' et '%%'
* le paramètre \"retour.format\" est inutilisé pour l'instant.
Exemples:
/service:eflore:0.1/coste/textes/bdtfx.nn:182?retour.champs=titre
# retourne l'Acer monspessulanum
/service:eflore:0.1/coste/textes/182?retour.champs=titre
# retourne la Roemeria violacea (bdtfx:nn = 56272)
/service:eflore:0.1/coste/textes/182,bdtfx.nn:182?retour.champs=titre
# retourne les deux précédents
/service:eflore:0.1/coste/textes?masque.titre=Cla001Thalamiflores&retour.champs=titre
# retourne la section de Coste relatives aux Thalamiflores
/service:eflore:0.1/coste/textes?masque.titre=Thalamiflores&recherche=floue&retour.champs=titre
# idem, en utilisant une recherche floue
/service:eflore:0.1/coste/textes?masque.titre=Cla001Thalamiflores&retour.champs=titre&retour.indexBy=bdtfx
# retourne une erreur de format car cette section de coste n'est associée à aucun taxon de la BDTFX
",
implode(',', array_keys(self::$allow_champs)),
implode(',', self::$allow_params),
self::$default_params['retour.champs']
);
}
static function getNNCoste($refnn) {
if(strpos($refnn, 'coste.nn:') == 0)
$refnn = intval(str_replace('coste.nn:', '', $refnn));
if (is_numeric($refnn)) {
if ($refnn >= 1 && $refnn < _COSTE_TEXTE_MAX_COSTE_NN) return $refnn;
}
return FALSE;
}
static function getNNBdtfx($refnn) {
if(strpos($refnn, 'bdtfx.nn:') !== 0) return FALSE;
$t = intval(str_replace('bdtfx.nn:', '', $refnn));
if($t >= 1 && $t < _COSTE_TEXTE_MAX_BDTFX_NN) return $t;
return FALSE;
}
static function getNTBdtfx($refnt) {
if(strpos($refnt, 'bdtfx.nt:') !== 0) return FALSE;
$t = intval(str_replace('bdtfx.nt:', '', $refnt));
if($t >= 1 && $t < _COSTE_TEXTE_MAX_BDTFX_NT) return $t;
return FALSE;
}
}
Property changes:
Added: svn:mergeinfo
Merged /branches/v5.8-aspergeraie/services/modules/0.1/coste/Textes.php:r1083
Merged /branches/v5.7-arrayanal/services/modules/0.1/coste/Textes.php:r1050,1052
Merged /branches/v5.1-acheb/services/modules/0.1/coste/Textes.php:r927
Merged /branches/v5.2-alpage/services/modules/0.1/coste/Textes.php:r976,978

/branches/v5.12-baouque/services/modules/0.1/photoflora/ALIRE.txt
New file
0,0 → 1,8
; l'utilisation d'une redirection transparente des appels à l'api photoflora peut se faire
; en incluant dans le .htaccess du site, la ligne suivante :
RewriteRule ^service:eflore:([0-9]\.[0-9])/photoflora/images$ http://photoflora.free.fr/eflore-photoflora/services/index.php/$1/projets/photoflora/images
; Attention ! Il faut l'inclure avant la ligne de redirection des services web eflore
; Free ne supporte pas la redirection .htacess, il faut donc donc la désactiver dans le .htaccess de la racine des services
; Photoflora étant hébergé chez free, il faut changer ce paramètre dans le fichier de config général en ce qui suit
serveur.baseURL = "/eflore-photoflora/services/index.php/"
Property changes:
Added: svn:eol-style
+native
\ No newline at end of property

/branches/v5.12-baouque/services/modules/0.1/photoflora/Images.php
New file
0,0 → 1,421
<?php
/**
* Web service particulier pour photoflora, qui ne doitpas être installé sur tela botanica
* mais sur photoflora.free.fr
* Une redirection htaccess est à faire, redirigeant /service:eflore:0.1/photoflora/image
* vers le site photoflora à l'adresse ou seront installé les services web et le minimum
* nécessaire pour les faire fonctionner (framework + base de code eflore-projet ou peut-être moins)
*
* La table des metadonnées est, elle, stockée sur Tela Botanica
* Le service est dans le même dépot que les autres par souci de commodité
*
*/
class Images {
const MIME_JPEG = 'image/jpeg';
const MIME_PNG = 'image/png';
const MIME_JSON = 'application/json';
const MIME_XML = 'text/xml';
//TODO déplacer ceci dans des parametres de config
const BDD_PF = 'photoflora';
private $efph_url_photo = 'http://photoflora.free.fr/photos/%s/max/%s';
private $efph_url_photo_bb = 'http://photoflorabb.free.fr/max/%s';
private $efph_url_photo_jlt = 'http://photoflorajlt.free.fr/max/%s';
private $efph_url_photo_min = 'http://photoflora.free.fr/photos/%s/min/%s';
private $efph_url_photo_bb_min = 'http://photoflora.free.fr/photos/bb/min/%s';
private $efph_url_photo_jlt_min = 'http://photoflora.free.fr/photos/jlt/min/%s';
private $parametres = array();
private $ressources = array();
private $Bdd;
private $format = 'min';
private $retour_mime = 'application/json';
private $nbreImages = '0';
public function __construct(Bdd $bdd = null, Array $config = null) {
$this->config = is_null($config) ? Config::get('Images') : $config;
$this->Bdd = is_null($bdd) ? new Bdd() : $bdd;
}
public function consulter($ressources, $parametres) {
$this->parametres = $parametres;
$this->ressources = $ressources;
$this->definirValeurParDefautDesParametres();
$this->format = (isset($this->parametres['retour.format']) && $this->parametres['retour.format'] != '') ? $this->parametres['retour.format'] : $this->format;
$this->retour_mime = (isset($this->parametres['retour']) && $this->parametres['retour'] != '') ? $this->parametres['retour'] : $this->retour_mime;
$photographies = $this->getResultatTest();
if($this->retour_mime == self::MIME_JPEG) {
$photo = $this->obtenirPremiereImage();
$retour = $this->formaterRetourImageBinaire($photo);
echo $retour;
} elseif($this->retour_mime == self::MIME_JSON) {
$photographies = $this->obtenirImages();
$this->nbreImages = count($photographies);
$photographies_formatees = $this->formaterRetourJson($photographies);
$resultat = $photographies_formatees;
$entete = $this->construireEntete();
return array('entete' => $entete, 'resultats' => $resultat);
} elseif ($this->retour_mime == self::MIME_XML) {
$photographies = $this->obtenirImages();
$this->nbreImages = count($photographies);
$photographies_formatees = $this->formaterRetourXml($photographies);
header('Content-Type: '.self::MIME_XML);
echo $photographies_formatees;
exit;
}
}
private function construireEntete() {
$entete = array('masque' => '', 'depart' => 0, 'limite' => 100, 'total' => 0);
$entete['masque'] = $this->recupererMasque();
$entete['depart'] = (int) $this->parametres['navigation.depart'];
$entete['limite'] = (int) $this->parametres['navigation.limite'];
$entete['total'] = $this->nbreImages;
return $entete;
}
private function recupererMasque() {
$masqueEntete = '';
foreach ($this->parametres as $param => $cle) {
if ($param == 'masque') {
$masqueEntete = 'masque='.$cle.',';
} elseif (substr($param, 0, 7) == 'masque.') {
$masqueEntete .= substr($param, 7).'='.$cle.',';
}
}
$masqueEntete = rtrim($masqueEntete,',');
return $masqueEntete;
}
private function definirValeurParDefautDesParametres() {
if (isset($this->parametres['retour']) == false) {
$this->parametres['retour'] = self::MIME_JSON;
}
if (isset($this->parametres['retour.format']) == false) {
$this->parametres['retour.format'] = 'min';
}
if (isset($this->parametres['navigation.depart']) == false) {
$this->parametres['navigation.depart'] = 0;
}
if (isset($this->parametres['navigation.limite']) == false) {
$this->parametres['navigation.limite'] = 100;
}
}
public function obtenirPremiereImage() {
$this->parametres['navigation.depart'] = 0;
$this->parametres['navigation.limite'] = 1;
$images = $this->obtenirImages();
if (!is_array($images) || count($images) <= 0) {
$message = "Aucune image ne correspond au numéro numenclatural $refTax:$numNom";
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
} else {
return $images[0];
}
}
public function obtenirImages() {
//TODO: tri par date, mais les dates dans la bdd photoflora sont des chaines en entités HTML
// donc un tri dessus n'a pas de sens
$requete = 'SELECT photos.*, taxons.NumTaxon, taxons.NumNomen, taxons.Combinaison, photographes.Nom, '.
' photographes.Prenom, photographes.Initiales, photographes.Mail '.
'FROM '.self::BDD_PF.'.photos, '.self::BDD_PF.'.photographes, '.self::BDD_PF.'.taxons '.
'WHERE '.
'photos.Auteur = photographes.ID '.
'AND photos.NumTaxon = taxons.NumTaxon '.
$this->construireWhereNumNom().' '.
$this->construireWhereNumTax().' '.
$this->construireWhereNomSci().' '.
$this->construireWhereAuteur().' '.
'ORDER BY photos.support LIMIT '.$this->parametres['navigation.depart'].','.$this->parametres['navigation.limite'];
$resultat = $this->Bdd->recupererTous($requete);
return $resultat;
}
private function construireWhereNumNom() {
return (isset($this->parametres['masque.nn'])) ? 'AND taxons.NumNomen = '.$this->Bdd->proteger($this->parametres['masque.nn']).' ' : '';
}
private function construireWhereNumTax() {
return (isset($this->parametres['masque.nt'])) ? 'AND taxons.NumTaxon = '.$this->Bdd->proteger($this->parametres['masque.nt']).' ' : '';
}
private function construireWhereNomSci() {
return (isset($this->parametres['masque.ns'])) ? 'AND taxons.Combinaison LIKE '.$this->Bdd->proteger($this->parametres['masque.ns'].'%').' ' : '';
}
private function construireWhereAuteur() {
$requete_auteur = '';
if (isset($this->parametres['masque.auteur'])) {
$auteur_like = $this->Bdd->proteger($this->parametres['masque.auteur'].'%');
$requete_auteur = 'AND photos.auteur = '.
'(SELECT id FROM '.self::BDD_PF.'.photographes '.
'WHERE '.
'Nom LIKE '.$auteur_like.' OR '.
'Prenom LIKE '.$auteur_like.' OR '.
'Initiales LIKE '.$auteur_like.' OR '.
'Mail LIKE '.$auteur_like.') ';
}
return $requete_auteur;
}
private function formaterRetourImageBinaire($photo) {
$image = '';
$chemin = $url = $this->getUrlPhotoPourInitiales($photo['Initiales'], $photo['NumPhoto'], $this->format);
$image = file_get_contents($chemin);
if ($image === false) {
$message = "L'image demandée est introuvable sur le serveur : $chemin";
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
}
return $image;
}
private function formaterRetourJson($photographies) {
$resultat = array();
if (is_array($photographies)) {
foreach ($photographies as $photo) {
$image = array();
$url = $this->getUrlPhotoPourInitiales($photo['Initiales'], $photo['NumPhoto'], $this->format);
$urlmax = $this->getUrlPhotoPourInitiales($photo['Initiales'], $photo['NumPhoto'], 'max');
$id = str_replace(array('.jpg','.jpeg', '.png'), '', $photo['NumPhoto']);
// Post-traitement des valeurs
$image['date'] = $this->donnerDate($this->formaterChaineEncodeeBddPhotoflora($photo['Date']));
$image['mime'] = $this->extraireMime($photo['NumPhoto']);
$image['auteur.libelle'] = $this->formaterChaineEncodeeBddPhotoflora($photo['Prenom'].' '.$photo['Nom']);
$image['binaire.href'] = $url;
$image['binaire.hrefmax'] = $urlmax;
$image['determination.libelle'] = $photo['Combinaison'].' ['.$photo['Prenom'].' '.$photo['Nom'].']';
$image['determination.nom_sci.libelle'] = $photo['Combinaison'];
$image['determination.nom_sci.code'] = "bdtfx.".$photo['NumNomen'];
$image['station.libelle'] = $this->formaterStation($photo['lieu']);
$resultat[$id] = $image;
}
}
return $resultat;
}
private function extraireMime($fichierImg) {
$mime = '';
if (strpos($fichierImg, '.jpg') || strpos($fichierImg, '.jpeg')) {
$mime = self::MIME_JPEG;
} else if (strpos($fichierImg, '.png')) {
$mime = self::MIME_PNG;
}
return $mime;
}
private function formaterStation($station) {
$station = $this->formaterChaineEncodeeBddPhotoflora($station);
$station = preg_replace('/^ : /', '', $station);
return $station;
}
private function callBackReplace($m) {
return mb_convert_encoding($m[1], "UTF-8", "HTML-ENTITIES");
}
private function formaterChaineEncodeeBddPhotoflora($chaine) {
return $chaine = preg_replace_callback("/(&#[0-9]+;)/", array($this, 'callBackReplace'), $chaine);
}
// TODO: garder ancien web service pour retour xml ou bien fusionner les deux ?
private function formaterRetourXml($photographies) {
// Formatage du xml
$xml = '<?xml version="1.0" encoding="utf-8"?>'."\n";
$xml .= '<rdf:RDF'."\n";
$xml .= ' xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"'."\n";
$xml .= ' xmlns:dc="http://purl.org/dc/elements/1.1/"'."\n";
$xml .= ' xmlns:dcterms="http://purl.org/dc/terms">'."\n";
foreach ($photographies as $photo) {
$url = $this->getUrlPhotoPourInitiales($photo['Initiales'], $photo['NumPhoto'], $this->format);
// Post-traitement des valeurs
$photo['lieu'] = preg_replace('/^[ ]*:[ ]*/', '', $photo['lieu']);
// Gestion du XML
$xml .= ' <rdf:Description about="'.$url.'"'."\n";
$xml .= ' dc:identifier="'.preg_replace('/\.\w+$/', '', $photo['NumPhoto']).'"'."\n";
$xml .= ' dc:title="'.$photo['Combinaison'].'"'."\n";
$xml .= ' dc:description="'.$photo['Objet'].'"'."\n";
$xml .= ' dc:creator="'.$photo['Prenom'].' '.$photo['Nom'].'"'."\n";
// $xml .= ' dc:contributor="Daniel MATHIEU (Détermination)"'."\n";
$xml .= ' dc:publisher="Photoflora"'."\n";
$xml .= ' dc:type="'.$this->donnerTxtSupport($photo['Support']).'"'."\n";
$xml .= ' dc:format="'.$this->donnerTypeMime($photo['NumPhoto']).'"'."\n";
$xml .= ' dcterms:spatial="'.$photo['lieu'].'"'."\n";
$xml .= ' dcterms:created="'.$photo['Date'].'"'."\n";
// $xml .= ' dcterms:dateSubmitted="2006-10-18 08:32:00"'."\n";
$xml .= ' dcterms:licence="Utilisation des photos non autorisée sans accord avec le gestionnaire du site et sous certaines conditions - Tous droits réservés - All rights reserved"/>'."\n";
}
$xml .= '</rdf:RDF>'."\n";
return $xml;
}
private function getUrlPhotoPourInitiales($initiales, $num_photo, $format) {
// Gestion des urls des photos
$url = '';
if ($initiales == 'bb') {
$base_url = ($format == 'max') ? $this->efph_url_photo_bb : $this->efph_url_photo_bb_min;
$url = sprintf($base_url, $num_photo);
} else if ($initiales == 'jlt') {
$base_url = ($format == 'max') ? $this->efph_url_photo_jlt : $this->efph_url_photo_jlt_min;
$url = sprintf($base_url, $num_photo);
} else {
$base_url = ($format == 'max') ? $this->efph_url_photo : $this->efph_url_photo_min;
$url = sprintf($base_url, $initiales, $num_photo);
}
return $url;
}
private function getResultatTest() {
$photographies = array();
$photographies[] = array('Initiales' => 'bb',
'NumPhoto' => 'bb047230.jpg',
'NumNomen' => '182',
'lieu' => 'Ristolas - Hautes Alpes (05) [France]',
'Combinaison' => '',
'Objet' => 'Vue générale, en fleur cv Musik - Canon EOS 350D DIGITAL - Expo : 1/160 sec. - Ouv. : f8 - ISO : 100 - flash : non - foc. : 60 - pix. : 8 Mp.',
'Prenom' => 'Benoit',
'Nom' => 'BOCK',
'Support' => 'Photographie numérique',
'Date' => 'Mai 2006');
return $photographies;
}
/**
* Fonction remplaçant les caractères posant problème dans le xml
*
* @param string le texte à nettoyer
* @return string le texte nettoyé
*/
function nettoyerXml($xml) {
// Remplacement des esperluettes
$xml = str_replace(' & ', ' &#38; ', $xml);
// Remplacement du caractère spécial de fin de ligne : VT
$xml = preg_replace('//', "\n", $xml);
return $xml;
}
/**
* Fonction fournissant les intitulés des types de support des images
*
* @param integer identifiant du support
* @return string le texte correspondant au type de support
*/
function donnerTxtSupport($support) {
switch ($support) {
case '0':
$support = 'Photographie num&#233;rique (6 mégapixels)';
break;
case '1':
$support = 'Diapositive';
break;
case '10':
$support = 'Scan de la flore de Coste';
break;
case '11':
$support = 'Scan de plante fraiche';
break;
default:
$support = 'Erreur code support : pr&#233;venir eflore_remarques@tela-botanica.org';
}
return $support;
}
/**
* Fonction fournissant les types MIME des fichiers images
*
* @param string le nom du fichier
* @return string le texte du type MIME du fichier
*/
function donnerTypeMime($fichier) {
if (preg_match('/\.(\w+)$/', $fichier, $match)) {
switch (strtolower($match[1])) {
case 'jpeg':
case 'jpg':
$type = 'image/jpeg';
break;
case 'png':
$type = 'image/png';
break;
default:
$type = 'Erreur Mime : prévenir eflore_remarques@tela-botanica.org';
}
} else {
$type = 'Erreur Mime : prévenir eflore_remarques@tela-botanica.org';
}
return $type;
}
/**
* Fonction fournissant une date au format Mysql
*
* @param string la date composé du nom du mois en français et de l'année sous 4 chiffres
* @return string la date dans le format Mysql
*/
function donnerDate($chaine) {
if (preg_match('/^(\w+) (\d{4})$/',$chaine, $match)) {
$mois = $match[1];
$annee = $match[2];
switch (strtolower($mois)) {
case 'janvier' :
$mois_sortie = '01';
break;
case 'février' :
$mois_sortie = '02';
break;
case 'mars' :
$mois_sortie = '03';
break;
case 'avril' :
$mois_sortie = '04';
break;
case 'mai' :
$mois_sortie = '05';
break;
case 'juin' :
$mois_sortie = '06';
break;
case 'juillet' :
$mois_sortie = '07';
break;
case 'aout' :
case 'août' :
$mois_sortie = '08';
break;
case 'septembre' :
$mois_sortie = '09';
break;
case 'octobre' :
$mois_sortie = '10';
break;
case 'novembre' :
$mois_sortie = '11';
break;
case 'decembre' :
$mois_sortie = '12';
break;
}
return $annee.'-'.$mois_sortie.'-01 01:01:01';
} else {
return '1970-01-01 01:01:01';
}
}
}
?>

/branches/v5.12-baouque/services/modules/0.1/coord-transfo/Point.php
New file
0,0 → 1,69
<?php
// declare(encoding='UTF-8');
// Inclusion des dépendances à Proj4Php.
require 'vendor/autoload.php';
/**
* @api {get} /coord-transfo/point?x=:x&y=:y&epsg-src=:epsg-src&epsg-dest=:epsg-dest Transforme des coordonnées.
* @apiName GetCoordTransfo
* @apiGroup coord-transfo
* @apiGroupDescription Transforme les coordonnées X et Y d'un point en fonction d'un EPSG source (epsg-src) et d'un EPSG de
* destination (epsg-dest).
* Exemples d'EPSG fonctionnels :
* - Lambert 93 : 'EPSG:2154'
* - WGS84 : 'EPSG:4326'
*
* @apiParam {String} x info de l'axe des x (longitude).
* @apiParam {String} y info de l'axe des y (latitude).
* @apiParam {Number} epsg-src nombre entier correspondant au code EPSG du système de coordonnée source.
* @apiParam {Number} epsg-dest nombre entier correspondant au code EPSG du système de coordonnée de destination.
*
* @apiSuccess {String} x info de l'axe des x (longitude) transformé.
* @apiSuccess {String} y info de l'axe des y (latitude) transformé.
* @apiSuccess {String} EPSG nombre entier correspondant au code EPSG du système de coordonnée de destination.
*
* @category eFlore
* @package Services
* @subpackage Coord-transfo
* @version 0.1
* @author Mathias CHOUET <mathias@tela-botanica.org>
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @author Aurelien PERONNET <aurelien@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>
* @copyright 1999-2014 Tela Botanica <accueil@tela-botanica.org>
*/
class Point {
private $parametres = array();
private $ressources = array();
private $coordonnees = array();
public function consulter($ressources, $parametres) {
$this->ressources = $ressources;
$this->parametres = $parametres;
$retour = null;
try {
$this->transformerCoordonnees();
$retour = $this->coordonnees;
} catch (Exception $erreur) {
$retour = $erreur->getMessage();
}
return $retour;
}
private function transformerCoordonnees() {
$proj4 = new Proj4php();
$projSource = new Proj4phpProj('EPSG:'.$this->parametres['epsg-src'], $proj4);
$projDestination = new Proj4phpProj('EPSG:'.$this->parametres['epsg-dest'], $proj4);
$pointSrc = new proj4phpPoint($this->parametres['x'], $this->parametres['y']);
$pointDest = $proj4->transform($projSource, $projDestination, $pointSrc);
$this->coordonnees['x'] = round($pointDest->x, 5);
$this->coordonnees['y'] = round($pointDest->y, 5);
$this->coordonnees['EPSG'] = $this->parametres['epsg-dest'];
}
}

/branches/v5.12-baouque/services/modules/0.1/lion1906/NomCommune.php
New file
0,0 → 1,143
<?php
// declare(encoding='UTF-8');
/**
* Classe permettant d'obtenir le nom et le code INSEE des communes les plus proches d'un point (latitude et longitude).
* La latitude et longitude doivent être exprimée par un nombre décimal.
* Ce service fonctionne uniquement sur les communes de France métropolitaine (Corse comprise) présentent
* dans les données Lion1906 téléchargeable à cette adrese : http://www.lion1906.com/Pages/francais/utile/telechargements.html.
* Source des données : Lion1906.com http://www.lion1906.com
* Paramètres du service :
* - lat : latitude
* - lon : longitude
* Exemple :
* http://localhost/lion1906/services/0.1/nom-commune?lat=44.71546&lon=3.84216
*
* @category php 5.2
* @package lion1906
* @author Mohcen BENMOUNAH <mohcen@tela-botanica.org>
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @copyright Copyright (c) 2010, Tela Botanica (accueil@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$
*/
class NomCommune {
const PATTERN_LAT = '/^[0-9]+(?:[.][0-9]+|)$/';
const PATTERN_LON = '/^[-]?[0-9]+(?:[.][0-9]+|)$/';
const LAT_MAX = 51.071667;
const LAT_MIN = 41.316667;
const LON_MAX = 9.513333;
const LON_MIN = -5.140278;
const NBRE_COMMUNE_PAR_DEFAUT = 10;
const NBRE_COMMUNE_MAX = 100;
const MIME_JSON = 'application/json';
private $parametres = array();
private $ressources = array();
private $bdd = null;
public function __construct(Bdd $bdd) {
$this->bdd = $bdd;
}
public function consulter($ressources, $parametres) {
$this->parametres = $parametres;
$this->ressources = $ressources;
$this->definirParametresParDefaut();
$this->verifierParametres();
$nomINSEEs = $this->trouverCommunesProches();
$corps = $this->formaterResultats($nomINSEEs);
$resultat = new ResultatService();
$resultat->mime = self::MIME_JSON;
$resultat->corps = $corps;
return $resultat;
}
private function definirParametresParDefaut() {
if (array_key_exists('nbre', $this->parametres) === false) {
$this->parametres['nbre'] = self::NBRE_COMMUNE_PAR_DEFAUT;
}
}
private function verifierParametres() {
extract($this->parametres);
$messages = array();
if (! array_key_exists('lat', $this->parametres)) {
$messages[] = "Vous devez indiquer une latitude en degré décimal à l'aide du paramètres d'url : lat";
} else if (!preg_match(self::PATTERN_LAT, $lat)) {
$messages[] = "La valeur de latitude doit être un nombre décimal positif dont le séparateur décimal est un point. Ex. : 44 ou 43.03";
} else if ($lat > self::LAT_MAX) {
$messages[] = "La valeur de latitude indiquée est supérieure à {self::LAT_MAX} qui est le point le plus au Nord de la France métropolitaine.";
} else if ($lat < self::LAT_MIN) {
$messages[] = "La valeur de latitude indiquée est infèrieure à {self::LAT_MIN} qui est le point le plus au Sud de la France métropolitaine.";
}
if (! array_key_exists('lon', $this->parametres)) {
$messages[] = "Vous devez indiquer une longitude en degré décimal à l'aide du paramètres d'url : lon";
} else if (!preg_match(self::PATTERN_LON, $lon)) {
$messages[] = "La valeur de longitude doit être un nombre décimal dont le séparateur décimal est un point. Ex. : -4.03 ou 3.256";
} else if ($lon > self::LON_MAX) {
$messages[] = "La valeur de longitude indiquée est supérieure à {self::LON_MAX} qui est le point le plus à l'Est de la France métropolitaine.";
} else if ($lon < self::LON_MIN) {
$messages[] = "La valeur de longitude indiquée est infèrieure à {self::LON_MIN} qui est le point le plus à l'Ouest de la France métropolitaine.";
}
if (array_key_exists('nbre', $this->parametres)) {
if (!preg_match('/^[0-9]+$/', $nbre)) {
$messages[] = "Le nombre de commune le plus proche à retourner doit être un entier positif. Ex. : 10";
} else if ($nbre > self::NBRE_COMMUNE_MAX) {
$messages[] = "Le nombre de commune le plus proche à retourner doit être un entier positif inférieur à 100. Ex. : 10";
}
}
if (count($messages) != 0) {
$message = implode('<br />', $messages);
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
throw new Exception($message, $code);
}
}
private function formaterResultats($nomINSEEs) {
$communes_trouvees = null;
if (isset($nomINSEEs) && !empty($nomINSEEs)) {
foreach ($nomINSEEs as $nomINSEE) {
$communes_trouvees[] = array('nom' => $nomINSEE['nom'], 'codeINSEE' => $nomINSEE['insee']);
}
if (!is_null($communes_trouvees)) {
if ($this->parametres['nbre'] == 1 && count($communes_trouvees) == 1) {
$communes_trouvees = $communes_trouvees[0];
}
} else {
$message = "Le service '".get_class($this)."' n'a trouvé aucune commune correspondant aux coordonnées : {$parametres['lat']}, {$parametres['lon']}.";
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
}
} else {
$message = "Le service '".get_class($this)."' n'a trouvé aucune commune dont le centroïde correspond aux coordonnées : {$parametres['lat']}, {$parametres['lon']}.";
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
}
return $communes_trouvees;
}
/**
* requête qui récupère les 20 communes les plus proches du point recherché
* La distance(AB = \sqrt{(x_B-x_A)^2 + (y_B-y_A)^2}) est calculée sans la racine
* (calcul en plus qui change pas le résultat).
*/
private function trouverCommunesProches() {
$lat = $this->parametres['lat'];
$lon = $this->parametres['lon'];
$requete = 'SELECT '.
" (({$lat} - X(centroide)) * ({$lat} - X(centroide)) + ({$lon} - Y(centroide)) * ({$lon} - Y(centroide))) AS distance, ".
"insee, nom ".
'FROM lion1906_communes_v2008 '.
'ORDER BY distance '.
"LIMIT {$this->parametres['nbre']} ";
$resultat = $this->bdd->recupererTous($requete);
return $resultat;
}
}
?>

/branches/v5.12-baouque/services/modules/0.1/nva/NomsVernaculaires.php
New file
0,0 → 1,653
<?php
/**
* Description :
* Classe NomsVernaculaires.php fournit une liste de noms vernaculaires et leur liaison à la bdtxa
* Le but étant de fournir un ensemble minimal d'information comprenant :
* un identifiant (numérique ou alphanumérique sous forme de ChatMot si possible), un nom, une langue et
* une relation avec un taxon de la bdtxa.
* Si l'url finit par /noms-vernaculaires on retourne une liste de noms (seulement les 100 premières par défaut).
* L'url peut contenir des paramètres optionnels passés après le ? : /observations?param1=val1&param2=val2&...
*
* Les paramètres de requête disponibles sont : masque, masque.code, masque.nom, masque.region , recherche,
* distinct, retour.format, navigation.depart et navigation.limite.
*
* Encodage en entrée : utf8
* Encodage en sortie : utf8
* @package framework-v3
* @author Delphine Cauquil <delphine@tela-botanica.org>
* @author Jennifer Dhé <jennifer.dhe@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-${year} Tela Botanica (accueil@tela-botanica.org)
*/
class NomsVernaculaires extends Commun {
protected $champ_infos = array(
'taxon' => array('service' => 'taxons', 'ressource' => 'nt:', 'projet' => 'bdtxa', 'nom' => 'nom_sci'));
protected $service = 'noms-vernaculaires';
/**
* Permet de stocker la requete formulée : /noms-vernaculaires | /noms-vernaculaires/#id |
* /noms-vernaculaires/#id/champ | /noms-vernaculaires/#id/relations
* Est remplit au cours de l'analyse des ressources (traiterRessources()), par défaut, a la valeur du service.
* Est utilisée principalement pr déterminer le format du tableau à retourner. */
protected $format_reponse = 'noms-vernaculaires';
/** Variables constituant les parametres de la requete SQL (champ, condition, limit) remplie
* selon ressources et paramètres */
protected $requete_champ = array(' * ');
protected $requete_condition = '';
protected $limite_requete = array(
'depart' => 0,
'limite' => 100
);
protected $champ_tri = 'code_langue';
protected $direction_tri = 'asc';
/**
* Indique les champs supplémentaires à retourner
* - conseil_emploi = conseil d'emploi du nom vernaculaire
* - genre = genre et nombre du nom
* - taxon = nom retenu associé à ce nom
*/
protected $champs_supp = array();
/**
* Precise la contenance plus ou moins précise du tableau à retourner :
* - min = les données présentes dans la table
* - max = les données de la table + les informations complémentaires (pour les identifiants et les codes)
* - oss = la liste des nom_sci (uniquement pour noms et taxons) */
protected $retour_format = 'max';
/** Valeur du paramètre de requete recherche :
* - stricte : le masque est passé tel quel à l'opérateur LIKE.
* - etendue : ajout automatique du signe % à la place des espaces et en fin de masque avec utilisation de LIKE.
* - floue : recherche tolérante vis-à-vis d'approximations ou d'erreurs (fautes d'orthographe par exemple) */
protected $recherche;
/** Permet de stocker le tableau de résultat (non encodé en json) */
protected $table_retour = array();
/** Stocke le nombre total de résultats de la requete principale. Est calculée lors de l'assemblage de la requete */
protected $total_resultat;
protected $config;
public function __construct($config) {
$this->config = is_null($config) ? Config::get('NomsVernaculaires') : $config;
}
//+------------------------------------------------------------------------------------------------------+
// créer une condition en fonction du paramétre
public function traiterParametres() {
if (isset($this->parametres) && !empty($this->parametres)) {
if (isset($this->parametres['recherche']) && $this->parametres['recherche'] != '') {
$this->recherche = $this->parametres['recherche'];
}
foreach ($this->parametres as $param => $valeur) {
switch ($param) {
case 'masque' :
$this->ajouterFiltreMasque('nom_vernaculaire', $valeur);
break;
case 'masque.nt' :
$this->ajouterFiltreMasque('num_taxon', $valeur);
break;
case 'masque.nv' :
$this->ajouterFiltreMasque('nom_vernaculaire', $valeur);
break;
case 'masque.lg' :
$this->ajouterFiltreMasque('code_langue', $valeur);
break;
case 'retour.format' :
$this->retour_format = $valeur;
break;
case 'navigation.depart' :
$this->limite_requete['depart'] = $valeur;
break;
case 'navigation.limite' :
$this->limite_requete['limite'] = $valeur;
break;
case 'retour.champs' :
$this->champs_supp = explode(',',$valeur);
break;
case 'recherche' :
break;
case 'version.projet' :
break;
default :
$p = 'Erreur dans les paramètres de recherche de votre requête : '.
'</br> Le paramètre " '.$param.' " n\'existe pas.';
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $p);
}
}
}
}
public function ajouterFiltreMasque($nom_champ, $valeur) {
if ($nom_champ == 'num_taxon') { // si il s'agit d'un chiffre
$this->requete_condition[] = $nom_champ.' = '.$this->getBdd()->proteger($valeur);
} else {
if ($this->recherche == 'floue') {
$this->requete_condition[] = '(SOUNDEX('.$nom_champ.') = SOUNDEX(\''.$valeur.'\')'
.' OR SOUNDEX(REVERSE('.$nom_champ.')) = SOUNDEX(REVERSE(\''.$valeur.'\'))) ';
} else {
if ($this->recherche == 'etendue') {
$valeur = '%'.str_replace(' ','% ', $valeur);
$valeur .= '%';
}
$this->requete_condition[] = 'nva.'.$nom_champ.' LIKE '.$this->getBdd()->proteger($valeur);
}
}
}
//+------------------------------------------------------------------------------------------------------+
// en fonction de la présence des ressources modifie requete_champ et requete_condition
public function traiterRessources() {
if (isset($this->ressources) && !empty($this->ressources)) {
if (isset($this->ressources[0]) && !empty($this->ressources[0])) {
$this->traiterRessourceId(); // ajoute condition id=#valeur
if (isset($this->ressources[1]) && !empty($this->ressources[1])) {
$this->traiterRessourceChamp(); //modifie requete_champ ou requete_condition
}
}
} else { //rajoute distinct pour ne pas avoir plusieurs fois le même nom
$this->requete_champ = array('distinct(nva.num_nom_vernaculaire)', 'nva.nom_vernaculaire ');
}
}
//requete : /noms-vernaculaires/#id (ex : /noms-vernaculaires/7)
public function traiterRessourceId() {
if (is_numeric($this->ressources[0])) {
$this->requete_condition[] = ' nva.num_nom_vernaculaire = '.$this->getBdd()->proteger($this->ressources[0]);
$this->format_reponse .= '/id';
} elseif ($this->ressources[0] == 'attributions') {
$this->format_reponse .= '/attributions';
} else {
$r = 'Erreur dans les ressources de votre requête : </br> La ressource " '.$this->ressources[0].
' " n\'existe pas.';
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $r);
}
}
public function traiterRessourceChamp() {
$this->format_reponse .= '/champ';
$this->analyserChamp();
}
public function analyserChamp() {
$this->requete_champ = array();
$this->recupererTableConfig('champs_possibles');// s'il y a plusieurs champs correspondant au champ demandé ils sont séparé par des |
$champs = explode(' ', $this->ressources[1]);
foreach ($champs as $champ) {
preg_match('/^([^.]+)(\.([^.]+))?$/', $champ, $match);
if (isset($this->champs_possibles[$match[1]])) {
$this->requete_champ[] = str_replace('|', ', ', $this->champs_possibles[$match[1]]);
} elseif (isset($this->champs_possibles[$match[0]])) {
$this->requete_champ[] = str_replace('|', ', ', $this->champs_possibles[$match[0]]);
} else {
$champs_possibles = implode('</li><li>', array_keys($this->champs_possibles));
$c = 'Erreur dans votre requête : </br> Le champ "'.$champ_possibles.'" n\'existe pas. '.
'Les champs disponibles sont : <li>'.$champs_possibles.'</li> et leurs déclinaisons (ex. ".code").';
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $c);
}
}
}
//+------------------------------------------------------------------------------------------------------+
public function assemblerLaRequete() {
$requete = ' SELECT '.$this->formerRequeteChamp().
', CASE nva.code_langue WHEN "fra" THEN 1 ELSE 0 END AS tri '.
' FROM '.str_replace('nva', 'nva_index', $this->table).' inva'.
' LEFT JOIN '.$this->table.' nva ON nva.num_nom_vernaculaire = inva.num_nom_vernaculaire '
.$this->formerRequeteCondition().
' ORDER BY tri DESC, nva.nom_vernaculaire ASC '
.$this->formerRequeteLimite();
return $requete;
}
public function formerRequeteChamp() {
if (in_array('*', $this->requete_champ)) {
$champ = ' * ';
} else {
$champ = implode(', ', $this->requete_champ);
}
return $champ;
}
public function formerRequeteCondition() {
$condition = '';
if ($this->requete_condition != null) {
$condition = ' WHERE '.implode(' AND ', $this->requete_condition);
}
return $condition;
}
//ajout d'une limite seulement pour les listes (pas plus de 100 resultats retournés pr les requetes
// suivantes : /noms-vernaculaires et /noms-vernaculaires/#id/relations)
public function formerRequeteLimite() {
if (in_array($this->format_reponse , array($this->service.'/id', $this->service.'/id/champs'))) {
$this->requete_limite = '';
} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) {
$this->limite_requete['depart'] =
(($this->total_resultat - $this->limite_requete['limite']) < 0) ? 0 : ($this->total_resultat - $this->limite_requete['limite']);
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
} else {
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
}
return $this->requete_limite;
}
//on récupère le nombre total de résultats de la requete (ex : le nombre d'id contenu dans la liste /noms-vernaculaires)
public function recupererTotalResultat() {
$distinct = ($this->format_reponse == 'noms-vernaculaires/attributions') ? '*' : 'distinct nva.num_nom_vernaculaire';
$requete = 'SELECT count('.$distinct.') as nombre FROM '
.str_replace('nva', 'nva_index', $this->table).' inva '
.'INNER JOIN '.$this->table.' nva ON nva.num_nom_vernaculaire = '
.'inva.num_nom_vernaculaire '
.$this->formerRequeteCondition();
$res = $this->getBdd()->recuperer($requete);
if ($res) {
$total = $res['nombre'];
} else {
$t = 'Fonction recupererTotalResultat() : <br/>Données introuvables dans la base '.$requete;
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $t);
}
return $total;
}
//+------------------------------------------------------------------------------------------------------+
// determine en fct du service appelé (/noms-vernaculaires | /noms-vernaculaires/#id | /noms-vernaculaires/#id/champ |
// /noms-vernaculaires/#id/relations) le format du tableau à retourner.
public function retournerResultatFormate($resultat) {
$this->recupererTableConfig('correspondance_champs');
switch ($this->format_reponse) {
case 'noms-vernaculaires' :
$reponse = ($this->retour_format == 'oss') ? $this->formaterEnOss($resultat) : $this->formaterNomsVernaculaires($resultat); break;
case 'noms-vernaculaires/attributions' : $reponse = $this->formaterNomsVernaculairesAttributions($resultat); break;
case 'noms-vernaculaires/id' : $reponse = $this->formaterNomsVernaculairesId($resultat); break;
case 'noms-vernaculaires/id/champ' : $reponse = $this->formaterNomsVernaculairesIdChamp($resultat); break;
default : break;
}
return $reponse;
}
public function ajouterJsonEnTeteNV() {
$table_retour_json['masque'] = $this->recupererMasque();
$table_retour_json['depart'] = $this->limite_requete['depart'];
$table_retour_json['limite'] = $this->limite_requete['limite'];
$table_retour_json['total'] = $this->total_resultat;
$url = $this->formulerUrl($this->total_resultat, '/noms-vernaculaires');
if (isset($url['precedent']) && $url['precedent'] != '') {
$table_retour_json['href.precedent'] = $url['precedent'];
}
if (isset($url['suivant']) && $url['suivant'] != '') {
$table_retour_json['href.suivant'] = $url['suivant'];
}
return $table_retour_json;
}
public function ajouterJsonResultatNV($resultat) {
foreach ($resultat as $tab) {
foreach ($tab as $key => $valeur) {
if ($valeur != '') {
switch ($key) {
case 'num_nom_vernaculaire' : $num = $valeur; break;
case 'nom_vernaculaire' : $this->table_retour['nom'] = $valeur; break;
default : break;
}
}
}
if ($this->retour_format == 'max') $this->table_retour['href'] = $this->ajouterHref('noms-vernaculaires', $num);
$resultat_json[$num] = $this->table_retour;
$this->table_retour = array();
}
return $resultat_json;
}
public function formaterNomsVernaculaires($resultat) {
$table_retour_json['entete'] = $this->ajouterJsonEnTeteNV();
$resultat = $this->hierarchiserResultat($resultat);
$table_retour_json['resultat'] = $this->ajouterJsonResultatNV($resultat);
return $table_retour_json;
}
public function hierarchiserResultat($resultat) {
//tri recherche floue
if (isset($this->parametres['masque.nv'])) {
$resultat = $this->trierRechercheFloue($this->parametres['masque.nv'], $resultat, 'nom_vernaculaire');
}
if (isset($this->parametres['masque'])) {
$resultat = $this->trierRechercheFloue($this->parametres['masque'], $resultat, 'nom_vernaculaire');
}
return $resultat;
}
public function recupererMasque() {
$tab_masque = array();
foreach ($this->parametres as $param=>$valeur) {
if (strstr($param, 'masque') != false) {
$tab_masque[] = $param.'='.$valeur;
}
}
$masque = implode('&', $tab_masque);
return $masque;
}
public function formaterEnOss($resultat) {
$table_nom = array();
$oss = '';
foreach ($resultat as $tab) {
if (isset($tab['nom_vernaculaire']) ) {
if (!in_array($tab['nom_vernaculaire'], $table_nom)) {
$table_nom[] = $tab['nom_vernaculaire'];
$oss [] = $tab['nom_vernaculaire'];
}
}
}
$masque = $this->recupererMasque();
if($masque == "") {
$masque = "Pas de masque";
}
$table_retour_oss = array($masque, $oss);
return $table_retour_oss;
}
public function formaterNomsVernaculairesAttributions($resultat) {
$table_retour_json['entete']['masque'] = $this->recupererMasque();
$table_retour_json['entete']['depart'] = $this->limite_requete['depart'];
$table_retour_json['entete']['limite'] = $this->limite_requete['limite'];
$table_retour_json['entete']['total'] = $this->total_resultat;
$url = $this->formulerUrl($this->total_resultat, '/noms-vernaculaires/attributions');
if (isset($url['precedent']) && $url['precedent'] != '') {
$table_retour_json['entete']['href.precedent'] = $url['precedent'];
}
if (isset($url['suivant']) && $url['suivant'] != '') {
$table_retour_json['entete']['href.suivant'] = $url['suivant'];
}
foreach ($resultat as &$tab) {
unset($tab['tri']);
$id_nom = $tab['num_nom_vernaculaire'];
$resultat_json[$id_nom]['id'] = $id_nom;
$resultat_json[$id_nom]['nom_vernaculaire'] = $tab['nom_vernaculaire'];
$resultat_json[$id_nom]['code_langue'] = $tab['code_langue'];
$resultat_json[$id_nom]['taxon.code'] = 'bdtxa.nt:'.$tab['num_taxon'];
if ($this->retour_format == 'max') {
$resultat_json[$id_nom]['num_taxon'] = $tab['num_taxon'];
$resultat_json[$id_nom]['nom_retenu.code'] = $tab['num_taxon'];
$resultat_json[$id_nom]['taxon'] = $tab['num_taxon'];
$this->taxons[] = $tab['num_taxon']; // utilisé pour chercher les noms latins plus bas
$resultat_json[$id_nom]['href'] = $this->ajouterHref('noms-vernaculaires', $id_nom);
if($this->champs_supp != array()) {
$resultat_json[$id_nom] = $this->ajouterChampsOntologieLigneResultat($tab);
}
}
}
if ($this->retour_format == 'max') {
// On est obligé de faire un deuxième boucle pour demander tous les taxons présents en une
// fois et les attribuer aux noms car c'est beaucoup plus rapide
$noms_sci = $this->recupererNomTaxons();
foreach ($resultat_json as $num_nom => &$tab) {
$tab = $this->ajouterTaxonsAttributionsLigneResultat($tab, $noms_sci);
if($tab == null) {
unset($resultat_json[$num_nom]);
}
}
}
$table_retour_json['resultat'] = $resultat_json;
return $table_retour_json;
}
/**
* Ajoute les champs d'ontologie supplémentaires si necéssaire
* en faisant appels aux web services associés
* @param array $ligne_resultat
*
* @return array la ligne modifiée
*/
public function ajouterChampsOntologieLigneResultat($ligne_resultat) {
$intitule = '';
foreach($this->champ_infos as $cle => $champs_supplementaires) {
if(in_array($cle, $this->champs_supp)) {
extract($champs_supplementaires);
$valeur_recherche = '';
switch($cle) {
case 'taxon':
$valeur_recherche = $ligne_resultat['num_taxon'];
$intitule = 'taxon.code';
break;
}
$code_valeur = '';
if(trim($valeur_recherche) != '') {
$url = $this->ajouterHrefAutreProjet($service, $ressource, $valeur_recherche, $projet);
$code_valeur = $this->chercherSignificationCode($url, $nom);
}
$ligne_resultat[$intitule] = $code_valeur;
}
}
return $ligne_resultat;
}
/**
* Fonction qui ajoute les attributions à une ligne de résultats
*
* @param array $ligne_tableau_resultat
* @param array $nom_sci
*/
public function ajouterTaxonsAttributionsLigneResultat(&$ligne_tableau_resultat, &$noms_sci) {
if (isset($noms_sci[$ligne_tableau_resultat['num_taxon']])) {
$ligne_tableau_resultat['nom_retenu.code'] = $noms_sci[$ligne_tableau_resultat['num_taxon']]['id'];
$ligne_tableau_resultat['taxon'] = $noms_sci[$ligne_tableau_resultat['num_taxon']]['nom_sci'];
} else {
$ligne_tableau_resultat = null;
}
return $ligne_tableau_resultat;
}
private function trierLigneTableau($a, $b) {
$retour = 0;
if ($a[$this->champ_tri] == $b[$this->champ_tri]) {
$retour = 0;
}
if($this->champ_tri == 'code_langue') {
if ($a[$this->champ_tri] == 'fra' && $b[$this->champ_tri] != 'fra') {
$retour = ($this->direction_tri == 'asc') ? -1 : 1;
} else if ($a[$this->champ_tri] != 'fra' && $b[$this->champ_tri] == 'fra') {
$retour = ($this->direction_tri == 'asc') ? 1 : -1;
} else {
$retour = $this->comparerChaineSelonDirectionTri($a[$this->champ_tri], $b[$this->champ_tri]);
}
} else {
$retour = $this->comparerChaineSelonDirectionTri($a[$this->champ_tri], $b[$this->champ_tri]);
}
return $retour;
}
private function comparerChaineSelonDirectionTri($a, $b) {
if($this->direction_tri == 'asc') {
return ($a < $b) ? -1 : 1;
} else {
return ($a > $b) ? -1 : 1;
}
}
// formatage de la reponse /id ss la forme
// id, nom_vernaculaire, attributions
// langue
// num_nom (correspond à un taxon bdtxa)
public function formaterNomsVernaculairesId($resultat) {
foreach ($resultat as $taxon) { // pour chaque attribution à un taxon bdtxa
// on crée les variables qui serviront de clés et on les enléves du tableau
$num_nom = $taxon['num_nom_vernaculaire']; // unique pour un trinôme id, langue, taxon
unset($taxon['num_nom_vernaculaire']);
$langue = $taxon['code_langue'];
unset($taxon['code_langue']);
foreach ($this->correspondance_champs as $key => $correspondance) { // ordonne les infos pour affichage
if (isset($taxon[$key]) && $taxon[$key] != "") {
$this->afficherDonnees($correspondance, $taxon[$key], $langue, $num_nom);
}
}
foreach ($taxon as $key => $valeur) { // rajoute les champs non prévus dans l'api
if (!isset($this->correspondance_champs[$key]) && $valeur != "") {
$this->afficherDonnees($key, $valeur, $langue, $num_nom);
}
}
}
if ($this->retour_format == 'max') $this->afficherTaxons(); // va chercher les noms de tous les taxons
unset($this->table_retour['href']);
return $this->table_retour;
}
public function afficherDonnees($champ, $valeur, $langue = '', $num_nom = '') {
if ($champ == 'num_nom_vernaculaire' || $champ == 'nom_vernaculaire') {
$this->table_retour[$champ] = $valeur;
} elseif (preg_match('/^(.*)\.code$/', $champ, $match)) {
switch ($match[1]) {
case 'taxon' : if ($this->retour_format == 'max') {$this->taxons[$num_nom] = $valeur;}
$this->afficherPointCode($match[1], $langue, $num_nom, $valeur); break;
case 'langue' : //$this->afficherPointCode($match[1], 'iso-639-3', 'langues', $valeur);
break;
default : break;
}
} elseif ($langue != '') {
$this->table_retour['attributions'][$langue][$num_nom][$champ] = $valeur;
} else {
$this->table_retour[$champ] = $valeur;
}
}
public function afficherPointCode($nomChamp, $langue, $num_nom, $valeur) {
if (isset($this->champ_infos[$nomChamp])) {
extract($this->champ_infos[$nomChamp]);
}
if ($this->retour_format == 'max') {
$url = $this->ajouterHrefAutreProjet($service, $ressource, $valeur, $projet);
if ($service == 'taxons') {
$code_valeur = '';
$this->table_retour['attributions'][$langue][$num_nom]['nom_retenu.code'] = $code_valeur;
} else {
$code_valeur = $this->chercherSignificationCode($url, $nom);
}
if ($projet != '') $projet .= '.';
$this->table_retour['attributions'][$langue][$num_nom][$nomChamp] = $code_valeur;
$this->table_retour['attributions'][$langue][$num_nom][$nomChamp.'.code'] = $projet.$ressource.$valeur;
$this->table_retour['attributions'][$langue][$num_nom][$nomChamp.'.href'] = $url;
} else {
if ($projet != '') $projet .= '.';
$this->table_retour['attributions'][$langue][$num_nom][$nomChamp.'.code'] = $projet.$ressource.$valeur;
}
}
public function chercherSignificationCode($url, $nom) {
if (isset($this->signification_code[$url])) {
$valeur = $this->signification_code[$url];
} else {
$res = $this->consulterHref($url);
$valeur = $res->$nom;
$this->signification_code[$url] = $valeur;
}
return $valeur;
}
public function afficherTaxons() {
$resultat = $this->recupererNomTaxons();
foreach ($this->table_retour['attributions'] as $code_langue=>$langue) {
foreach ($langue as $num_nom=>$taxon) {
$num_tax = ltrim($taxon['taxon.code'], 'bdtxa.nt:');
if (isset($resultat[$num_tax])) {
$this->table_retour['attributions'][$code_langue][$num_nom]['nom_retenu.code'] = $resultat[$num_tax]['id'];
$this->table_retour['attributions'][$code_langue][$num_nom]['taxon'] = $resultat[$num_tax]['nom_sci'];
}
}
}
}
public function recupererNomTaxons() {
$taxons = array_unique($this->taxons);
$url = Config::get('url_service_base').'bdtxa/taxons?navigation.limite=500&ns.structure=au&masque.nt='.implode(',', $taxons);
$res = $this->consulterHref($url);
foreach ($res->resultat as $id=>$taxon) {
$resultat[$taxon->num_taxonomique]['id'] = 'bdtxa.nn:'.$id;
$resultat[$taxon->num_taxonomique]['nom_sci'] = $taxon->nom_sci_complet;
}
return $resultat;
}
public function formaterNomsVernaculairesIdChamp($resultat) {
$this->table_retour['id'] = $this->ressources[0];
$champs = explode(' ', $this->ressources[1]);
if (in_array('attributions', $champs) != false) {
$this->formaterNomsVernaculairesId($resultat);
unset($this->table_retour['nom_vernaculaire']);
} else {
$champ_attributions = array('num_taxon', 'zone_usage', 'num_statut', 'num_genre', 'notes');
foreach ($resultat as $taxon) {
foreach ($taxon as $key=>$valeur) {
if ($key == 'code_langue' && in_array('langue', $champs) != false) {
$this->table_retour['attributions']['langue'][] = $valeur;
} elseif (in_array($key, $champ_attributions) != false) {
$this->afficherPoint($this->correspondance_champs[$key] , $valeur, $taxon['code_langue'], $taxon['num_nom_vernaculaire']);
} elseif (in_array($key, $champs) != false) {
$this->table_retour[$key] = $valeur;
}
}
if (in_array('biblio', $champs) != false) $this->chargerBiblio($taxon['num_nom_vernaculaire'], $taxon['code_langue']);
}
if (in_array('biblio', $champs) != false && array_search('biblio.num_ref', $this->table_retour) != false) $this->table_retour['biblio'] = null;
}
return $this->table_retour;
}
public function afficherPoint($champ, $valeur, $langue, $num_nom) {
preg_match('/^(.*)\.code$/', $champ, $match);
$champ = $match[1];
if (isset($this->champ_infos[$champ])) {
extract($this->champ_infos[$champ]);
$url = $this->ajouterHrefAutreProjet($service, $ressource, $valeur, $projet);
$projet .= '.';
}
$champs = explode(' ', $this->ressources[1]);
if (in_array($champ.'.*', $champs) !== false && isset($projet)) {
$this->table_retour['attributions'][$langue][$num_nom][$champ.'.code'] = $projet.$ressource.$valeur;
$this->table_retour['attributions'][$langue][$num_nom][$champ.'.href'] = $url;
}
if (in_array($champ.'.code', $champs) !== false && isset($projet)) {
$this->table_retour['attributions'][$langue][$num_nom][$champ.'.code'] = $projet.$ressource.$valeur;
}
if (in_array($champ.'.href', $champs) !== false && isset($projet)) {
$this->table_retour['attributions'][$langue][$num_nom][$champ.'.href'] = $url;
}
if (in_array($champ, $champs) !== false) {
if (isset($url)) {
$this->table_retour['attributions'][$langue][$num_nom][$champ] = $this->chercherSignificationCode($url, $nom);
} else {
$this->table_retour['attributions'][$langue][$champ] = $valeur;
}
}
}
public function afficherLangue($nomChamp, $projet, $service, $valeur, $ressource = '', $nom = 'nom') {
if ($this->retour_format == 'max') {
$this->table_retour['attributions'][$nomChamp] = $nom;
$this->table_retour['attributions'][$nomChamp.'.code'] = $projet.$ressource.$valeur;
$this->table_retour['attributions'][$nomChamp.'.href'] = $url;
} else {
$this->table_retour['attributions'][$nomChamp.'.code'] = $projet.$ressource.$valeur;
}
}
}
?>

/branches/v5.12-baouque/services/modules/0.1/nvps/NomsVernaculaires.php
New file
0,0 → 1,652
<?php
/**
* Description :
* Classe NomsVernaculaires.php fournit une liste de noms vernaculaires et leur liaison à la bdtfx
* Le but étant de fournir un ensemble minimal d'information comprenant :
* un identifiant (numérique ou alphanumérique sous forme de ChatMot si possible), un nom, une langue et
* une relation avec un taxon de la bdtfx.
* Si l'url finit par /noms-vernaculaires on retourne une liste de noms (seulement les 100 premières par défaut).
* L'url peut contenir des paramètres optionnels passés après le ? : /observations?param1=val1&param2=val2&...
*
* Les paramètres de requête disponibles sont : masque, masque.code, masque.nom, masque.region , recherche,
* distinct, retour.format, navigation.depart et navigation.limite.
*
* Encodage en entrée : utf8
* Encodage en sortie : utf8
* @package framework-v3
* @author Delphine Cauquil <delphine@tela-botanica.org>
* @author Jennifer Dhé <jennifer.dhe@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-${year} Tela Botanica (accueil@tela-botanica.org)
*/
class NomsVernaculaires extends Commun {
protected $champ_infos = array(
'taxon' => array('service' => 'taxons', 'ressource' => 'nt:', 'projet' => 'bdtfx', 'nom' => 'nom_sci'));
protected $service = 'noms-vernaculaires';
/**
* Permet de stocker la requete formulée : /noms-vernaculaires | /noms-vernaculaires/#id |
* /noms-vernaculaires/#id/champ | /noms-vernaculaires/#id/relations
* Est remplit au cours de l'analyse des ressources (traiterRessources()), par défaut, a la valeur du service.
* Est utilisée principalement pr déterminer le format du tableau à retourner. */
protected $format_reponse = 'noms-vernaculaires';
/** Variables constituant les parametres de la requete SQL (champ, condition, limit) remplie
* selon ressources et paramètres */
protected $requete_champ = array(' * ');
protected $requete_condition = '';
protected $limite_requete = array(
'depart' => 0,
'limite' => 100
);
protected $champ_tri = 'code_langue';
protected $direction_tri = 'asc';
/**
* Indique les champs supplémentaires à retourner
* - conseil_emploi = conseil d'emploi du nom vernaculaire
* - genre = genre et nombre du nom
* - taxon = nom retenu associé à ce nom
*/
protected $champs_supp = array();
/**
* Precise la contenance plus ou moins précise du tableau à retourner :
* - min = les données présentes dans la table
* - max = les données de la table + les informations complémentaires (pour les identifiants et les codes)
* - oss = la liste des nom_sci (uniquement pour noms et taxons) */
protected $retour_format = 'max';
/** Valeur du paramètre de requete recherche :
* - stricte : le masque est passé tel quel à l'opérateur LIKE.
* - etendue : ajout automatique du signe % à la place des espaces et en fin de masque avec utilisation de LIKE.
* - floue : recherche tolérante vis-à-vis d'approximations ou d'erreurs (fautes d'orthographe par exemple) */
protected $recherche;
/** Permet de stocker le tableau de résultat (non encodé en json) */
protected $table_retour = array();
/** Stocke le nombre total de résultats de la requete principale. Est calculée lors de l'assemblage de la requete */
protected $total_resultat;
protected $config;
public function __construct($config) {
$this->config = is_null($config) ? Config::get('NomsVernaculaires') : $config;
}
//+------------------------------------------------------------------------------------------------------+
// créer une condition en fonction du paramétre
public function traiterParametres() {
if (isset($this->parametres) && !empty($this->parametres)) {
if (isset($this->parametres['recherche']) && $this->parametres['recherche'] != '') {
$this->recherche = $this->parametres['recherche'];
}
foreach ($this->parametres as $param => $valeur) {
switch ($param) {
case 'masque' :
$this->ajouterFiltreMasque('nom_vernaculaire', $valeur);
break;
case 'masque.nt' :
$this->ajouterFiltreMasque('num_taxon', $valeur);
break;
case 'masque.nv' :
$this->ajouterFiltreMasque('nom_vernaculaire', $valeur);
break;
case 'masque.lg' :
$this->ajouterFiltreMasque('code_langue', $valeur);
break;
case 'masque.cce' :
$this->ajouterFiltreMasque('num_statut', $valeur);
break;
case 'retour.format' :
$this->retour_format = $valeur;
break;
case 'navigation.depart' :
$this->limite_requete['depart'] = $valeur;
break;
case 'navigation.limite' :
$this->limite_requete['limite'] = $valeur;
break;
case 'retour.champs' :
$this->champs_supp = explode(',',$valeur);
break;
case 'recherche' :
break;
case 'version.projet' :
break;
default :
$p = 'Erreur dans les paramètres de recherche de votre requête : '.
'</br> Le paramètre " '.$param.' " n\'existe pas.';
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $p);
}
}
}
}
public function ajouterFiltreMasque($nom_champ, $valeur) {
if ($nom_champ == 'num_taxon') { // si il s'agit d'un chiffre
$this->requete_condition[] = $nom_champ.' = '.$this->getBdd()->proteger($valeur);
} else {
if ($this->recherche == 'floue') {
$this->requete_condition[] = '(SOUNDEX('.$nom_champ.') = SOUNDEX(\''.$valeur.'\')'
.' OR SOUNDEX(REVERSE('.$nom_champ.')) = SOUNDEX(REVERSE(\''.$valeur.'\'))) ';
} else {
if ($this->recherche == 'etendue') {
$valeur = '%'.str_replace(' ','% ', $valeur);
$valeur .= '%';
}
$this->requete_condition[] = $nom_champ.' LIKE '.$this->getBdd()->proteger($valeur);
}
}
}
//+------------------------------------------------------------------------------------------------------+
// en fonction de la présence des ressources modifie requete_champ et requete_condition
public function traiterRessources() {
if (isset($this->ressources) && !empty($this->ressources)) {
if (isset($this->ressources[0]) && !empty($this->ressources[0])) {
$this->traiterRessourceId(); // ajoute condition id=#valeur
if (isset($this->ressources[1]) && !empty($this->ressources[1])) {
$this->traiterRessourceChamp(); //modifie requete_champ ou requete_condition
}
}
} else { //rajoute distinct pour ne pas avoir plusieurs fois le même nom
$this->requete_champ = array('distinct(id)', 'nom_vernaculaire ');
}
}
//requete : /noms-vernaculaires/#id (ex : /noms-vernaculaires/7)
public function traiterRessourceId() {
if (is_numeric($this->ressources[0])) {
$this->requete_condition[] = ' id = '.$this->getBdd()->proteger($this->ressources[0]);
$this->format_reponse .= '/id';
} elseif ($this->ressources[0] == 'attributions') {
$this->format_reponse .= '/attributions';
} else {
$r = 'Erreur dans les ressources de votre requête : </br> La ressource " '.$this->ressources[0].
' " n\'existe pas.';
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $r);
}
}
public function traiterRessourceChamp() {
$this->format_reponse .= '/champ';
$this->analyserChamp();
}
public function analyserChamp() {
$this->requete_champ = array();
$this->recupererTableConfig('champs_possibles');// s'il y a plusieurs champs correspondant au champ demandé ils sont séparé par des |
$champs = explode(' ', $this->ressources[1]);
foreach ($champs as $champ) {
preg_match('/^([^.]+)(\.([^.]+))?$/', $champ, $match);
if (isset($this->champs_possibles[$match[1]])) {
$this->requete_champ[] = str_replace('|', ', ', $this->champs_possibles[$match[1]]);
} elseif (isset($this->champs_possibles[$match[0]])) {
$this->requete_champ[] = str_replace('|', ', ', $this->champs_possibles[$match[0]]);
} else {
$champs_possibles = implode('</li><li>', array_keys($this->champs_possibles));
$c = 'Erreur dans votre requête : </br> Le champ "'.$champ_possibles.'" n\'existe pas. '.
'Les champs disponibles sont : <li>'.$champs_possibles.'</li> et leurs déclinaisons (ex. ".code").';
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $c);
}
}
}
//+------------------------------------------------------------------------------------------------------+
public function assemblerLaRequete() {
$requete = ' SELECT '.$this->formerRequeteChamp().
' FROM '.$this->table
.$this->formerRequeteCondition()
.$this->formerRequeteLimite();
return $requete;
}
public function formerRequeteChamp() {
if (in_array('*', $this->requete_champ)) {
$champ = ' * ';
} else {
$champ = implode(', ', $this->requete_champ);
}
return $champ;
}
public function formerRequeteCondition() {
$condition = '';
if ($this->requete_condition != null) {
$condition = ' WHERE '.implode(' AND ', $this->requete_condition);
}
return $condition;
}
//ajout d'une limite seulement pour les listes (pas plus de 100 resultats retournés pr les requetes
// suivantes : /noms-vernaculaires et /noms-vernaculaires/#id/relations)
public function formerRequeteLimite() {
if (in_array($this->format_reponse , array($this->service.'/id', $this->service.'/id/champs'))) {
$this->requete_limite = '';
} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) {
$this->limite_requete['depart'] =
(($this->total_resultat - $this->limite_requete['limite']) < 0) ? 0 : ($this->total_resultat - $this->limite_requete['limite']);
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
} else {
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
}
return $this->requete_limite;
}
//on récupère le nombre total de résultats de la requete (ex : le nombre d'id contenu dans la liste /noms-vernaculaires)
public function recupererTotalResultat() {
$distinct = ($this->format_reponse == 'noms-vernaculaires/attributions') ? 'id' : 'distinct(id)';
$requete = 'SELECT count('.$distinct.') as nombre FROM '
.$this->table
.$this->formerRequeteCondition();
$res = $this->getBdd()->recuperer($requete);
if ($res) {
$total = $res['nombre'];
} else {
$t = 'Fonction recupererTotalResultat() : <br/>Données introuvables dans la base '.$requete;
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $t);
}
return $total;
}
//+------------------------------------------------------------------------------------------------------+
// determine en fct du service appelé (/noms-vernaculaires | /noms-vernaculaires/#id | /noms-vernaculaires/#id/champ |
// /noms-vernaculaires/#id/relations) le format du tableau à retourner.
public function retournerResultatFormate($resultat) {
$this->recupererTableConfig('correspondance_champs');
switch ($this->format_reponse) {
case 'noms-vernaculaires' :
$reponse = ($this->retour_format == 'oss') ? $this->formaterEnOss($resultat) : $this->formaterNomsVernaculaires($resultat); break;
case 'noms-vernaculaires/attributions' : $reponse = $this->formaterNomsVernaculairesAttributions($resultat); break;
case 'noms-vernaculaires/id' : $reponse = $this->formaterNomsVernaculairesId($resultat); break;
case 'noms-vernaculaires/id/champ' : $reponse = $this->formaterNomsVernaculairesIdChamp($resultat); break;
default : break;
}
return $reponse;
}
public function ajouterJsonEnTeteNV() {
$table_retour_json['masque'] = $this->recupererMasque();
$table_retour_json['depart'] = $this->limite_requete['depart'];
$table_retour_json['limite'] = $this->limite_requete['limite'];
$table_retour_json['total'] = $this->total_resultat;
$url = $this->formulerUrl($this->total_resultat, '/noms-vernaculaires');
if (isset($url['precedent']) && $url['precedent'] != '') {
$table_retour_json['href.precedent'] = $url['precedent'];
}
if (isset($url['suivant']) && $url['suivant'] != '') {
$table_retour_json['href.suivant'] = $url['suivant'];
}
return $table_retour_json;
}
public function ajouterJsonResultatNV($resultat) {
foreach ($resultat as $tab) {
foreach ($tab as $key => $valeur) {
if ($valeur != '') {
switch ($key) {
case 'id' : $num = $valeur; break;
case 'nom_vernaculaire' : $this->table_retour['nom'] = $valeur; break;
default : break;
}
}
}
if ($this->retour_format == 'max') $this->table_retour['href'] = $this->ajouterHref('noms-vernaculaires', $num);
$resultat_json[$num] = $this->table_retour;
$this->table_retour = array();
}
return $resultat_json;
}
public function formaterNomsVernaculaires($resultat) {
$table_retour_json['entete'] = $this->ajouterJsonEnTeteNV();
$resultat = $this->hierarchiserResultat($resultat);
$table_retour_json['resultat'] = $this->ajouterJsonResultatNV($resultat);
return $table_retour_json;
}
public function hierarchiserResultat($resultat) {
//tri recherche floue
if (isset($this->parametres['masque.nv'])) {
$resultat = $this->trierRechercheFloue($this->parametres['masque.nv'], $resultat, 'nom_vernaculaire');
}
if (isset($this->parametres['masque'])) {
$resultat = $this->trierRechercheFloue($this->parametres['masque'], $resultat, 'nom_vernaculaire');
}
return $resultat;
}
public function recupererMasque() {
$tab_masque = array();
foreach ($this->parametres as $param=>$valeur) {
if (strstr($param, 'masque') != false) {
$tab_masque[] = $param.'='.$valeur;
}
}
$masque = implode('&', $tab_masque);
return $masque;
}
public function formaterEnOss($resultat) {
$table_nom = array();
$oss = '';
foreach ($resultat as $tab) {
if (isset($tab['nom_vernaculaire']) ) {
if (!in_array($tab['nom_vernaculaire'], $table_nom)) {
$table_nom[] = $tab['nom_vernaculaire'];
$oss [] = $tab['nom_vernaculaire'];
}
}
}
if (isset($this->masque)) $masque = implode('&', $this->masque);
else $masque = 'Pas de masque';
$table_retour_oss = array($masque, $oss);
return $table_retour_oss;
}
public function formaterNomsVernaculairesAttributions($resultat) {
//on remplie la table $table_retour_json['entete']
$table_retour_json['entete']['masque'] = $this->recupererMasque();
$table_retour_json['entete']['depart'] = $this->limite_requete['depart'];
$table_retour_json['entete']['limite'] = $this->limite_requete['limite'];
$table_retour_json['entete']['total'] = $this->total_resultat;
$url = $this->formulerUrl($this->total_resultat, '/noms-vernaculaires/attributions');
if (isset($url['precedent']) && $url['precedent'] != '') {
$table_retour_json['entete']['href.precedent'] = $url['precedent'];
}
if (isset($url['suivant']) && $url['suivant'] != '') {
$table_retour_json['entete']['href.suivant'] = $url['suivant'];
}
foreach ($resultat as &$tab) {
$resultat_json[$tab['id']]['id'] = $tab['id'];
$resultat_json[$tab['id']]['nom_vernaculaire'] = $tab['nom_vernaculaire'];
$resultat_json[$tab['id']]['code_langue'] = $tab['code_langue'];
$resultat_json[$tab['id']]['taxon.code'] = 'bdtfx.nt:'.$tab['num_taxon'];
if ($this->retour_format == 'max') {
$resultat_json[$tab['id']]['num_taxon'] = $tab['num_taxon'];
$resultat_json[$tab['id']]['nom_retenu.code'] = $tab['num_taxon'];
$resultat_json[$tab['id']]['taxon'] = $tab['num_taxon'];
$this->taxons[] = $tab['num_taxon']; // utilisé pour chercher les noms latins plus bas
$resultat_json[$tab['id']]['href'] = $this->ajouterHref('noms-vernaculaires', $tab['id']);
if($this->champs_supp != array()) {
$resultat_json[$tab['id']] = $this->ajouterChampsOntologieLigneResultat($tab);
}
}
}
if ($this->retour_format == 'max') {
// On est obligé de faire un deuxième boucle pour demander tous les taxons présents en une
// fois et les attribuer aux noms car c'est beaucoup plus rapide
$noms_sci = $this->recupererNomTaxons();
foreach ($resultat_json as $num_nom => &$tab) {
$tab = $this->ajouterTaxonsAttributionsLigneResultat($tab, $noms_sci);
if($tab == null) {
unset($resultat_json[$num_nom]);
}
}
}
uasort($resultat_json, array($this,'trierLigneTableau'));
$table_retour_json['resultat'] = $resultat_json;
return $table_retour_json;
}
/**
* Ajoute les champs d'ontologie supplémentaires si necéssaire
* en faisant appels aux web services associés
* @param array $ligne_resultat
*
* @return array la ligne modifiée
*/
public function ajouterChampsOntologieLigneResultat($ligne_resultat) {
$intitule = '';
foreach($this->champ_infos as $cle => $champs_supplementaires) {
if(in_array($cle, $this->champs_supp)) {
extract($champs_supplementaires);
$valeur_recherche = '';
switch($cle) {
case 'taxon':
$valeur_recherche = $ligne_resultat['num_taxon'];
$intitule = 'taxon.code';
break;
}
$code_valeur = '';
if(trim($valeur_recherche) != '') {
$url = $this->ajouterHrefAutreProjet($service, $ressource, $valeur_recherche, $projet);
$code_valeur = $this->chercherSignificationCode($url, $nom);
}
$ligne_resultat[$intitule] = $code_valeur;
}
}
return $ligne_resultat;
}
/**
* Fonction qui ajoute les attributions à une ligne de résultats
*
* @param array $ligne_tableau_resultat
* @param array $nom_sci
*/
public function ajouterTaxonsAttributionsLigneResultat(&$ligne_tableau_resultat, &$noms_sci) {
if (isset($noms_sci[$ligne_tableau_resultat['num_taxon']])) {
$ligne_tableau_resultat['nom_retenu.code'] = $noms_sci[$ligne_tableau_resultat['num_taxon']]['id'];
$ligne_tableau_resultat['taxon'] = $noms_sci[$ligne_tableau_resultat['num_taxon']]['nom_sci'];
} else {
$ligne_tableau_resultat = null;
}
return $ligne_tableau_resultat;
}
private function trierLigneTableau($a, $b) {
$retour = 0;
if ($a[$this->champ_tri] == $b[$this->champ_tri]) {
$retour = 0;
}
if($this->champ_tri == 'code_langue') {
if ($a[$this->champ_tri] == 'fra' && $b[$this->champ_tri] != 'fra') {
$retour = ($this->direction_tri == 'asc') ? -1 : 1;
} else if ($a[$this->champ_tri] != 'fra' && $b[$this->champ_tri] == 'fra') {
$retour = ($this->direction_tri == 'asc') ? 1 : -1;
} else {
$retour = $this->comparerChaineSelonDirectionTri($a[$this->champ_tri], $b[$this->champ_tri]);
}
} else {
$retour = $this->comparerChaineSelonDirectionTri($a[$this->champ_tri], $b[$this->champ_tri]);
}
return $retour;
}
private function comparerChaineSelonDirectionTri($a, $b) {
if($this->direction_tri == 'asc') {
return ($a < $b) ? -1 : 1;
} else {
return ($a > $b) ? -1 : 1;
}
}
// formatage de la reponse /id ss la forme
// id, nom_vernaculaire, attributions
// langue
// num_nom (correspond à un taxon bdtfx)
public function formaterNomsVernaculairesId($resultat) {
foreach ($resultat as $taxon) { // pour chaque attribution à un taxon bdtfx
// on crée les variables qui serviront de clés et on les enléves du tableau
$num_nom = $taxon['id']; // unique pour un trinôme id, langue, taxon
$langue = $taxon['code_langue'];
unset($taxon['code_langue']);
foreach ($this->correspondance_champs as $key => $correspondance) { // ordonne les infos pour affichage
if (isset($taxon[$key]) && $taxon[$key] != "") {
$this->afficherDonnees($correspondance, $taxon[$key], $langue, $num_nom);
}
}
foreach ($taxon as $key => $valeur) { // rajoute les champs non prévus dans l'api
if (!isset($this->correspondance_champs[$key]) && $valeur != "") {
$this->afficherDonnees($key, $valeur, $langue, $num_nom);
}
}
}
if ($this->retour_format == 'max') $this->afficherTaxons(); // va chercher les noms de tous les taxons
unset($this->table_retour['href']);
return $this->table_retour;
}
public function afficherDonnees($champ, $valeur, $langue = '', $num_nom = '') {
if ($champ == 'id' || $champ == 'nom_vernaculaire') {
$this->table_retour[$champ] = $valeur;
} elseif (preg_match('/^(.*)\.code$/', $champ, $match)) {
switch ($match[1]) {
case 'taxon' : if ($this->retour_format == 'max') {$this->taxons[$num_nom] = $valeur;}
$this->afficherPointCode($match[1], $langue, $num_nom, $valeur); break;
case 'langue' : //$this->afficherPointCode($match[1], 'iso-639-3', 'langues', $valeur);
break;
default : break;
}
} elseif ($langue != '') {
$this->table_retour['attributions'][$langue][$num_nom][$champ] = $valeur;
} else {
$this->table_retour[$champ] = $valeur;
}
}
public function afficherPointCode($nomChamp, $langue, $num_nom, $valeur) {
if (isset($this->champ_infos[$nomChamp])) {
extract($this->champ_infos[$nomChamp]);
}
if ($this->retour_format == 'max') {
$url = $this->ajouterHrefAutreProjet($service, $ressource, $valeur, $projet);
if ($service == 'taxons') {
$code_valeur = '';
$this->table_retour['attributions'][$langue][$num_nom]['nom_retenu.code'] = $code_valeur;
} else {
$code_valeur = $this->chercherSignificationCode($url, $nom);
}
if ($projet != '') $projet .= '.';
$this->table_retour['attributions'][$langue][$num_nom][$nomChamp] = $code_valeur;
$this->table_retour['attributions'][$langue][$num_nom][$nomChamp.'.code'] = $projet.$ressource.$valeur;
$this->table_retour['attributions'][$langue][$num_nom][$nomChamp.'.href'] = $url;
} else {
if ($projet != '') $projet .= '.';
$this->table_retour['attributions'][$langue][$num_nom][$nomChamp.'.code'] = $projet.$ressource.$valeur;
}
}
public function chercherSignificationCode($url, $nom) {
if (isset($this->signification_code[$url])) {
$valeur = $this->signification_code[$url];
} else {
$res = $this->consulterHref($url);
$valeur = $res->$nom;
$this->signification_code[$url] = $valeur;
}
return $valeur;
}
public function afficherTaxons() {
$resultat = $this->recupererNomTaxons();
foreach ($this->table_retour['attributions'] as $code_langue=>$langue) {
foreach ($langue as $num_nom=>$taxon) {
$num_tax = ltrim($taxon['taxon.code'], 'bdtfx.nt:');
if (isset($resultat[$num_tax])) {
$this->table_retour['attributions'][$code_langue][$num_nom]['nom_retenu.code'] = $resultat[$num_tax]['id'];
$this->table_retour['attributions'][$code_langue][$num_nom]['taxon'] = $resultat[$num_tax]['nom_sci'];
}
}
}
}
public function recupererNomTaxons() {
$taxons = array_unique($this->taxons);
$url = Config::get('url_service_base').'bdtfx/taxons?navigation.limite=500&ns.structure=au&masque.nt='.implode(',', $taxons);
$res = $this->consulterHref($url);
foreach ($res->resultat as $id=>$taxon) {
$resultat[$taxon->num_taxonomique]['id'] = 'bdtfx.nn:'.$id;
$resultat[$taxon->num_taxonomique]['nom_sci'] = $taxon->nom_sci_complet;
}
return $resultat;
}
public function formaterNomsVernaculairesIdChamp($resultat) {
$this->table_retour['id'] = $this->ressources[0];
$champs = explode(' ', $this->ressources[1]);
if (in_array('attributions', $champs) != false) {
$this->formaterNomsVernaculairesId($resultat);
unset($this->table_retour['nom_vernaculaire']);
} else {
$champ_attributions = array('num_taxon', 'genre', 'notes');
foreach ($resultat as $taxon) {
foreach ($taxon as $key=>$valeur) {
if ($key == 'code_langue' && in_array('langue', $champs) != false) {
$this->table_retour['attributions']['langue'][] = $valeur;
} elseif (in_array($key, $champ_attributions) != false) {
$this->afficherPoint($this->correspondance_champs[$key] , $valeur, $taxon['code_langue'], $taxon['id']);
} elseif (in_array($key, $champs) != false) {
$this->table_retour[$key] = $valeur;
}
}
}
}
return $this->table_retour;
}
public function afficherPoint($champ, $valeur, $langue, $num_nom) {
preg_match('/^(.*)\.code$/', $champ, $match);
$champ = $match[1];
if (isset($this->champ_infos[$champ])) {
extract($this->champ_infos[$champ]);
$url = $this->ajouterHrefAutreProjet($service, $ressource, $valeur, $projet);
$projet .= '.';
}
$champs = explode(' ', $this->ressources[1]);
if (in_array($champ.'.*', $champs) !== false && isset($projet)) {
$this->table_retour['attributions'][$langue][$num_nom][$champ.'.code'] = $projet.$ressource.$valeur;
$this->table_retour['attributions'][$langue][$num_nom][$champ.'.href'] = $url;
}
if (in_array($champ.'.code', $champs) !== false && isset($projet)) {
$this->table_retour['attributions'][$langue][$num_nom][$champ.'.code'] = $projet.$ressource.$valeur;
}
if (in_array($champ.'.href', $champs) !== false && isset($projet)) {
$this->table_retour['attributions'][$langue][$num_nom][$champ.'.href'] = $url;
}
if (in_array($champ, $champs) !== false) {
if (isset($url)) {
$this->table_retour['attributions'][$langue][$num_nom][$champ] = $this->chercherSignificationCode($url, $nom);
} else {
$this->table_retour['attributions'][$langue][$champ] = $valeur;
}
}
}
public function afficherLangue($nomChamp, $projet, $service, $valeur, $ressource = '', $nom = 'nom') {
if ($this->retour_format == 'max') {
$this->table_retour['attributions'][$nomChamp] = $nom;
$this->table_retour['attributions'][$nomChamp.'.code'] = $projet.$ressource.$valeur;
$this->table_retour['attributions'][$nomChamp.'.href'] = $url;
} else {
$this->table_retour['attributions'][$nomChamp.'.code'] = $projet.$ressource.$valeur;
}
}
}
?>

/branches/v5.12-baouque/services/modules/0.1/baseflor/GraphiquesBaseflor.php
New file
0,0 → 1,125
<?php
/**
* Classe GraphiquesBaseflor.php transforme les données écologiques de la table baseflor
* en graphique svg
* graphiques/#typegraphique/#bdnt.nn:#num_nomen --> renvoie un graphique avec les données connues
*
*
* @package eflore-projets
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @author Mathilde SALTHUN-LASSALLE <mathilde@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)
*/
class GraphiquesBaseflor extends CommunGraphiques{
public function definirTable($version){
$this->table = Config::get('bdd_table')."_v".$version;
}
//+--------------------------traitement ressources ou paramètres -------------------------------------------+
public function traiterReferentieletNum(){
if (!empty($this->ressources[1])) {
if(preg_match('/^(.+)\.nn:([0-9|,]+)$/', $this->ressources[1], $retour) == 1){
switch ($retour[1]) {
case 'bdtfx' :
$this->requete_condition[]= "num_nomen = ".$retour[2]." AND bdnt = 'bdtfx' ";
break;
case 'bdafx' :
$this->requete_condition[] = "num_nomen = ".$retour[2]." AND bdnt = 'bdafx' ";
break;
case 'bdbfx' :
$this->requete_condition[] = "num_nomen = ".$retour[2]." AND bdnt = 'bdbfx' ";
break;
default :
$e = "Le référentiel {$retour[1]} n'existe pas.";
throw new Exception( $e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
break;
}
}else {
$e = "Erreur dans l'url de votre requête :".
" précisez le référentiel et le numéro nomenclatural sous la forme {bdnt}.nn:{nn}.";
throw new Exception( $e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
} else {
throw new Exception( "Erreur dans l'url de votre requête :".
" précisez le référentiel et le numéro nomenclatural sous la forme {bdnt}.nn:{nn}.",
RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
public function traiterTypeGraphique(){
if (!empty($this->ressources[0])) {
switch ($this->ressources[0]) {
case 'climat' :
$this->requete_champs = ' ve_lumiere , ve_temperature, ve_continentalite, ve_humidite_atmos' ;
$this->nomGraphique= 'climat';
break;
case 'sol' :
$this->requete_champs = ' ve_humidite_edaph , ve_reaction_sol, ve_nutriments_sol, ve_salinite,'
.'ve_texture_sol, ve_mat_org_sol' ;
$this->nomGraphique = 'sol';
break;
default :
$e = "Erreur dans l'url de votre requête :".
"</br> precisez le graphique -> \"sol\" ou \"climat\".";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
break;
}
}else {
throw new Exception("Erreur dans l'url de votre requête :".
"</br> precisez le graphique -> \"sol\" ou \"climat\".", RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
//+-------------------------- formatage du résultat -------------------------------------------+
/// ++++ svg +++++ ///
public function changerValeursSVG(){
$Dompath = new DOMXPath($this->dom);
foreach ($this->valeurs_en_pourcentage as $cle => $val) {
if ($val !== null) { // sinon valeur inconnue donc pas de point rouge
$val = preg_replace('/,/','.', $val);
$grad_id = array_search($val,$this->graduations_id);
$element = $Dompath->query("//*[@id='".$grad_id."']")->item(0);
if($element != null) {
$pos_x = $element->getAttribute('x1');
$curseur = $Dompath->query("//*[@id='".$cle."']")->item(0);
$curseur->setAttribute('cx', $pos_x);
$curseur->setAttribute('class', 'curseur');
$this->ajouterInfoAuSurvol($curseur);
$changement = true;
}
}
}
$this->ajusterFormatSVG();
}
public function ajouterInfoAuSurvol($curseur){
$champs = $curseur->getAttribute('id');
$valeurTexte = $this->recupererOntologies($this->valeurs_champs[$champs], $champs );
if ($valeurTexte !== false) {
$valeurTexte = $this->traiterIntermediaires($valeurTexte->nom, $champs, $champs);
$curseur->setAttribute('title',$this->valeurs_champs[$champs].": ".$valeurTexte );
}
}
}
?>

/branches/v5.12-baouque/services/modules/0.1/baseflor/InformationsBaseflor.php
New file
0,0 → 1,507
<?php
/**
* Classe InformationsBaseflor.php permet de faire des requetes de baseflor en fonction d'un référentiel
*( BDTFX, BDAFX, BDBFX ) et d'un numéro nomenclatural ( différent de 0 ).
* fin d'url possibles :
* /informations/#bdnt.nn:#num_nomen --> retourne tous les champs pour un BDNT et un num_nomen
* /informations/#bdnt.nn:#num_nomen?champs=description --> retourne champs description pour un BDNT et un num_nomen
* /informations/#bdnt.nn:#num_nomen?champs=ecologie --> retourne champs ecologiques pour un BDNT et un num_nomen
* /informations/#bdnt.nn:#num_nomen/relations/catminat --> donne les num nomen et les bdnt pour tous
* les taxons qui ont le même code catminat ( code milieu ) que celui entré
*
* Encodage en entrée : utf8
* Encodage en sortie : utf8
* @package eflore-projets
* @author Mathilde SALTHUN-LASSALLE <mathilde@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-2012 Tela Botanica (accueil@tela-botanica.org)
*/
class InformationsBaseflor extends Commun{
protected $table = "";
private $format_reponse = 'informations';
private $retour_format = 'max';
private $champs_ontologiques = array();
protected $serviceNom = 'informations';
private $Bdd;
private $requete_condition = "";
private $champs_recherches = '*';
private $resultat_json;
private $nb_ressources;
protected $limite_requete = array( 'depart' => 0, 'limite' => 10);
public function consulter($ressources, $parametres) {
$this->ressources = $ressources;
$this->parametres = $parametres;
$this->nb_ressources = count($ressources);
$this->traiterParametres();
$this->definirTables();
$this->traiterRessources();
$resultats = null;
foreach ($this->table_version as $version) {
$this->table = $version;
$requete = $this->assemblerLaRequete();
$resultat = $this->Bdd->recupererTous($requete);
$versionResultat = $this->analyserResultat($resultat);
if (count($this->table_version) > 1) {
$resultats[$version] = $versionResultat;
} else {
$resultats = $versionResultat;
}
}
return $resultats;
}
public function __construct(Conteneur $Conteneur) {
$this->Bdd = $Conteneur->getBdd();
}
public function analyserResultat($resultat) {
$versionResultat = null;
if ($resultat == '') {
$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);
}
return $versionResultat;
}
//+--------------------------traitement ressources ou paramètres -------------------------------------------+
public function traiterParametres() {
if (isset($this->parametres) && !empty($this->parametres)) {
foreach ($this->parametres as $param => $valeur) {
switch ($param) {
case 'categorie' :
if($this->nb_ressources != 1 ) {
$e = "Nombre de ressource != 1 pour informations/#id/relations/catminat";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
if ($valeur == "description") {
$this->champs_recherches = "num_nomen, BDNT, chorologie, inflorescence,"
." sexualite, ordre_maturation, "
."pollinisation, fruit, dissemination, couleur_fleur, macule, floraison, type_bio, "
."form_vegetale ";
$this->requete_condition[] = "( chorologie != '' OR inflorescence != '' ".
"OR sexualite != '' OR ordre_maturation != '' OR pollinisation != '' ".
"OR fruit != '' OR dissemination != '' OR couleur_fleur != '' OR macule != '' ".
"OR floraison != '' OR type_bio != '' OR form_vegetale != '' )";
} elseif ($valeur == "ecologie") {
$this->champs_recherches = " num_nomen, BDNT, ve_lumiere , ve_temperature,"
." ve_continentalite, ve_humidite_atmos, ve_humidite_edaph, ve_reaction_sol,"
." ve_nutriments_sol, ve_salinite, ve_texture_sol, ve_mat_org_sol, "
." vi_lumiere, vi_temperature, vi_continentalite, vi_humidite_edaph,"
." vi_reaction_sol, vi_nutriments_sol, vi_salinite ";
$this->requete_condition[] = "( ve_lumiere != '' OR ve_temperature != '' ".
"OR ve_continentalite != '' OR ve_humidite_atmos != '' ".
"OR ve_humidite_edaph != '' OR ve_reaction_sol != '' ".
"OR ve_nutriments_sol != '' OR ve_salinite != '' ".
"OR ve_texture_sol != '' OR ve_mat_org_sol != '' )";
} else {
$e = "Valeur de paramètre inconnue pour 'categorie'. Ce paramètre n'est pas autorisé pour informations/#id/relations/catminat";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
break;
case 'retour.format' :
if ($valeur == 'min' || $valeur == 'max' && $this->nb_ressources == 1) {
$this->retour_format = $valeur;
} else {
$e = "Valeur de paramètre inconnue pour 'retour.format'. Ce paramètre n'est pas autorisé pour informations/#id/relations/catminat";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
break;
case 'navigation.depart' :
$this->definirNavigationDepart($valeur);
break;
case 'navigation.limite' :
$this->definirNavigationLimite($valeur);
break;
case 'version.projet' :
$this->traiterVersion($valeur);
break;
default :
$e = 'Erreur dans les parametres de votre requête : </br> Le paramètre " '
.$param.' " n\'existe pas.';
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
break;
}
}
}
}
public function traiterRessources() {
if(preg_match('/^(.+)\.nn:([0-9]+)$/', $this->ressources[0], $retour)){
$id = $retour[2];
$ref = $retour[1];
if ($ref == 'bdtfx' || $ref == 'bdafx' || $ref == 'bdbfx') {
if($this->nb_ressources == 1) {
$this->requete_condition[] = "num_nomen = ".$id." AND BDNT = '".strtoupper($ref)."' ";
} else {
$this->definirParametresRequeteRelations($ref, $id);
}
} else {
$e = 'Erreur dans l\'url de votre requête : </br> Le référentiel " '
.$ref.' " n\'existe pas.';
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
} else {
$e = 'Erreur dans l\'url de votre requête : </br> La ressource demandée n\'existe pas.';
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
function definirParametresRequeteRelations($ref, $id){
if ($this->ressources[1] == 'relations'){
switch ($this->ressources[2]) {
case 'catminat' :
$this->requete_condition[] = "catminat_code = ( SELECT catminat_code from ".$this->table_version[0]." WHERE "
." num_nomen = ".$id." AND BDNT = '".$ref. "' ) AND num_nomen != ".$id." ";
$this->champs_recherches = " catminat_code, num_nomen, BDNT, nom_sci ";
break;
default :
$e = 'Erreur dans l\'url de votre requête : </br> Le type de relation " '
.$this->ressources[2].' " n\'existe pas.';
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
break;
}
} else {
$e = 'Erreur dans l\'url de votre requête : </br> Le type de ressources " '
.$this->ressources[1].' " n\'existe pas.';
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
//+++------------------------------traitement des versions----------------------------------------++
public function traiterVersion($valeur) {
if (preg_match('/^[0-9]+(?:[._][0-9]+)*$/', $valeur) || $valeur == '+') {
$this->version_projet = $valeur;
} elseif ($valeur == '*') {
$this->version_projet = ($this->nb_ressources == 1) ? $valeur : '+' ;
} else {
$e = "Erreur : La version est inconnue.";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
public function definirTables() {
$table_num_version = $this->recupererVersionDisponible();
$prefixe_table = config::get('bdd_table');
if ( in_array($this->version_projet,$table_num_version) ) {
$this->table_version[] = $prefixe_table.'_v'.$this->version_projet;
} elseif ($this->version_projet == '+') {
$derniere_version = $table_num_version[count($table_num_version) - 1];
$this->table_version[] = $prefixe_table.'_v'.str_replace('.', '_', $derniere_version);
} elseif ($this->version_projet == '*') {
foreach ($table_num_version as $num_version) {
$this->table_version[] = $prefixe_table.'_v'.str_replace('.', '_', $num_version);
}
} else {
$e = "Erreur : La version est inconnue.";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
//+--------------------------formatages de resultats -------------------------------------------+
public function retournerResultatFormate($resultat) {
$resultat_json = $resultat[0];
if ($this->retour_format == 'max'){
if ($this->nb_ressources == 1) {
if (@$this->parametres['categorie'] == 'ecologie') {
$this->formaterResultatsChampsEcologie($resultat_json);
} elseif (@$this->parametres['categorie'] == 'description') {
$this->formaterResultatsChampsDescription($resultat_json);
}else {
$this->formaterResultatsTousChamps($resultat_json);
}
} else {
$this->formaterResultatsRelations($resultat);
}
} else {
$this->resultat_json = $resultat_json;
}
return $this->resultat_json;
}
public function formaterResultatsRelations($resultat) {
$this->resultat_json['entete'] = $this->ajouterEnteteResultat();
$resultat_json = array();
foreach ($resultat as $cle => $res){
$resultat_json[$cle] = $res ;
$resultat_json[$cle]['href'] = $this->ajouterHref('informations',strtolower($res['BDNT']).".nn:".$res['num_nomen']);
}
$this->resultat_json['resultat'] = $resultat_json;
}
public function ajouterEnteteResultat() {
$entete['depart'] = $this->limite_requete['depart'];
$entete['limite'] = $this->limite_requete['limite'];
$entete['total'] = $this->total_resultat;
$entete['version'] = $this->version_projet;
if ($this->limite_requete['limite'] != '*') {
$url = $this->formulerUrl($this->total_resultat, '/informations/'.$this->ressources[0].'/relations/catminat');
if (isset($url['precedent']) && $url['precedent'] != '') {
$entete['href.precedent'] = $url['precedent'];
}
if (isset($url['suivant']) && $url['suivant'] != '') {
$entete['href.suivant'] = $url['suivant'];
}
}
return $entete;
}
public function formaterResultatsTousChamps($resultat) {
$this->resultat_json = $resultat;
$this->traiterTypeBio();
$graphique_presence = $this->traiterEcologie() ;
if ($graphique_presence) {
$graphique = $this->ajouterLiensGraphique($graphique_presence);
}
}
public function formaterResultatsChampsEcologie($resultat) {
$this->resultat_json = $resultat;
$graphique_presence = $this->traiterEcologie() ;
if ($graphique_presence) {
$graphique = $this->ajouterLiensGraphique($graphique_presence);
}
}
public function formaterResultatsChampsDescription($resultat) {
$this->resultat_json = $resultat;
$this->traiterTypeBio();
}
//vérifie la présence de données écologiques pour les graphiques et récupère leur ontologie
public function traiterEcologie() {
$donnees_presence = false;
$this->champs_ontologiques = Commun::s_recupererTableauConfig('Paramètres.champs_ontologiques');
foreach ($this->champs_ontologiques as $cle => $valeur){
if ($this->resultat_json[$cle] != ""){
$donnees_presence[$this->getNomGraphique($valeur)] = true;
$this->recupererOntologies($this->resultat_json[$cle], $cle);
unset($this->resultat_json[$cle]);
}
}
return $donnees_presence;
}
//donne le nom du graphique correspondant à un champ écologique
public function getNomGraphique($code_ecolo) {
$graphique = null;
if (in_array($code_ecolo, explode(',',Config::get('Paramètres.climat')))) {
$graphique = 'climat';
} elseif (in_array($code_ecolo, explode(',', Config::get('Paramètres.sol')) )) {
$graphique = 'sol';
}
return $graphique;
}
public function traiterTypeBio() {
if ($this->resultat_json['type_bio'] != ""){
$tab_ontologie = $this->recupererOntologiePrTypeBio($this->resultat_json['type_bio']);
unset($this->resultat_json['type_bio']);
$this->resultat_json= array_merge($this->resultat_json,$tab_ontologie);
}
}
public function ajouterLiensGraphique($graphique_presence) {
if ($graphique_presence['climat']) {
$this->resultat_json['graphique_climat']['libelle'] = 'climat';
$this->resultat_json['graphique_climat']['href'] =
$this->ajouterHref('graphiques/climat', strtolower($this->resultat_json['BDNT']).'.nn:'.$this->resultat_json['num_nomen']);
}
if ($graphique_presence['sol']) {
$this->resultat_json['graphique_sol']['libelle'] = 'sol';
$this->resultat_json['graphique_sol']['href'] =
$this->ajouterHref('graphiques/sol', strtolower($this->resultat_json['BDNT']).'.nn:'.$this->resultat_json['num_nomen']);
}
}
//+--------------------------traitement ontologies -------------------------------------------+
public function recupererOntologies($valeur, $champs){
$url = Config::get('url_service_base').Config::get('nom_projet').
'/ontologies/'.$this->champs_ontologiques[$champs].':'.urlencode(urlencode($valeur));
$val = $this->getBdd()->recuperer(sprintf(
"SELECT a.nom FROM baseflor_ontologies a LEFT JOIN baseflor_ontologies b ON a.id = b.id LEFT JOIN baseflor_ontologies c ON b.classe_id = c.id WHERE".
" b.code = BINARY '%s' AND c.code = BINARY '%s' LIMIT 0, 100",
$valeur,
$this->champs_ontologiques[$champs]),
Bdd::MODE_OBJET);
$this->resultat_json[$champs.'.libelle'] = isset($val->nom) ? $val->nom : NULL; // eg: VEMO:0
$this->resultat_json[$champs.'.code'] = $valeur;
$this->resultat_json[$champs.'.href'] = $url;
}
//+-------------ontologie pour le champs type biologique (lire le .txt)---+
public function recupererOntologiePrTypeBio($type_a_traiter){
$resultat_typeBio = "";
if ($type_a_traiter != "") {
$types_prim_sec = $this->separerTypesPrimairesSecondaires($type_a_traiter);
$types_sstypes = $this->classerPrimSecEnTypesSsTypes($types_prim_sec);
$resultat_typeBio = $this->formaterJsonTypeBio($types_sstypes, $type_a_traiter );
}
return $resultat_typeBio;
}
public function classerPrimSecEnTypesSsTypes($types_prim_sec) {
$types_sstypes = '';
foreach ($types_prim_sec as $cle => $tb) {
$types_sstypes[$cle]= $this->separerTypes_SousTypes($tb, $cle);
}
switch (count($types_sstypes)) {
case 1 :
$types_sstypes = $types_sstypes['principal'];
break;
case 2 :
$types_sstypes = array_merge($types_sstypes['principal'],$types_sstypes['secondaire']);
break;
}
return $types_sstypes;
}
public function formaterJsonTypeBio( $types_sstypes, $type_a_traiter) {
$resultat_typeBio['type_bio.code'] = $type_a_traiter;
foreach ($types_sstypes as $cle => $tb) {
if (($cle == 'type.principal') || ($cle == 'type.secondaire')) {
$i = 0;
foreach ($tb as $types) {
$url = Config::get('url_service_base').Config::get('nom_projet').
'/ontologies/TB:'.urlencode(urlencode($types));
$val = $this->consulterHref($url);
$libelle[$cle][$i]= $val->nom;
$detail[$cle][$i]['libelle'] = $val->nom;
$detail[$cle][$i]['code'] = $val->code;
$detail[$cle][$i]['href'] = $url;
$i++;
}
}
if ($cle == 'sous_type.principal' || $cle == 'sous_type.secondaire' ) {
$i = 0;
foreach ($tb as $sstypes) {
$url = Config::get('url_service_base').Config::get('nom_projet').
'/ontologies/ssTT:'.urlencode(urlencode($sstypes));
$val = $this->consulterHref($url);
$libelle[$cle][$i]=$val->nom;
$detail[$cle][$i]['libelle'] = $val->nom;
$detail[$cle][$i]['code'] = $val->code;
$detail[$cle][$i]['href'] = $url;
$i++;
}
}
}
//var_dump($libelle); exit;
$resultat_typeBio['type_bio.libelle']= $this->formaterTypeBioPrLibelle($libelle);
$resultat_typeBio['type_bio.detail'] = $detail;
return $resultat_typeBio;
}
public function formaterTypeBioPrLibelle($info) {
$libelle = implode(', ',$info['type.principal'])." ";
$libelle .= isset($info['sous_type.principal']) ? " (".implode(', ',$info['sous_type.principal']).") " : "";
$libelle .= isset($info['type.secondaire']) ? ", ".implode(', ',$info['type.secondaire'])." " : "";
$libelle .= isset($info['sous_type.secondaire']) ? "(".implode(', ',$info['sous_type.secondaire']).") " : "";
return $libelle;
}
//séparation des principaux et des secondaires
public function separerTypesPrimairesSecondaires($type) {
$types = array();
if (preg_match("/(.+)\((.+)\)\-{0,1}(.+){0,1}/", $type,$retour)) {
$types['principal'] = isset($retour[3]) ? $retour[1].'-'. $retour[3] : $retour[1] ;
$types['secondaire'] = $retour[2];
} else {
$types['principal'] = $type;
}
return $types;
}
public function separerTypes_SousTypes($type_a_traiter, $typePrimOuSec) {
$types = array();
if (preg_match("/^([a-zA-Zé]+)\-(.+)$|^([a-zA-Zé,]+[^\-])$/", $type_a_traiter, $retour)) {
//type
$type = array();
$type[0] = (isset($retour[3])) ? $retour[3] : $retour[1] ;
$type = explode(",", $type[0]);
for ($i = 0 ; $i < count($type); $i++) {
$types['type.'.$typePrimOuSec][$i] = $type[$i];
}
//sous types
$ss_types = array();
if (isset($retour[2]) && $retour[2] != '') {
$ss_types[0] = $retour[2] ;
$ss_types = explode("-", $ss_types[0]);
for ($i = 0 ; $i < count($ss_types); $i++) {
$types['sous_type.'.$typePrimOuSec][$i] = $ss_types[$i];
}
}
}
return $types;
}
//+--------------------------FONCTIONS D'ASSEMBLAGE DE LA REQUETE-------------------------------------------+
public function assemblerLaRequete() {
$requete = ' SELECT '.$this->champs_recherches.' FROM '.$this->table.' '
.Informations::retournerRequeteCondition($this->requete_condition).' ';
if ($this->nb_ressources != 1 ) {
$requete .= $this->delimiterResultatsRequete();
}
return $requete;
}
public function delimiterResultatsRequete() {
$this->total_resultat = Informations::calculerTotalResultat(
$this->getBdd(),
$this->table,
Array(),
$this->requete_condition);
if ($this->limite_requete['limite'] == '*') return '';
if ( ($this->limite_requete['depart'] > $this->total_resultat)) {
throw new Exception(
"Erreur : la valeur pour le paramètre navigation.départ est supérieure au nombre total de résultats.",
RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
}
if (($this->limite_requete['limite'] + $this->limite_requete['depart'] ) < $this->total_resultat) {
return 'LIMIT '.$this->limite_requete['depart'].', ' .$this->limite_requete['limite'];
}
// ?
return '';
}
}

/branches/v5.12-baouque/services/modules/0.1/baseflor/CommunGraphiques.php
New file
0,0 → 1,402
<?php
/**
* Classe CommunGraphiques.php regroupement de fonctions pour les graphiques
* graphiques/#typegraphique/#bdnt.nn:#num_nomen --> renvoie un graphique avec les données connues
*
*
* @package eflore-projets
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @author Mathilde SALTHUN-LASSALLE <mathilde@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 CommunGraphiques extends Commun{
protected $parametres = array();
protected $ressources = array();
protected $Bdd;
protected $config;
protected $cache;
protected $metadonnees;
protected $version;
protected $serviceNom = 'Graphiques';
protected $graduations_id = array();
protected $champs_ontologiques = array();
protected $nomGraphique = array();
protected $table = '';
protected $requete_condition = "";
protected $requete_champs;
protected $convertisseur;
protected $cheminGraphBase;
protected $valeurs_en_pourcentage = array();
protected $dom;
protected $largeurSVG = "500";
protected $hauteurSVG;
protected $valeurs_champs;
public function consulter($ressources, $parametres) {
$this->ressources = $ressources;
$this->parametres = $parametres;
$this->verifierParametres();
$this->initialiserConfiguration();
$resultats = '';
$this->traiterRessources();
$req = $this->assemblerLaRequete();
$resultat = $this->resultat = $this->Bdd->recupererTous($req);
$versionResultat = $this->obtenirResultat($resultat);
return $versionResultat;
}
//+--------------------------initialisation de paramètres -------------------------------------------+
private function initialiserConfiguration() {
$conteneur = new Conteneur();
$this->Bdd = $conteneur->getBdd();
$this->config = $conteneur->getParametre('Graphiques');
$this->convertisseur = $this->config['convertisseur'];
$this->graduations_id = $this->getParametreTableau('Paramètres.graduations_id');
$this->champs_ontologiques = $this->getParametreTableau('Paramètres.champs_ontologiques');
$this->cheminGraphBase = $this->config['chemin'];
$cacheOptions = array('mise_en_cache' => $this->config['cache_miseEnCache'],
'stockage_chemin' => $this->config['cache_stockageChemin'],
'duree_de_vie' => $this->config['cache_dureeDeVie']);
$this->cache = $conteneur->getCacheSimple($cacheOptions);
$this->definirVersion();
$this->definirFormat();
$this->definirTable($this->version);
}
abstract function definirTable($version);
private function getParametreTableau($cle) {
$tableau = array();
$parametre = Config::get($cle);
if (empty($parametre) === false) {
$tableauPartiel = explode(',', $parametre);
$tableauPartiel = array_map('trim', $tableauPartiel);
foreach ($tableauPartiel as $champ) {
if (strpos($champ, '=') !== false && strlen($champ) >= 3) {
list($cle, $val) = explode('=', $champ);
$tableau[trim($cle)] = trim($val);
} else {
$tableau[] = trim($champ);
}
}
}
return $tableau;
}
//+--------------------------traitement ressources ou paramètres -------------------------------------------+
//+---- paramètres ----+
private function verifierParametres() {
if (isset($this->parametres)) {
$parametres_dispo = array('retour', 'retour.format', 'version.projet');
$parametres = array_keys($this->parametres);
foreach ($parametres as $param) {
if (!in_array($param, $parametres_dispo)) {
$erreur = "Erreur : Le paramètre $param est inconnu.";
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
throw new Exception($erreur, $code);
}
}
}
}
//on n'affiche qu'une version de graphique à la fois ( la dernière ou celle demandée )
private function definirVersion() {
$this->chargerVersions();
if (!isset($this->parametres['version.projet']) ) {
$this->version = $this->metadonnees[0]['version'];
} elseif ($this->parametres['version.projet'] == '+') {
$this->version = $this->metadonnees[0]['version'];
} else {
if($this->verifierVersion($this->parametres['version.projet'])) {
$this->version = $this->parametres['version.projet'];
}else {
$erreur = "Erreur : La version est inconnue.";
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
throw new Exception($erreur, $code);
}
}
}
private function verifierVersion($version){
$retour = false;
foreach ($this->metadonnees as $vers) {
if ($vers['version'] == $version ) {
$retour = true;
}
}
return $retour;
}
private function definirFormat() {
if (isset($this->parametres['retour.format']) ){
if (preg_match("/^[0-9]+$/", $this->parametres['retour.format'])){
if ($this->parametres['retour.format'] > 0) {
$this->largeurSVG = $this->parametres['retour.format'];
} else {
$erreur = "Erreur : valeur pour retour.format négative ou égale à 0.";
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
throw new Exception($erreur, $code);
}
}else {
$erreur = "Erreur : valeur inconnue. Entrez la largeur voulue (en pixels) pour le paramètre retour.format.";
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
throw new Exception($erreur, $code);
}
}
if (!isset($this->parametres['retour']) ){
$this->parametres['retour'] = 'image/svg+xml';
}else {
if (( $this->parametres['retour'] != 'image/svg+xml')&& ( $this->parametres['retour'] != 'image/png')){
$erreur = "Erreur : valeur inconnue. Choisissez le format de retour pour le paramètre retour : image/svg%2Bxml ou image/png.";
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
throw new Exception($erreur, $code);
}
}
}
private function chargerVersions() {
$requete = "SELECT version ".
"FROM ".Config::get('bdd_table_meta')." ".
"ORDER BY date_creation DESC ";
$resultats = $this->Bdd->recupererTous($requete);
if (!is_array($resultats) || count($resultats) <= 0) {
$message = "Les méta-données n'ont pu être chargée pour la ressource demandée";
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
}
$this->metadonnees = $resultats;
}
//+----- ressources -----+
public function traiterRessources() {
if(isset($this->ressources)) {
$this->traiterTypeGraphique();
$this->traiterReferentielEtNum();
} else {
$e = 'Erreur dans l\'url de votre requête : </br> ressources insuffisantes.';
throw new Exception( $e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
abstract function traiterReferentielEtNum();
abstract function traiterTypeGraphique();
//+--------------------------FONCTIONS D'ASSEMBLAGE DE LA REQUETE-------------------------------------------+
public function assemblerLaRequete() {
return ' SELECT '.$this->requete_champs.' FROM '.$this->table.' '.Informations::retournerRequeteCondition($this->requete_condition);
}
public function retournerRequeteCondition() {
$condition = '';
if ($this->requete_condition !== "") {
$condition = ' WHERE '.implode(' AND ', $this->requete_condition);
}
return $condition;
}
//+-------------------------- formatage du résultat -------------------------------------------+
public function obtenirResultat($resultat) {
if ($resultat == '') {
throw new Exception(
'La requête SQL formée comporte une erreur!',
RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
} elseif ($resultat) {
if ((count($this->ressources)) != 0) {
//$Atraiter = array_filter($resultat[0],function($var){return ($var != '');});
foreach ($resultat[0] as $champs => $valeur) {
if ($valeur !== null && $valeur !== '') {
$Atraiter[$champs] = $valeur;
}
}
if (!empty($Atraiter)) {
$this->traiterValeursEcologiques($Atraiter);
$svg = $this->genererSVG($this->cheminGraphBase.$this->nomGraphique.".svg");
$resultat = new ResultatService();
$resultat->corps = ($this->parametres['retour'] == 'image/png') ? $this->convertirEnPNG($svg) : $svg;
$resultat->mime = $this->parametres['retour'];
} else {
$resultat = null;
}
}
} else {
$resultat = null;
}
return $resultat;
}
//+----- modification svg -----+
public function traiterValeursEcologiques($valeur) {
$this->valeurs_champs = $valeur;
foreach($this->valeurs_champs as $cle => $val){
if ($val === null) {
$this->valeurs_en_pourcentage[$cle] = null;
} else {
if (preg_match("/ve_humidite_edaph/", $cle)) {
$this->valeurs_en_pourcentage[$cle] = round($val/13,1);
} elseif (preg_match("/ve_salinite/", $cle)) {
$this->valeurs_en_pourcentage[$cle] = round(($val+1)/11,1);
} else {
$this->valeurs_en_pourcentage[$cle] = round($val/10,1);
}
}
}
}
public function donnerHauteur($ancienne_largeur, $ancienne_hauteur) {
$nouvelle_largeur = $this->largeurSVG;
$ancienne_largeur = str_replace('px','',$ancienne_largeur);
$ancienne_hauteur = str_replace('px','',$ancienne_hauteur);
$rapport = $nouvelle_largeur / $ancienne_largeur ;
$nouvelle_hauteur = $ancienne_hauteur * $rapport;
$this->hauteurSVG = $nouvelle_hauteur;
}
public function ajusterFormatSVG(){
$svg = $this->dom->getElementsByTagName("svg")->item(0);
$largeur = $svg->getAttribute('width');
$hauteur = $svg->getAttribute('height');
$this->donnerHauteur($largeur , $hauteur);
$svg->setAttribute('width',round($this->largeurSVG).'px');
$svg->setAttribute('height',round($this->hauteurSVG).'px');
}
public function genererSVG($fichierSvg){
$svg = null;
$this->dom = new DOMDocument('1.0', 'UTF-8');
$this->dom->validateOnParse = true;
$this->dom->load($fichierSvg);
$this->changerValeursSVG();
return $this->dom->saveXML();
}
abstract function changerValeursSVG();
public function recupererOntologies($valeur, $champs){
$url = $this->ajouterHref('ontologies',$this->champs_ontologiques[$champs].':'.urlencode(urlencode($valeur)));
try {
$val = $this->getBdd()->recuperer(sprintf(
"SELECT a.nom FROM baseflor_ontologies a LEFT JOIN baseflor_ontologies b ON a.id = b.id LEFT JOIN baseflor_ontologies c ON b.classe_id = c.id WHERE".
" b.code = BINARY '%s' AND c.code = BINARY '%s' LIMIT 0, 100",
$valeur,
$this->champs_ontologiques[$champs]),
Bdd::MODE_OBJET);
} catch (Exception $e) {
$val = false;
}
return $val;
}
public function traiterIntermediaires($valeurTexte,$champsOntologie, $champsTable){
if (preg_match("/(?:I|i)nterm(?:é|e)diaire(?:s)*/", $valeurTexte )) {
$prec = $this->recupererOntologies(($this->valeurs_champs[$champsTable]-1), $champsOntologie );
$suiv = $this->recupererOntologies(($this->valeurs_champs[$champsTable]+1), $champsOntologie );
$valeurTexte = "Intermédiaires entre $prec->nom et $suiv->nom ";
}
return $valeurTexte;
}
/// +---- convertir png ----+
public function convertirEnPNG($svg) {
$png = null;
if (isset($this->convertisseur)) {
if ($this->convertisseur == 'imagick') {
if (extension_loaded('imagick')) {
$png = $this->convertirEnPNGAvecImageMagick($svg);
} else {
$message = "Impossible de générer l'image sur le serveur. Extension ImageMagick absente.";
$code = RestServeur::HTTP_CODE_ERREUR;
throw new Exception($message, $code);
}
} else if ($this->convertisseur == 'rsvg') {
$png = $this->convertirGraphiqueEnPNGAvecRsvg($svg);
} else {
$message = "Le convertisseur indiqué '{$this->convertisseur}' ne fait pas partie de la liste ".
"des convertisseurs disponibles : imagick, rsvg.";
$code = RestServeur::HTTP_CODE_ERREUR;
throw new Exception($message, $code);
}
} else {
$message = "Veuillez indiquer le convertisseur de svg à utiliser pour le service.";
$code = RestServeur::HTTP_CODE_ERREUR;
throw new Exception($message, $code);
}
return $png;
}
public function convertirEnPNGAvecImageMagick($svg) {
$convertisseur = new Imagick();
$convertisseur->setBackgroundColor(new ImagickPixel('#F8F8F8'));
$convertisseur->readImageBlob($svg);
$convertisseur->setImageFormat('png32');
$convertisseur->resizeImage($this->largeurSVG,$this->hauteurSVG, imagick::FILTER_LANCZOS, 0, true);
$png = $convertisseur->getImageBlob();
$convertisseur->clear();
$convertisseur->destroy();
return $png;
}
public function convertirGraphiqueEnPNGAvecRsvg($svg) {
$idFichier = $this->getIdFichier();
$fichierPng = $this->config['cache_stockageChemin'].$idFichier.'.png';
$fichierSvg = $this->config['cache_stockageChemin'].$idFichier.'.svg';
file_put_contents($fichierSvg, $svg);
$commande = "rsvg-convert $fichierSvg -w ".$this->largeurSVG ." -h ".$this->hauteurSVG ." -o $fichierPng";
//echo $commande; exit;
$rsvg = exec($commande);
$this->indexerGraphiqueFichierPng($fichierPng);
$png = file_get_contents($fichierPng);
return $png;
}
public function indexerGraphiqueFichierPng($fichierPng) {
$img = imagecreatefrompng($fichierPng);
imagetruecolortopalette($img, false, 32);
imagepng($img, $fichierPng, 9, PNG_ALL_FILTERS);
}
public function getIdFichier(){
$idfichier = str_replace(".","-",$this->ressources[1]);
$idfichier = str_replace(':','-',$idfichier);
$idfichier .= "-".$this->ressources[0];
return $idfichier;
}
}
?>

/branches/v5.12-baouque/services/modules/0.1/baseflor/Graphiques.php
New file
0,0 → 1,42
<?php
/**
* Classe Graphiques.php détermine le type de graphiques à afficher en fonction des données des tables
* baseflor et baseflor_rang_sup_ecologie
* fin d'url possibles :
* graphiques/#typegraphique/#bdnt.nn:#num_nomen --> renvoie une graphique avec les données connues
*
*
* @package eflore-projets
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @author Mathilde SALTHUN-LASSALLE <mathilde@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)
*/
class Graphiques extends Commun{
private $Graph_tables = array('GraphiquesBaseflor', 'GraphiquesTaxonsSup');
public function consulter($ressources, $parametres) {
$versionResultat = null;
foreach ($this->Graph_tables as $graph_tab) {
$Graph = new $graph_tab();
$versionResultat = $Graph->consulter($ressources, $parametres);
if($versionResultat != null) {break;}
}
if ($versionResultat == null) {
$message = 'Les données recherchées sont introuvables.';
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
}
return $versionResultat;
}
}
?>

/branches/v5.12-baouque/services/modules/0.1/baseflor/Informations.php
New file
0,0 → 1,287
<?php
/**
* Classe Informations.php interroge la table Index
* et redirige vers une autre classe si besoin
* d'interroger une autre table (comme baseflor ou baseflor_rang_sup)
* elle traite également le retour du web service : /informations
*
* Encodage en entrée : utf8
* Encodage en sortie : utf8
* @package eflore-projets
* @author Mathilde SALTHUN-LASSALLE <mathilde@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-2012 Tela Botanica (accueil@tela-botanica.org)
*
*
*/
class Informations extends Commun {
protected $limite_requete = array( 'depart' => 0, 'limite' => 10);
private $tables;
private $champs_recherches = '*';
private $requete_jointure = array();
private $requete_condition = array();
private $total_resultat;
protected $serviceNom = 'informations';
private $masque;
public function consulter($ressources, $parametres) {
$this->ressources = $ressources;
$this->parametres = $parametres;
$versionResultat = null;
if (empty($this->ressources)){
$this->traiterParametres();
}
$this->definirTables(array ('index' => config::get('bdd_table_index'),
'baseflor' => config::get('bdd_table'),
'rangSup' => config::get('bdd_table_rang_sup')
)
);
$this->traiterRessources();
$requete = $this->assemblerLaRequete();
// exemple:
// SELECT * FROM baseflor_index_v2012_12_31 WHERE `bdnt.nn` = 'bdtfx.nn:XXXXX';
$resultat = $this->Bdd->recupererTous($requete . ' -- ' . __FILE__ . ':' .__LINE__);
$versionResultat = $this->renvoyerResultat($resultat);
if ($versionResultat === null) {
throw new Exception('Les données recherchées sont introuvables.', RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
}
return $versionResultat;
}
public function __construct() {
$Conteneur = new Conteneur();
$this->Bdd = $Conteneur ->getBdd();
}
public function renvoyerResultat($resultat) {
if (empty($this->ressources)) return $this->retournerResultatFormate($resultat);
if(empty($resultat[0]['baseflor'])) {
if(@$this->parametres['categorie'] == 'description') {
// non-supporté par InformationsTaxonsSup.php...
return array();
}
$info = new InformationsTaxonsSup(new Conteneur());
return $info->consulter($this->ressources, $this->parametres);
}
$info = new InformationsBaseflor(new Conteneur());
return $info->consulter($this->ressources, $this->parametres);
}
//+--------------------------traitement ressources ou paramètres -------------------------------------+
public function traiterRessources() {
if (empty($this->ressources)) {
$this->requete_jointure = array(
'LEFT JOIN '. $this->tables['baseflor'].' ON '
.$this->tables['baseflor'].".cle =".$this->tables['index'].".baseflor",
'LEFT JOIN '. $this->tables['rangSup'].' ON '
.$this->tables['rangSup'].".cle = ".$this->tables['index'].".RangSup");
$this->champs_recherches = " {$this->tables['baseflor']}.num_nomen as 'baseflor.nn',
{$this->tables['baseflor']}.BDNT as 'baseflor.bdnt',
{$this->tables['baseflor']}.catminat_code,
{$this->tables['baseflor']}.num_taxon ,
{$this->tables['baseflor']}.nom_sci ,
{$this->tables['rangSup']}.num_nomen as 'rangSup.nn',
{$this->tables['rangSup']}.bdnt as 'rangSup.bdnt',
{$this->tables['index']}.cle as 'index.cle' ";
} else {
if(preg_match('/^(.+)\.nn:([0-9]+)$/', $this->ressources[0], $retour)){
$this->champs_recherches = " baseflor, rangSup ";
$this->requete_condition[] = " `bdnt.nn` = '{$retour[0]}' ";
} else {
$e = 'Erreur dans l\'url de votre requête : </br> La ressource demandée n\'existe pas.';
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
break;
}
}
}
public function traiterParametres() {
if (isset($this->parametres) && !empty($this->parametres) ) {
foreach ($this->parametres as $param => $valeur) {
switch ($param) {
case 'navigation.depart' :
if(!isset($this->parametres['navigation.limite']))
throw new Exception("indiquez également la valeur pour le paramètre navigation.limite.",
RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
$this->definirNavigationDepart($valeur);
break;
case 'navigation.limite' :
if(!isset($this->parametres['navigation.depart']))
throw new Exception("indiquez également la valeur pour le paramètre navigation.depart.",
RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
$this->definirNavigationLimite($valeur);
break;
case 'version.projet' :
$this->traiterVersion($valeur);
break;
case 'masque.cat' :
$this->masque = 'catminat='.str_replace('-','/',$valeur);
$this->requete_condition[] = " catminat_code = '".str_replace('-','/',$valeur)."' ";
break;
default :
$e = 'Erreur dans les parametres de votre requête : </br> Le paramètre " '
.$param.' " n\'existe pas.';
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e); break;
}
}
}
}
//+++------------------------------traitement des versions----------------------------------------++
public function traiterVersion($valeur) {
if (preg_match('/^[0-9]+(?:[._][0-9]+)*$/', $valeur) || $valeur == '*' || $valeur == '+') {
$this->version_projet = $valeur;
} else {
$e = "Erreur : La version est inconnue.";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
if ($this->version_projet == '*' && empty($this->ressources)) {
$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);
}
}
public function definirTables($prefixe_table) {
$table_num_version = $this->recupererVersionDisponible();
foreach ($prefixe_table as $nom => $prefixe ) {
if ( in_array($this->version_projet,$table_num_version) ) {
$tables[$nom] = $prefixe.'_v'.$this->version_projet;
} elseif ($this->version_projet == '+') {
$derniere_version = $table_num_version[count($table_num_version) - 1];
$tables[$nom] = $prefixe.'_v'.str_replace('.', '_', $derniere_version);
} else {
$e = "Erreur : La version est inconnue.";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
$this->tables = $tables;
}
//+--------------------------formatages de resultats -------------------------------------------+
public function retournerResultatFormate($resultat) {
$resultat_json = array();
$resultat_json['entete'] = $this->ajouterEnteteResultat();
$resultat_json['resultats'] = array();
foreach ($resultat as $ligne => $tab) {
$num = $tab['index.cle'];
$resultat_json['resultats'][$num]['num_nomen'] =
(empty ($tab['baseflor.nn'])) ? $tab['rangSup.nn'] : $tab['baseflor.nn'];
$resultat_json['resultats'][$num]['bdnt'] =
(empty ($tab['baseflor.bdnt'])) ? $tab['rangSup.bdnt'] : $tab['baseflor.bdnt'];
$resultat_json['resultats'][$num]['catminat_code'] =
(empty ($tab['catminat_code'])) ? '' : $tab['catminat_code'];
$resultat_json['resultats'][$num]['nom_sci'] =
(empty ($tab['nom_sci'])) ? '' : $tab['nom_sci'];
$resultat_json['resultats'][$num]['num_taxon'] =
(empty ($tab['num_taxon'])) ? '' : $tab['num_taxon'];
if ($resultat_json['resultats'][$num]['num_nomen'] != 0) {
$bdnt = strtolower($resultat_json['resultats'][$num]['bdnt']);
$nn = $resultat_json['resultats'][$num]['num_nomen'];
$resultat_json['resultats'][$num]['href'] =
$this->ajouterHref('informations',$bdnt.".nn:".$nn);
}
}
return $resultat_json;
}
public function ajouterEnteteResultat() {
$entete['depart'] = $this->limite_requete['depart'];
$entete['limite'] = $this->limite_requete['limite'];
$entete['total'] = $this->total_resultat;
if ($this->masque) {
$entete['masque'] = $this->masque;
}
$entete['version'] = $this->version_projet;
$url = $this->formulerUrl($this->total_resultat, '/informations');
if (isset($url['precedent']) && $url['precedent'] != '') {
$entete['href.precedent'] = $url['precedent'];
}
if (isset($url['suivant']) && $url['suivant'] != '') {
$entete['href.suivant'] = $url['suivant'];
}
return $entete;
}
//+-------------------------------------assemblage de requête------------------------------------//
public function assemblerLaRequete() {
$requete = ' SELECT '.$this->champs_recherches.
' FROM '.$this->tables['index'].' '
.self::retournerRequeteJointure($this->requete_jointure).' '
.self::retournerRequeteCondition($this->requete_condition).' '
.$this->delimiterResultatsRequete();
return $requete;
}
static function retournerRequeteCondition($cond) {
return $cond ? (' WHERE '.implode(' AND ', $cond)) : '';
}
static function calculerTotalResultat($db, $table, Array $join, Array $cond) {
$requete = sprintf(
'SELECT count(*) as nombre FROM %s %s %s -- %s:%d',
$table,
$join ? implode(' ', $join) : '',
$cond ? (' WHERE '.implode(' AND ', $cond)) : '',
__FILE__,
__LINE__);
$res = $db->recuperer($requete);
if ($res && $res['nombre']) return $res['nombre'];
throw new Exception('Données introuvables dans la base', RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
}
public function delimiterResultatsRequete() {
$this->total_resultat = self::calculerTotalResultat(
$this->getBdd(),
$this->tables['index'],
$this->requete_jointure,
$this->requete_condition);
$requete_limite = '';
if (($this->limite_requete['depart'] <= $this->total_resultat) ){
if ( $this->limite_requete['depart'] < $this->total_resultat ){
$requete_limite = 'LIMIT '.$this->limite_requete['depart'].', '
.$this->limite_requete['limite'];
}
} else {
$e = "Erreur : la valeur pour le paramètre navigation.départ est supérieure".
" au nombre total de résultats.";
throw new Exception($e, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
}
return $requete_limite;
}
static function retournerRequeteJointure($join) {
return $join ? implode(' ', $join) : '';
}
}

/branches/v5.12-baouque/services/modules/0.1/baseflor/GraphiquesTaxonsSup.php
New file
0,0 → 1,146
<?php
/**
* Classe GraphiquesTaxonsSup.php transforme les données écologiques de la table baseflor_rang_sup_ecologie
* en graphique svg
* graphiques/#typegraphique/#bdnt.nn:#num_nomen --> renvoie un graphique avec les données connues
*
*
* @package eflore-projets
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @author Mathilde SALTHUN-LASSALLE <mathilde@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)
*/
class GraphiquesTaxonsSup extends CommunGraphiques{
public function definirTable($version){
$this->table = Config::get('bdd_table_rang_sup')."_v".$version;
}
//+---- ressources ----+
public function traiterReferentieletNum(){
if (!empty($this->ressources[1])) {
if(preg_match('/^(.+)\.nn:([0-9]+)$/', $this->ressources[1], $retour) == 1){
switch ($retour[1]) {
case 'bdtfx' : // pour le moment un seul referentiel disponible
$this->requete_condition[]= "num_nomen = ".$retour[2]." AND bdnt = 'bdtfx' ";
break;
default :
$e = "Le référentiel {$retour[1]} n'existe pas.";
throw new Exception( $e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
break;
}
}else {
$e = "Erreur dans l'url de votre requête :".
" précisez le référentiel et le numéro nomenclatural sous la forme {bdnt}.nn:{nn}.";
throw new Exception( $e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
} else {
throw new Exception( "Erreur dans l'url de votre requête :".
" précisez le référentiel et le numéro nomenclatural sous la forme {bdnt}.nn:{nn}.",
RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
public function traiterTypeGraphique(){
if (!empty($this->ressources[0])) {
switch ($this->ressources[0]) {
case 'climat' :
$this->requete_champs = ' ve_lumiere_min, ve_lumiere_max, ve_temperature_min,'.
' ve_temperature_max, ve_continentalite_min,'.
' ve_continentalite_max, ve_humidite_atmos_min,'.
' ve_humidite_atmos_max' ;
$this->nomGraphique= 'climat_min_max';
break;
case 'sol' :
$this->requete_champs = ' ve_humidite_edaph_min , ve_humidite_edaph_max,'.
' ve_reaction_sol_min, ve_reaction_sol_max, '.
' ve_nutriments_sol_min, ve_nutriments_sol_max,'.
' ve_salinite_min, ve_salinite_max,'.
' ve_texture_sol_min, ve_texture_sol_max,'.
've_mat_org_sol_min,ve_mat_org_sol_max ' ;
$this->nomGraphique = 'sol_min_max';
break;
default :
$e = "Erreur dans l'url de votre requête :".
"</br> précisez le graphique -> \"sol\" ou \"climat\".";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
break;
}
}else {
throw new Exception("Erreur dans l'url de votre requête :".
"</br> precisez le graphique -> \"sol\" ou \"climat\".", RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
//+-------------------------- formatage du résultat -------------------------------------------+
public function changerValeursSVG(){
$this->ajouterValeursIntermediaires();
$Dompath = new DOMXPath($this->dom);
foreach ($this->valeurs_en_pourcentage as $cle => $val){
$val = preg_replace('/,/','.', $val);
$grad_id = array_search($val,$this->graduations_id);
$champs = preg_replace('/_min|_max|_[0-9]/','', $cle);
// dans le cas de mauvaises données, pour ne pas que tout le graphique
$case = $Dompath->query("//*[@id='".$grad_id."_".$champs."']")->item(0);
if($case != null) {
$case->setAttribute('fill','#EA6624');
$case->setAttribute('stroke','#EA6624');
$this->ajouterInfoAuSurvol($champs,$case);
}
$changement = true;
}
$this->ajusterFormatSVG();
}
public function ajouterValeursIntermediaires(){
$champs_ecolo = array_keys($this->champs_ontologiques);
foreach ($champs_ecolo as $chps ){
$min = !empty($this->valeurs_en_pourcentage[$chps.'_min']) ? $this->valeurs_en_pourcentage[$chps.'_min'] : -1;
$max = !empty($this->valeurs_en_pourcentage[$chps.'_max']) ? $this->valeurs_en_pourcentage[$chps.'_max'] : -1;
if ($min < ($max-0.1) ){
$i = $min + 0.1;
$num = 1;
for ($i ; $i < $max; $i += 0.1) {
$this->valeurs_en_pourcentage[$chps.'_'.$num] = $i;
$num++;
}
}
}
}
public function ajouterInfoAuSurvol($champs, $case){
$min = $this->valeurs_champs[$champs."_min"];
$max = $this->valeurs_champs[$champs."_max"];
if ($min != $max){
$valeurMin = $this->recupererOntologies($min, $champs );
$valeurMax = $this->recupererOntologies($max, $champs );
$valeurMin = $this->traiterIntermediaires($valeurMin->nom, $champs, $champs.'_min');
$valeurMax = $this->traiterIntermediaires($valeurMax->nom, $champs, $champs.'_max');
$case->setAttribute('title',"de $min: $valeurMin à $max: $valeurMax " );
} else {
$valeurMin = $this->recupererOntologies($min, $champs );
$valeurMin = $this->traiterIntermediaires($valeurMin->nom, $champs, $champs.'_min');
$case->setAttribute('title',"$min: $valeurMin" );
}
}
}
?>

/branches/v5.12-baouque/services/modules/0.1/baseflor/InformationsTaxonsSup.php
New file
0,0 → 1,274
<?php
/**
* Classe InformationsTaxonsSup.php permet de faire des requetes pour les rangs superieurs de baseflor
* du référentiel BDTFX et avec un numéro nomenclatural ( différent de 0 ).
* fin d'url possibles :
*
* /informations/#bdnt.nn:#num_nomen?champs=ecologie --> retourne champs ecologiques pour un BDNT et un num_nomen
*
*
* Encodage en entrée : utf8
* Encodage en sortie : utf8
* @package eflore-projets
* @author Mathilde SALTHUN-LASSALLE <mathilde@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)
*/
class InformationsTaxonsSup extends Commun{
protected $table = "";
private $champs_ontologiques = array();
private $format_reponse = 'informations';
protected $serviceNom = 'informations';
private $retour_format = 'max';
private $Bdd;
private $requete_condition = "";
private $champs_recherches = '*';
public function consulter($ressources, $parametres) {
$this->ressources = $ressources;
$this->parametres = $parametres;
$this->traiterParametres();
$this->definirTables();
$this->traiterRessources();
$resultats = '';
foreach ($this->table_version as $version) {
$this->table = $version;
$requete = $this->assemblerLaRequete();
$resultat = $this->Bdd->recupererTous($requete);
$versionResultat = $this->analyserResultat($resultat);
if (count($this->table_version) > 1) {
$resultats[$version] = $versionResultat;
} else {
$resultats = $versionResultat;
}
}
return $resultats;
}
public function analyserResultat($resultat) {
$versionResultat = null;
if ($resultat == '') {
$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);
}
return $versionResultat;
}
public function __construct(Conteneur $Conteneur) {
$this->Bdd = $Conteneur->getBdd();
}
//+--------------------------traitement ressources ou paramètres -------------------------------------------+
public function traiterRessources() {
if(preg_match('/^(.+)\.nn:([0-9]+)$/', $this->ressources[0], $retour)==1){
switch ($retour[1]) {
case 'bdtfx' :
$this->requete_condition[] = "num_nomen = ".$retour[2]." AND bdnt = 'bdtfx' ";
break;
default :
$e = 'Erreur dans l\'url de votre requête : </br> Le référentiel " '
.$retour[1].' " n\'existe pas.';
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
break;
}
}
}
//+---- paramètres ----+
public function traiterParametres() {
if (isset($this->parametres) && !empty($this->parametres) ) {
foreach ($this->parametres as $param => $valeur) {
switch ($param) {
case 'categorie' :
if ($valeur == "ecologie"){
$this->champs_recherches = ' num_nomen, bdnt, ve_lumiere_min , ve_lumiere_max,'
.' ve_temperature_min, ve_temperature_max, ve_continentalite_min,'
.' ve_continentalite_max, ve_humidite_atmos_min, ve_humidite_atmos_max,'
.' ve_humidite_edaph_min, ve_humidite_edaph_max, ve_reaction_sol_min,'
.' ve_reaction_sol_max, ve_nutriments_sol_min, ve_nutriments_sol_max,'
.' ve_salinite_min, ve_salinite_max, ve_texture_sol_min,ve_texture_sol_max,'
.' ve_mat_org_sol_min, ve_mat_org_sol_max ';
} else {
$e = "Valeur de paramètre inconnue pour 'categorie'. Ce paramètre n'est pas autorisé pour informations/#id";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
break;
case 'retour.format' :
if ($valeur == 'min' || $valeur == 'max') {
$this->retour_format = $valeur;
break;
} else {
$e = "Valeur de paramètre inconnue pour 'retour.format'. Ce paramètre n'est pas autorisé pour informations/#id";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
case 'navigation.depart' :
$this->definirNavigationDepart($valeur);
break;
case 'navigation.limite' :
$this->definirNavigationLimite($valeur);
break;
case 'version.projet' :
$this->traiterVersion($valeur);
break;
default :
$e = 'Erreur dans les parametres de votre requête : </br> Le paramètre " '
.$param.' " n\'existe pas.';
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE); break;
}
}
}
}
//+++------------------------------traitement des versions----------------------------------------++
public function traiterVersion($valeur) {
if (preg_match('/^[0-9]+(?:[._][0-9]+)*$/', $valeur) || $valeur == '*' || $valeur == '+') {
$this->version_projet = $valeur;
} else {
$e = "Erreur : La version est inconnue.";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
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);
}
}
public function definirTables() {
$table_num_version = $this->recupererVersionDisponible();
$prefixe_table = config::get('bdd_table_rang_sup');
if ( in_array($this->version_projet,$table_num_version) ) {
$this->table_version[] = $prefixe_table.'_v'.$this->version_projet;
} elseif ($this->version_projet == '+') {
$derniere_version = $table_num_version[count($table_num_version) - 1];
$this->table_version[] = $prefixe_table.'_v'.str_replace('.', '_', $derniere_version);
} elseif ($this->version_projet == '*') {
foreach ($table_num_version as $num_version) {
$this->table_version[] = $prefixe_table.'_v'.str_replace('.', '_', $num_version);
}
} else {
$e = "Erreur : La version est inconnue.";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
//+--------------------------formatages de resultats -------------------------------------------+
public function retournerResultatFormate($resultat) {
$this->resultat_json = $resultat[0];
if ($this->retour_format == 'max') {
$graphique_presence = $this->traiterEcologie() ;
if ($graphique_presence) {
$this->ajouterLiensGraphique($graphique_presence);
}
}
return $this->resultat_json ;
}
public function traiterEcologie() {
$donnees_presence = false;
$this->champs_ontologiques = Commun::s_recupererTableauConfig('Paramètres.champs_ontologiques');
foreach ($this->champs_ontologiques as $cle => $valeur){
/* Les deux tests commentés ci-dessous étaient présents dans eflore-test (uniquement) jusqu'à juin 2013.
La valeur 0 pose question.
cf baseflor_v2012_12_31
cf services/modules/0.1/baseflor/CommunGraphiques.php traiterValeursEcologiques() */
if ($this->resultat_json[$cle.'_min'] != "") { // && $this->resultat_json[$cle.'_min'] != 0) {
$donnees_presence[$this->getNomGraphique($valeur)] = true;
$tab_ontologie = $this->recupererOntologies($this->resultat_json[$cle.'_min'], $cle.'_min');
unset($this->resultat_json[$cle.'_min']);
}
if ($this->resultat_json[$cle.'_max'] != "") { // && $this->resultat_json[$cle.'_max'] != 0) {
$this->recupererOntologies($this->resultat_json[$cle.'_max'], $cle.'_max');
unset($this->resultat_json[$cle.'_max']);
}
}
return $donnees_presence;
}
//donne le nom du graphique correspondant à un champ écologique
public function getNomGraphique($code_ecolo) {
$graphique = null;
if (in_array($code_ecolo, explode(',',Config::get('Paramètres.climat')))) {
$graphique = 'climat';
} elseif (in_array($code_ecolo, explode(',', Config::get('Paramètres.sol')) )) {
$graphique = 'sol';
}
return $graphique;
}
public function ajouterLiensGraphique($graphique_presence) {
if ($graphique_presence['climat']) {
$this->resultat_json['graphique_climat']['libelle'] = 'climat';
$this->resultat_json['graphique_climat']['href'] = $this->ajouterHref('graphiques/climat',
strtolower($this->resultat_json['bdnt']).'.nn:'.$this->resultat_json['num_nomen']);
}
if ($graphique_presence['sol']) {
$this->resultat_json['graphique_sol']['libelle'] = 'sol';
$this->resultat_json['graphique_sol']['href'] = $this->ajouterHref('graphiques/sol',
strtolower($this->resultat_json['bdnt']).'.nn:'.$this->resultat_json['num_nomen']);
}
}
//+--------------------------traitement ontologies -------------------------------------------+
public function recupererOntologies($valeur, $champs){
$chps_sans = preg_replace("/_min|_max/", '', $champs);
$url = Config::get('url_service_base').Config::get('nom_projet').
'/ontologies/'.$this->champs_ontologiques[$chps_sans].':'.urlencode(urlencode($valeur));
try {
$val = $this->getBdd()->recuperer(sprintf(
"SELECT a.nom FROM baseflor_ontologies a LEFT JOIN baseflor_ontologies b ON a.id = b.id LEFT JOIN baseflor_ontologies c ON b.classe_id = c.id WHERE".
" b.code = BINARY '%s' AND c.code = BINARY '%s' LIMIT 0, 100",
$valeur,
$this->champs_ontologiques[$chps_sans]),
Bdd::MODE_OBJET);
$this->resultat_json[$champs.'.libelle'] = $val->nom;
$this->resultat_json[$champs.'.code'] = $valeur;
$this->resultat_json[$champs.'.href'] = $url;
} catch (Exception $e) {
$this->resultat_json[$champs.'.libelle'] = '';
$this->resultat_json[$champs.'.code'] = '';
$this->resultat_json[$champs.'.href'] = '';
}
}
//+--------------------------FONCTIONS D'ASSEMBLAGE DE LA REQUETE-------------------------------------------+
public function assemblerLaRequete() {
$requete = ' SELECT '.$this->champs_recherches.' FROM '.$this->table.' '
.$this->retournerRequeteCondition();
return $requete;
}
public function retournerRequeteCondition() {
$condition = '';
if (empty($this->requete_condition) == false) {
$condition = ' WHERE '.implode(' AND ', $this->requete_condition);
}
return $condition;
}
}
?>