Subversion Repositories eFlore/Projets.eflore-projets

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
3 jpm 1
<?php
2
// declare(encoding='UTF-8');
3
/**
4
* Classe permettant de fournir des informations sur les noms scientifiques.
5
* Si l'url finit par /noms on retourne une liste de noms latin et leurs identifiants (seulement les 100 premeiers noms par défaut).
6
* L'url peut contenir des paramètres optionnels passés après le ? : /noms?param1=val1&param2=val2&...
655 jpm 7
*
3 jpm 8
* 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),
655 jpm 9
* 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),
3 jpm 10
* masque.nn (identifiant du nom), recherche, rang, distinct, retour.format, nl.format, nl.structure, navigation.depart et navigation.limite.
655 jpm 11
* Les différentes requetes :
3 jpm 12
*   - noms | noms/relations/#projet/#id_projet | noms/#id | noms/#id/#champ+#champ
13
*   - noms/#id/relations | noms/#id/relations/synonymie | noms/#id/relations/homonymie | noms/#id/relations/flores
14
*   - noms/stats/rangs | noms/stats/annees | noms/stats/initiales
655 jpm 15
*
3 jpm 16
* @package bdtfx
17
* @author Jennifer Dhé <jennifer.dhe@tela-botanica.org>
18
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
19
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
20
* @version $Id$
21
* @copyright 1999-2011 Tela Botanica (accueil@tela-botanica.org)
22
* @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=EfloreApi01Noms
23
*/
24
 
