Subversion Repositories eFlore/Projets.eflore-projets

Rev

Details | Last modification | View Log | RSS feed

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