25
class Noms extends CommunNomsTaxons {
655 jpm 26
 
3 jpm 27
	protected $format_reponse	 = 'noms'; // Permet de stocker la requete formulée
536 gduche 28
	protected $service 			 = 'noms';
655 jpm 29
	protected $serviceNom		 = 'noms';
3 jpm 30
	protected $requete_champ 	 = 'num_nom, nom_sci, num_nom_retenu';
655 jpm 31
	protected $requete_condition = null;
3 jpm 32
	protected $requete_group_by  = '';
33
	/** Permet de stocker les limite de la requete SQL (par défaut seul les 100 premiers résultats seront retournés).*/
655 jpm 34
	protected $limite_requete 	 = array('depart' => 0, 'limite' => 100);
536 gduche 35
	protected $distinct		 	 = null; // Valeur du paramètre de requete distinct (=0|1)
36
 
3 jpm 37
	public function consulter($ressources, $parametres) {
38
		return parent::consulter($ressources, $parametres);
39
	}
655 jpm 40
 
3 jpm 41
//+----------------FONCTION D'ANALYSE DES PARAMETRES---------------------------------------------------------+
655 jpm 42
 
3 jpm 43
	public function traiterParametresSpecifiques() {
44
		foreach ($this->parametres as $param => $val) {
45
			switch ($param) {
46
				case 'masque' :
1130 aurelien 47
					$champ = isset($this->parametres['recherche']) && ($this->parametres['recherche'] == 'etendue') ?
48
							'CONCAT(nom_sci," ",auteur)' : 'nom_sci';
49
					$this->ajouterFiltreMasque($champ, $val);
3 jpm 50
					break;
51
				case 'masque.sg' :
655 jpm 52
					$this->ajouterFiltreMasque('nom_supra_generique', $val);
3 jpm 53
					break;
655 jpm 54
				case 'masque.gen' :
55
					$this->ajouterFiltreMasque('genre', $val);
3 jpm 56
					break;
655 jpm 57
				case 'masque.sp' :
58
					$this->ajouterFiltreMasque('epithete_sp', $val);
59
					break;
60
				case 'masque.ssp' :
61
					$this->ajouterFiltreMasque('epithete_infra_sp',$val);
62
					break;
63
				case 'masque.au' :
64
					$this->ajouterFiltreMasque('auteur', $val);
65
					break;
66
				case 'masque.an' :
67
					$this->ajouterFiltreMasque('annee', $val);
68
					break;
69
				case 'masque.bib' :
70
					$this->ajouterFiltreMasque('biblio_origine',$val);
71
					break;
72
				case 'masque.ad' :
73
					$this->ajouterFiltreMasque('nom_addendum', $val);
74
					break;
75
				case 'masque.nn' :
76
					$this->requete_condition []= 'num_nom IN ('.$val.')';
77
					$this->masque['num_nom'] = "num_nom=$val";
78
					break;
79
				case 'masque.nt' :
80
					$this->requete_condition []= 'num_taxonomique IN ('.$val.')';
81
					$this->masque['num_tax'] = "num_taxonomique=$val";
82
					break;
83
				case 'masque.rg' :
84
					$this->ajouterFiltreMasque('rang', $val);
85
					break;
86
				case 'retour.champs' :
87
					$this->verifierParamChamps($param, $val);
88
					break;
89
				case 'distinct' :
90
					$this->ajouterNomDistinct($val);
91
					break;
92
				case 'masque.fam' :
93
					$this->ajouterFiltreMasque('famille', $val);
94
					break;
95
				case 'masque.prga' :
96
					$this->ajouterFiltreMasque('presence_ga', $val);
97
					break;
98
				case 'masque.prco' :
99
					$this->ajouterFiltreMasque('presence_co', $val);
100
					break;
101
				case 'masque.sto' :
102
					$this->ajouterFiltreMasque('statut_origine', $val);
103
					break;
104
				case 'masque.sti' :
105
					$this->ajouterFiltreMasque('statut_introduction', $val);
106
					break;
107
				case 'masque.stc' :
108
					$this->ajouterFiltreMasque('statut_culture', $val);
109
					break;
110
				case 'masque.and' :
111
					$this->requete_condition []= " annee >= ".$this->getBdd()->proteger($val);
112
					break;
113
				case 'masque.anf' :
114
					$this->requete_condition []= " annee <= ".$this->getBdd()->proteger($val);
115
					break;
3 jpm 116
			}
655 jpm 117
 
3 jpm 118
		}
119
	}
655 jpm 120
 
3 jpm 121
	public function verifierParamChamps($param, $val) {
122
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
123
		$champs_demandes = explode(',', $val);
124
		$champs_verifies = array();
655 jpm 125
		$champs_api = array_flip($this->champs_api);
363 delphine 126
		$champs_supp = array('nom_retenu_complet'=>'num_nom_retenu', 'basionyme_complet'=>'basionyme');
127
		$champs_api = array_merge($champs_api, $champs_supp);
3 jpm 128
		foreach ($champs_demandes as $champ) {
129
			if (array_key_exists($champ, $champs_api)) {
130
				$champs_verifies[] = $champs_api[$champ];
131
			}
132
		}
133
		if (count($champs_verifies) > 0) {
134
			$this->requete_champ .= ', '.implode(',', $champs_verifies);
135
		}
655 jpm 136
	}
137
 
3 jpm 138
	/** Permet de rajouter à la requete sql le parametre distinct. N'est utilisé qu'avec le format oss */
567 mathilde 139
	public function ajouterNomDistinct($distinct) {
140
		if (isset($distinct)) {
141
			if ($distinct == 1 && $this->parametres['retour.format'] == 'oss') {
142
				$this->distinct = ' distinct ';
143
			} elseif ($distinct == 1 && $this->parametres['retour.format'] != 'oss') {
655 jpm 144
				$e = 'Erreur dans votre requête </br> L\'utilisation du paramètre distinct ne se fait que sous
3 jpm 145
					le format oss';
146
				$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
147
			}
148
		}
149
	}
655 jpm 150
 
3 jpm 151
//-----------------FONCTION D'ANALYSE DES RESSOURCES--------------------------------------------------------------------
152
 
153
	public function traiterRessourcesIdentifiant() {
154
		//on initialise la condition de la requete sql et le format de réponse
155
		$this->requete_condition = array(); //on vide la table dans le cas de plusieurs version
156
		$this->requete_condition[] = 'num_nom = '.$this->getBdd()->proteger($this->ressources[0]);
157
		$this->format_reponse = $this->service.'/id';
655 jpm 158
		if (isset($this->ressources[1]) && !empty($this->ressources[1])) {
159
			if ($this->ressources[1] == 'relations') {
3 jpm 160
				$this->traiterRessourceIdRelations();
161
			} else {
162
				$e = 'Erreur dans votre requête </br> Ressources disponibles : <br/>
163
					 <li> noms/#id/relations </li> <li> noms/#id/#champ+#champ </li>
164
					 <li> noms/#id/relations/synonymie </li> <li> noms/#id/relations/flores </li>
165
					 <li> noms/#id/relations/homonymie </li>';
166
				$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
167
			}
168
		} else { // requete de type noms/#id : rajout du nom_sci pour récupérer le format html par la fct mettreAuFormat()
169
			$this->requete_champ = ' *, nom_sci ';
170
		}
171
	}
655 jpm 172
 
3 jpm 173
	public function traiterRessourceRelations() {
174
		$this->format_reponse .= '/relations';
175
		$projet = $this->ressources[1];
176
		$num_nom = $this->ressources[2];
177
		if (strrpos($num_nom, 'nn.coste') !== false) {
178
			list($p, $nn) = explode('=', $num_nom);
179
			$num_nom = $nn;
655 jpm 180
		}
3 jpm 181
		$champ = "flore_$projet"."_num";
182
		if (isset($this->ressources[3])) {
183
			$type = $this->ressources[3];
184
			if (!in_array($type, array('homonymie', 'synonymie', 'flores'))) {
185
				$e = "Les types disponibles pour les noms sont homonymie, synonymie et flores";
186
				$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
187
			}
655 jpm 188
		}
3 jpm 189
		$this->requete_champ = ' num_nom ';
190
		$this->requete_condition = array();
191
		$this->requete_condition[] = "$champ = ".$this->getBdd()->proteger($num_nom);
192
	}
655 jpm 193
 
3 jpm 194
	public function traiterRessourceIdRelations() {
195
		$this->format_reponse .= '/relations';
196
		if (isset($this->ressources[2]) && !empty($this->ressources[2])) {
197
			// requete de type noms/#id/relations/#relation
198
			switch ($this->ressources[2]) {
655 jpm 199
				case 'synonymie' :
3 jpm 200
					$this->traiterRessourceIdSynonymie();
201
					break;
202
				case 'flores' :
203
					$this->traiterRessourceIdFlores();
655 jpm 204
					break;
3 jpm 205
				case 'homonymie' :
206
					$this->traiterRessourceIdHomonymie();
207
					break;
655 jpm 208
				default :
3 jpm 209
					$e = 'Erreur dans votre requête </br> Ressources disponibles : <br/>
655 jpm 210
					 <li> noms/#id/relations </li>  <li> noms/#id/relations/synonymie </li>
3 jpm 211
					 <li> noms/#id/relations/flores </li> <li> noms/#id/relations/homonymie </li>';
655 jpm 212
					$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
3 jpm 213
					break;
214
			}
655 jpm 215
		}
3 jpm 216
	}
655 jpm 217
 
3 jpm 218
	public function traiterRessourceIdSynonymie() {
219
		// SELECT num_nom, nom_sci, num_nom_retenu, basionyme FROM bdtfx_v2_00 WHERE num_nom = X LIMIT 0,100;
220
		$this->format_reponse .= '/synonymie';
221
		if (strrpos($this->requete_champ, ', basionyme') === false) {
222
			$this->requete_champ .= ', basionyme ';
223
		}
1040 aurelien 224
		if (strrpos($this->requete_champ, ', num_type') === false) {
225
			$this->requete_champ .= ', num_type ';
226
		}
3 jpm 227
		$this->requete_condition[0] = 'num_nom_retenu = '.
228
			'(SELECT num_nom_retenu FROM '.$this->table.' WHERE '.$this->requete_condition[0].')';
229
	}
655 jpm 230
 
3 jpm 231
	public function traiterRessourceIdHomonymie() {
232
		// 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);
233
		$this->format_reponse 	 .=  '/homonymie';
234
		$this->requete_condition[0] =  'nom_sci = (SELECT nom_sci FROM '.$this->table
235
									.' WHERE '.$this->requete_condition[0].')';
236
	}
655 jpm 237
 
3 jpm 238
	public function traiterRessourceIdFlores() {
239
		$champ_flores = '';
240
		foreach ($this->champs_table as $champ) {
241
			if (preg_match('/^flore_.*$/', $champ)) {
242
				$champ_flores .= ', '.$champ;
243
			}
244
		}
245
		$this->format_reponse .=  '/flores';
246
		$this->requete_champ   = 'num_nom'.$champ_flores;
247
	}
655 jpm 248
 
3 jpm 249
	public function traiterRessourceStatsRangs() {
250
		// SELECT count(*) as nombre, rang FROM bdtfx_v2_00 [WHERE rang = 290] GROUP BY rang ORDER BY rang;
251
		$this->format_reponse   .= '/rangs';
655 jpm 252
		$this->requete_champ 	 = 'count(*) as nombre, rang ';
3 jpm 253
		$this->requete_group_by  = ' GROUP BY rang ORDER BY rang ';
254
	}
655 jpm 255
 
3 jpm 256
	public function traiterRessourceStatsAnnees() {
257
		// SELECT count(*) as nombre, annee FROM bdtfx_v2_00 GROUP BY annee ORDER BY annee;
258
		$this->format_reponse   .= '/annees';
259
		$this->requete_champ   	 = 'count(*) as nombre, annee ';
260
		$this->requete_condition = null;
655 jpm 261
		$this->requete_group_by  = ' GROUP BY annee ORDER BY annee ';
3 jpm 262
	}
655 jpm 263
 
3 jpm 264
	public function traiterRessourceStatsInitiales() {
265
		// SELECT count(left( nom_sci, 2 )) as nb, rang, left(nom_sci, 2) as lettre GROUP BY rang, left(nom_sci, 2);
266
		$this->format_reponse .= '/initiales';
655 jpm 267
		$this->requete_champ   = 'count(left( nom_sci, 2 )) as nb, rang, left(nom_sci, 2) as lettre ';
3 jpm 268
		$this->requete_group_by  = ' GROUP BY rang, left(nom_sci, 2)';
269
	}
655 jpm 270
 
271
 
272
 
3 jpm 273
//-----------------------------FONCTIONS DASSEMBLAGE DE LA REQUETE-----------------------------------------------------
655 jpm 274
 
3 jpm 275
	public function assemblerLaRequete() {
276
		if ( strrpos($this->format_reponse, 'noms/stats/') === false ) {
277
			$this->mettreAuFormat(); //Ds CommunNomsTaxons.php
278
		}
660 jpm 279
		$requete = 'SELECT '.$this->retournerChamps().' '.
280
			"FROM {$this->table} ".
281
			$this->retournerRequeteCondition().' '.
282
			$this->requete_group_by.' '.
283
			$this->retournerOrderBy().' '.
740 raphael 284
			$this->formerRequeteLimite() .
285
			' -- ' . __FILE__ . ':' . __LINE__ ;
655 jpm 286
		return $requete;
660 jpm 287
	}
655 jpm 288
 
660 jpm 289
	public function retournerChamps() {
290
		$sql = '';
291
		if ($this->distinct) {
292
			$sql .= $this->distinct.' ';
293
		}
294
		if ($this->requete_champ) {
295
			$sql .= $this->requete_champ.' ';
296
		}
297
 
298
		// Champs "virtuels" pour tier sur l'ensemble des résultats
299
		if (isset($this->parametres['retour.tri'])) {
300
			list($champ, $ordre) = $this->decouperParametreRetourTri();
301
			if ($champ == 'retenu') {
302
				$sql .= ", IF(num_nom = num_nom_retenu, '0', '1') AS nom_retenu_tri ";
303
			}
304
		}
305
 
306
		return $sql;
3 jpm 307
	}
308
 
660 jpm 309
	public function decouperParametreRetourTri() {
310
		$tri = array('', '');
311
		if (isset($this->parametres['retour.tri'])) {
312
			if (preg_match('/^(retenu)(?:,(ASC|DESC)|)$/', $this->parametres['retour.tri'], $match))
313
			$tri[0] = $match[1];
314
			$tri[1] = isset($match[2]) ? $match[2] : '';
315
		}
316
		return $tri;
317
	}
318
 
319
	public function retournerRequeteCondition() {
320
		$condition = '';
321
		if ($this->requete_condition) {
322
			$condition = ' WHERE '.implode(' AND ', $this->requete_condition);
323
		}
324
		return $condition;
325
	}
326
 
327
	public function retournerOrderBy() {
328
		$orderBy = array();
329
 
330
		// Tri sur l'ensemble des résultats
331
		if (isset($this->parametres['retour.tri'])) {
332
			list($champ, $ordre) = $this->decouperParametreRetourTri();
333
			if ($champ == 'retenu') {
334
				$orderBy[] = "nom_retenu_tri $ordre";
335
			}
336
		}
337
		// Tri par défaut
338
		if ($this->format_reponse == 'noms') {
339
			$orderBy[] = 'nom_sci ASC';
340
		}
341
 
342
		$sql = '';
672 jpm 343
		if (count($orderBy) > 0) {
660 jpm 344
			$sql = 'ORDER BY '.implode(', ', $orderBy).' ';
345
		}
346
		return $sql;
347
	}
348
 
3 jpm 349
	public function formerRequeteLimite() {
655 jpm 350
		if ($this->format_reponse != 'noms' && $this->format_reponse != 'noms/id/relations/synonymie'
660 jpm 351
				&& $this->format_reponse != 'noms/id/relations/homonymie') {
655 jpm 352
			$this->requete_limite = '';
3 jpm 353
		} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) {
655 jpm 354
			$this->limite_requete['depart'] =
660 jpm 355
			(($this->total_resultat - $this->limite_requete['limite']) < 0) ? 0 : ($this->total_resultat - $this->limite_requete['limite']);
655 jpm 356
			$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
3 jpm 357
		} else {
655 jpm 358
			$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
3 jpm 359
		}
360
		return $this->requete_limite;
361
	}
655 jpm 362
 
3 jpm 363
	/** Recupere le nombre total de résultat d'une requete lancée. */
364
	public function recupererTotalResultat() {
365
		$total = null;
366
		$requete = 'SELECT count(*) as nombre FROM '.$this->table.$this->retournerRequeteCondition().$this->requete_group_by;
367
		$res = $this->getBdd()->recuperer($requete);
368
		if ($res) {
369
			$total = $res['nombre'];
370
		} else {
371
			$e = 'Fct recupererTotalResultat() : <br/>Données introuvables dans la base';
372
			$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e);
373
		}
374
		return $total;
375
	}
655 jpm 376
 
377
 
3 jpm 378
//-------------------FONCTIONS POUR LE FORMATAGE EN JSON----------------------------------------------------------------
655 jpm 379
 
272 delphine 380
	public function retournerResultatFormate($resultat) {
740 raphael 381
 
3 jpm 382
		switch ($this->format_reponse) {
383
			case 'noms/relations' :
384
				$reponse = $this->formaterRelations($resultat[0]);
385
				break;
386
			case 'noms/id' : //ds CommunNomsTaxons
387
				$reponse = $this->formaterId($resultat[0]);
388
				break;
389
			case 'noms/id/relations' :
390
				$reponse = $this->formaterIdRelations($resultat[0]);
655 jpm 391
				break;
3 jpm 392
			case 'noms/id/relations/synonymie' :
393
				$reponse = $this->formaterIdSynonymie($resultat);
394
				break;
395
			case 'noms/id/relations/homonymie' :
396
				$reponse = $this->formaterIdHomonymie($resultat);
397
				break;
398
			case 'noms/id/relations/flores' : //ds CommunsNomsTaxons
399
				$reponse = $this->formaterIdFlores($resultat[0]);
400
				break;
401
			case 'noms/stats/annees' : //ds CommunNomsTaxons
402
				$reponse = $this->formaterStatsAnnee($resultat);
403
				break;
404
			case 'noms/stats/rangs' : //ds CommunNomsTaxons
405
				$reponse = $this->formaterStatsRang($resultat);
406
				break;
407
			case 'noms/stats/initiales' : //ds CommunNomsTaxons
408
				$reponse = $this->formaterStatsInitiales($resultat);
409
				break;
410
			case 'noms' :
411
				$reponse = $this->formaterNoms($resultat);
412
				break;
413
		}
414
		return $reponse;
415
	}
655 jpm 416
 
3 jpm 417
//+---------------------concerne les resultats pour des requetes de type noms/id-----------------------------+
655 jpm 418
 
3 jpm 419
	public function formaterRelations($resultat) {
420
		$num_nom = $resultat['num_nom'];
421
		if (isset($this->ressources[3])) {
422
			$url = Config::get('url_service').$this->service."/$num_nom/relations";
423
		} else {
424
			$type = $this->ressources[3];
425
			$url = Config::get('url_service')."/$this->service/$num_nom/relations/$type";
426
		}
427
		$res = $this->consulterHref($url);
428
		return $res;
655 jpm 429
	}
430
 
3 jpm 431
	public function formaterIdRelations($resultat) {
432
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
655 jpm 433
		$this->resultat_req = $resultat;
3 jpm 434
		$retour_id_rel = array ('entete' => array()); //on initialise pr que l'entete apparaisse en premier lors de l'affichage
655 jpm 435
 
3 jpm 436
		//on recupère le resultat de chaque relation (appel du WS correspondant)
272 delphine 437
		$flores = $this->ajouterRelations('flores');
3 jpm 438
		if (isset($flores)) $retour_id_rel['resultat']['flores'] = $flores;
272 delphine 439
		$homonymes = $this->ajouterRelations('homonymie');
3 jpm 440
		if (isset($homonymes)) $retour_id_rel['resultat']['homonymes'] = $homonymes;
272 delphine 441
		$synonymes = $this->ajouterRelations('synonymie');
3 jpm 442
		if (isset($synonymes)) $retour_id_rel['resultat']['synonymes'] = $synonymes;
655 jpm 443
 
3 jpm 444
		//on renvoit null si il n'existe aucune relations (on efface l'entete en premier lieu)
445
		if (!isset($retour_id_rel['resultat']))	{
655 jpm 446
			$retour_id_rel = null;
3 jpm 447
		} else { //on rajoute l'entete si des relations existent
655 jpm 448
			$this->afficherDonnees('num_nom', $this->ressources[0]);
3 jpm 449
			$retour_id_rel['entete'] = $this->table_retour;
450
			$this->table_retour = array();
451
		}
452
		return $retour_id_rel;
453
	}
655 jpm 454
 
3 jpm 455
	/**
655 jpm 456
	 * Recupere les relations (type de la relation passée en paramètres :[type_relation] = synonymie, homonymie ou
3 jpm 457
	 * flores) par l'appel du web service [version]/noms/#id/relations/[type_relation]
458
	 */
272 delphine 459
	public function ajouterRelations($relation) {
460
		$version = str_replace(Config::get('bdd_table').'_', '', $this->table);
3 jpm 461
		$res = null;
462
		$parametres_url = '';
463
		if ($this->parametres != array()) $parametres_url = '?'.http_build_query($this->parametres, '', '&');
272 delphine 464
		$url = Config::get('url_service').'/'.$this->service.'/'
3 jpm 465
									.$this->ressources[0].'/relations/'
272 delphine 466
									.$relation.$parametres_url;	Debug::printr($url);
655 jpm 467
 
3 jpm 468
		$relation = $this->consulterHref($url);
655 jpm 469
 
3 jpm 470
		$res = $relation->resultat;
471
		return $res;
472
	}
655 jpm 473
 
474
 
3 jpm 475
	public function formaterIdSynonymie($resultat) {
476
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
477
		$retour_id_syn = array();
963 raphael 478
		if ($resultat[0]['num_nom_retenu'] == '') return array('nom_retenu N.D.');
479
 
480
        // 1 ou + résultat(s)
481
        $retour_id_syn['entete'] = $this->afficherEnteteResultat('/'.$this->service.'/'.$this->ressources[0].'/relations/synonymie');
482
        $retour_id_syn['entete']['id'] = $this->ressources[0];
483
        $retour_id_syn['resultat'] = array();
484
 
485
        // résultat contient aussi l'original
486
        if(count($resultat) > 1) {
655 jpm 487
			//on remplit d'abord l'entete du resultat
3 jpm 488
			foreach ($resultat as $tab) {
489
				//pour chaque basionyme, on recupère le résultat : num_nom, nom_sci, basionyme et num_nom_retenu :
655 jpm 490
				$this->resultat_req = $tab;
3 jpm 491
				$num = $tab['num_nom'];
492
				$this->afficherNomHrefRetenu($tab, $num);
655 jpm 493
				$this->afficherDonnees('basionyme', $tab['basionyme']);
1040 aurelien 494
				$this->afficherDonnees('num_type', $tab['num_type']);
3 jpm 495
				$retour_id_syn['resultat'][$num] = $this->table_retour;
496
				$this->table_retour = array();
497
			}
498
			if (!isset($retour_id_syn['resultat']) && !in_array('nom_retenu N.D.', $retour_id_syn)) {
499
				$retour_id_syn = null; //on initialise le resultat à null
655 jpm 500
			}
3 jpm 501
		}
502
		return $retour_id_syn;
503
	}
655 jpm 504
 
3 jpm 505
	public function formaterIdHomonymie($resultat) {
506
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
272 delphine 507
		if (count($resultat) != 1) {
3 jpm 508
			$this->table_retour['id'] = $this->ressources[0];
509
			$this->afficherEnteteResultat($resultat, '/'.$this->service.'/'.$this->ressources[0].'/relations/homonymie');
510
			$retour_id_hom['entete'] = $this->table_retour;
511
			$this->table_retour = array();
512
			foreach ($resultat as $homonyme) {
513
				$this->resultat_req = $homonyme;
514
				$id = $homonyme['num_nom'];
515
				$this->afficherDonnees('num_nom', $id);
516
				if ($homonyme['num_nom_retenu'] != '') {
562 delphine 517
					$retenu = ($id == $homonyme['num_nom_retenu']) ? 'true' : 'false';
518
				} else {
519
					$retenu = 'absent';
520
				}
655 jpm 521
				$this->table_retour['retenu'] = $retenu;
3 jpm 522
				$retour_id_hom['resultat'][$id] = $this->table_retour;
523
				unset($retour_id_hom['resultat'][$id]['id']);
524
				$this->table_retour = array();
525
			}
533 gduche 526
		} else {
655 jpm 527
			$retour_id_hom = null;
3 jpm 528
		}
529
		return $retour_id_hom;
530
	}
655 jpm 531
 
357 delphine 532
	public function obtenirSynonymesParNumNomAvecInfosFlore($num_nom, $version='1_02') {
655 jpm 533
 
534
		$champs_flore = 'flore_bonnier_num, flore_bonnier_rem,'.
306 aurelien 535
						'flore_cnrs_num, flore_cnrs_rem '.
536
						'flore_fe_num, flore_fe_rem '.
655 jpm 537
						'flore_coste_num, flore_coste_rem '.
538
						'flore_fh_num, flore_fh_rem '.
306 aurelien 539
						'flore_fournier_num, flore_fournier_rem';
655 jpm 540
 
306 aurelien 541
		$requete = 'SELECT num_nom, nom_sci, '.$champs_flore.' '.
357 delphine 542
						'FROM '.$this->table.' '.
306 aurelien 543
						'WHERE num_nom_retenu = '.
544
						'('.
357 delphine 545
						'SELECT num_nom_retenu FROM '.$this->table.' WHERE num_nom = "'.$num_nom.'"'.
306 aurelien 546
						')';
655 jpm 547
 
740 raphael 548
		return $this->getBdd()->recupererTous($requete . ' -- ' . __FILE__ . ':' . __LINE__ );
306 aurelien 549
	}
655 jpm 550
 
3 jpm 551
	public function formaterIdFlores($resultat) {
552
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp,noms_projets');
655 jpm 553
		$this->resultat_req = $resultat;
3 jpm 554
		$id = array_shift($resultat);
555
		$reponse['entete']['id'] = $id;
306 aurelien 556
		$synonymes_flores = $this->obtenirSynonymesParNumNomAvecInfosFlore($this->ressources[0]);
557
		if(is_array($synonymes_flores)) {
558
			foreach ($synonymes_flores as $synonyme) {
559
				$nom_sci = $synonyme['nom_sci'];
560
				$num_nom = $synonyme['num_nom'];
561
				unset($synonyme['nom_sci']);
562
				unset($synonyme['num_nom']);
563
				foreach ($synonyme as $flores => $valeur) {
564
					if ($valeur != '' && $valeur != '0') {
565
						$this->afficherInfosFlore($synonyme, $flores, $valeur, $nom_sci, $num_nom);
566
					}
567
				}
3 jpm 568
			}
569
		}
306 aurelien 570
 
3 jpm 571
		if ($this->table_retour != array()) {
572
			$reponse['resultat'] = $this->table_retour;
573
			$this->table_retour = array();
655 jpm 574
		} else {
575
			$reponse = null;
3 jpm 576
		}
577
		return $reponse;
578
	}
655 jpm 579
 
306 aurelien 580
	public function getNomCompletFlore($flore) {
581
		return Config::get($flore.'_texte');
582
	}
655 jpm 583
 
306 aurelien 584
	public function afficherInfosFlore(&$resultat, $flores, $valeur, $nom_sci, $num_nom) {
655 jpm 585
		$flore = substr($flores,0,strrpos($flores, '_'));
3 jpm 586
		$projet = $this->noms_projets[$flore];
655 jpm 587
 
306 aurelien 588
		//TODO voir si l'on peut factoriser les affectations à la table retour
589
		// et simplifier ce gros pavé
655 jpm 590
		if (strrpos($flores, 'num') !== false) {
591
			if (preg_match('/^([0-9]+)(?:[.]syn[^a-z]*|(.*))?$/', $valeur, $match)) {
306 aurelien 592
				$this->table_retour[$num_nom][$flore]['id'] = $match[1];
3 jpm 593
				if ($projet == 'coste') {
306 aurelien 594
					$this->table_retour[$num_nom][$flore]['href'] = $this->ajouterHrefAutreProjet('noms', 'nn_coste:', $match[1], $projet);
3 jpm 595
				}
306 aurelien 596
				if (isset($match[2]) && $match[2] != '') $this->table_retour[$num_nom][$flore]['cle'] = $match[2];
597
				$this->table_retour[$num_nom][$flore]['nom_flore'] = $this->getNomCompletFlore($flore);
598
				$this->table_retour[$num_nom][$flore]['nom_sci'] = $nom_sci;
655 jpm 599
			}
3 jpm 600
			if (isset($resultat[$flore.'_rem']) && !empty($resultat[$flore.'_rem'])) {
306 aurelien 601
				$this->table_retour[$num_nom][$flore]['remarque'] = $resultat[$flore.'_rem'];
602
				$this->table_retour[$num_nom][$flore]['nom_flore'] = $this->getNomCompletFlore($flore);
603
				$this->table_retour[$num_nom][$flore]['nom_sci'] = $nom_sci;
3 jpm 604
				unset($resultat[$flore.'_rem']);
605
			}
606
		} elseif (strrpos($flores,'belge') !== false) {
607
			if (preg_match('/^([0-9]+) (R|S)?$/', $valeur, $match)) {
608
				if (isset($match[2])) $type = ($match[2] == 'R') ? 'taxons' : 'synonyme';
306 aurelien 609
				$this->table_retour[$num_nom][$flore]['page'] = $match[1];
610
				$this->table_retour[$num_nom][$flore]['type'] = $type;
611
				$this->table_retour[$num_nom][$flore]['nom_flore'] = $this->getNomCompletFlore($flore);
612
				$this->table_retour[$num_nom][$flore]['nom_sci'] = $nom_sci;
3 jpm 613
			}
614
		}
655 jpm 615
	}
616
 
3 jpm 617
//+---------------------concerne les resultats pour des requetes de type /noms avec ou sans paramètres-------+
618
 
566 aurelien 619
	public function formaterNoms($resultat) {
3 jpm 620
		if ($this->parametres['retour.format'] == 'oss') {
621
			$reponse = $this->formaterEnOss($resultat);	 //Ds CommunNomsTaxons.php
622
		} else {
623
			$reponse = $this->formaterEnJsonMax($resultat);
624
		}
625
		return $reponse;
626
	}
627
 
628
	public function formaterEnJsonMax($resultat) {
629
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
660 jpm 630
 
952 raphael 631
		// TODO : améliorer le tri des résultats
660 jpm 632
		// ATTENTION : ce comportement est étrange
3 jpm 633
		$masque = $this->recupererMasquePrincipal();
952 raphael 634
		if ($masque && isset($this->parametres[$masque[0]] /* à éclaircir */ ) && !isset($this->parametres['retour.tri'])) {
3 jpm 635
			$resultat = $this->trierRechercheFloue($this->parametres[$masque[0]], $resultat, $masque[1]);
636
		}
660 jpm 637
 
1067 mathias 638
		// Tri à la mode du CeL : lexicographique puis noms retenus (retour.tri = "alpharet")
639
		if (isset($this->parametres['retour.tri']) && ($this->parametres['retour.tri'] == "alpharet")) {
640
			usort($resultat, array($this, 'genrePuisNomsRetenusEnTete'));
641
		}
642
 
963 raphael 643
		$table_retour_json['entete'] = $this->afficherEnteteResultat('/'.$this->service);
655 jpm 644
		$table_retour_json['resultat'] = $this->remplirJsonResultat($resultat);
606 mathilde 645
		return $table_retour_json;
646
	}
647
 
1067 mathias 648
	// Trie les éléments du tableau de résultats : le genre en tête, puis les noms retenus, puis le reste
649
	// mais à partir du jeu de données retourné par SQL (indépendents du statut "retenu")
650
	private function genrePuisNomsRetenusEnTete($a, $b) {
651
		// On pourrait utiliser l'indice ['retenu'] mais il contient parfois "absent", qui est dur à traiter
652
		$aEstRetenu = ($a['num_nom'] == $a['num_nom_retenu']);
653
		$bEstRetenu = ($b['num_nom'] == $b['num_nom_retenu']);
654
		$retour = 0;
655
 
656
		// les noms retenus en premier ("inférieurs")
657
		if ($aEstRetenu) {
658
			if (! $bEstRetenu) {
659
				$retour = -1;
660
			}
661
		}  else {
662
			if ($bEstRetenu) {
663
				$retour = 1;
664
			}
665
		}
666
 
667
		// en cas d'égalité on conserve le tri lexicographique - devrait faire sortir le genre en première position
668
		// car il ne contient pas le nom d'auteur
669
		if ($retour == 0) {
670
			$retour = strcasecmp($a['nom_sci'], $b['nom_sci']);
671
		}
672
 
673
		return $retour;
674
	}
675
 
606 mathilde 676
	public function remplirJsonResultat($resultat) {
3 jpm 677
		$champs = null;
678
		if (array_key_exists('retour.champs', $this->parametres)) {
679
			$champs = explode(',', $this->parametres['retour.champs']);
680
		}
660 jpm 681
 
1113 mathias 682
		// Structure des données: objet ou liste ?
683
		$modeListe = false;
684
		if (array_key_exists('retour.structure', $this->parametres)) {
685
			$modeListe = ($this->parametres['retour.structure'] === "liste");
686
		}
687
 
655 jpm 688
		$noms = array();
3 jpm 689
		foreach ($resultat as $tab) {
690
			$this->table_retour = array();
691
			$num = $tab['num_nom'];
93 delphine 692
			$this->afficherNomHrefRetenu($tab, $num); // ajoute le nom_sci, href et si le nom est retenu dans $this->table_retour
693
			$retour = $this->table_retour;
694
			$this->table_retour = array();
695
			if ($champs != null) {
696
				$reponse_id = $this->formaterId($tab);
697
				$this->table_retour = array();
698
				$this->ajouterChampsPersonnalises($champs, $reponse_id);
699
				$retour = array_merge($retour, $this->table_retour);
700
			}
1113 mathias 701
			if ($modeListe) {
702
				$retour['num_nom'] = intval($num);
703
				$noms[] = $retour;
704
			} else {
705
				$noms[$num] = $retour;
706
			}
3 jpm 707
		}
655 jpm 708
 
660 jpm 709
		return  $noms;
3 jpm 710
	}
711
}
712
?>