Subversion Repositories eFlore/Projets.eflore-projets

Rev

Rev 963 | Rev 1007 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
3 jpm 1
<?php
2
// declare(encoding='UTF-8');
3
/**
4
* Description :
5
* Classe CommunNomsTaxons.php
6
* Encodage en entrée : utf8
7
* Encodage en sortie : utf8
8
* @package framework-v3
9
* @author Jennifer Dhé <jennifer.dhe@tela-botanica.org>
10
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
11
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
12
* @version 1.0
13
* @copyright 1999-2011 Tela Botanica (accueil@tela-botanica.org)
14
*/
15
 
104 delphine 16
 
3 jpm 17
abstract class CommunNomsTaxons extends Commun {
18
 
19
	/** Tableau de correspondance entre les noms des champs et les codes de l'ontologie.*/
20
	private $relationsChampsCodesOntologie = null;
21
	protected $table_retour; //Permet de stocker le tableau de résultat (non encodé en json)
22
	protected $resultat_req; // Permet de stocker le résultat de la requete principale.
23
	protected $compo_nom = null; //Stocke sous forme de tableau les composant du nom à ajouter au nom scientifique
24
	protected $table;// Nom de la table dans laquelle on récupèrera les données dans les requetes SQL
25
	protected $total_resultat = null;
26
	 /** Stocke le service appelé correspondant. Est utilisé principalement lors de l'affichage du href d'un synonyme
27
	  (ex id=12, basionyme num 25 est un synonyme) dans le service taxon */
28
	protected $service_href = null;
29
	protected $erreursParametres = null;
568 mathilde 30
	protected $sans_nom_sci = array('gen','sp','ssp','fam','au_ss','bib_ss');
31
	private $bib_traitees = array();
629 aurelien 32
	private $ontologie = array();
3 jpm 33
 
34
//+------------------------------- PARAMÈTRES ---------------------------------------------------------------+
35
 
36
	public function traiterParametres() {
37
		$this->definirParametresParDefaut();
38
		$this->verifierParametres();
39
 
40
		if (isset($this->parametres) && count($this->parametres) > 0) {
41
			foreach ($this->parametres as $param => $val) {
42
				switch ($param) {
43
					case 'ns.structure' :
44
						$this->remplirTableCompositionNom($val);
568 mathilde 45
						if (in_array($val,$this->sans_nom_sci)){
46
							$this->requete_champ = implode(', ',$this->compo_nom);
656 jpm 47
						}else {
568 mathilde 48
							$this->requete_champ .= ' ,'.implode(', ',$this->compo_nom);
49
						}
3 jpm 50
						break;
51
					case 'navigation.depart' :
52
							$this->limite_requete['depart'] = $val;
53
						break;
54
					case 'navigation.limite' :
55
							$this->limite_requete['limite'] = $val;
56
						break;
57
				}
58
			}
59
			$this->traiterParametresSpecifiques();
60
		}
61
	}
62
 
63
	protected function definirParametresParDefaut() {
64
		if (empty($this->parametres['recherche'])) {
65
			$this->parametres['recherche'] = 'stricte';
66
		}
67
		if (empty($this->parametres['ns.format'])) {
68
			$this->parametres['ns.format'] =  'txt';
69
		}
70
		if (empty($this->parametres['retour.format'])) {
71
			$this->parametres['retour.format'] = 'max';
72
		}
568 mathilde 73
		if (empty($this->parametres['ns.structure']) &&
74
			$this->parametres['retour.format'] != 'oss') {
326 delphine 75
			$this->parametres['ns.structure'] = 'au,an,bib';
76
		}
3 jpm 77
	}
656 jpm 78
 
79
 
3 jpm 80
	public function verifierParametres() {
629 aurelien 81
		//$this->verifierParametresAPI();
3 jpm 82
 
629 aurelien 83
		$this->verifierParametre('recherche', 'stricte|floue|etendue|complete');
3 jpm 84
		$this->verifierParametre('ns.format', 'htm|txt');
85
		$this->verifierParametre('retour.format', 'min|max|oss|perso');
568 mathilde 86
		$this->verifierParametreAvecValeurMultipe('ns.structure', 'an|au|bib|ad|gen|sp|ssp|fam|au_ss|bib_ss');
3 jpm 87
 
629 aurelien 88
		/*if (count($this->erreursParametres) > 0) {
3 jpm 89
			$m = 'Erreur dans votre requête : '.implode('<br/>', $this->erreursParametres);
90
			$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $m);
629 aurelien 91
		}*/
3 jpm 92
	}
93
 
94
	public function verifierParametresAPI() {
95
		$parametresApi = $this->recupererTableauConfig('parametresAPI');
96
		while (!is_null($parametre = key($this->parametres))) {
97
			if (!in_array($parametre, $parametresApi)) {
98
				$this->erreursParametres[] = "Le paramètre '$parametre' n'est pas pris en compte par cette version de l'API.";
99
			}
100
			next($this->parametres);
101
		}
102
	}
103
 
104
	public function verifierParametre($parametre, $valeursPermises) {
105
		if (isset($this->parametres[$parametre]) && !empty($this->parametres[$parametre])) {
106
			$valeur = $this->parametres[$parametre];
107
			$this->verifierValeursPermises($parametre, $valeur, $valeursPermises);
108
		}
109
	}
110
 
111
	public function verifierParametreAvecValeurMultipe($parametre, $valeursPermises) {
112
		if (isset($this->parametres[$parametre]) && !empty($this->parametres[$parametre])) {
113
			$valeursConcatenees = $this->parametres[$parametre];
114
			$valeurs = explode(',', $valeursConcatenees);
115
			foreach ($valeurs as $valeur) {
116
				$this->verifierValeursPermises($parametre, $valeur, $valeursPermises);
117
			}
118
		}
119
	}
120
 
121
	private function verifierValeursPermises($parametre, $valeur, $valeursPermises) {
122
		if (!in_array($valeur, explode('|', $valeursPermises))) {
123
			$this->erreursParametres[] = "Le paramètre '$parametre' ne peut pas prendre la valeur '$valeur'. Valeurs permises : $valeursPermises";
124
		}
125
	}
126
 
127
	public function traiterParametresCommuns() {
128
 
129
	}
130
 
131
	public function ajouterFiltreMasque($nom_champ, $valeur) {
926 raphael 132
		$orig_val = $valeur;
568 mathilde 133
		$valeur = explode(',',$valeur);
134
		$conditions = array();
3 jpm 135
		if ($nom_champ == 'annee' || $nom_champ == 'rang') {
568 mathilde 136
			foreach ($valeur as $val) {
137
				 $conditions[] = "$nom_champ = ".$this->getBdd()->proteger($val);
138
			}
3 jpm 139
		} else {
140
			if ($this->parametres['recherche'] == 'etendue') {
568 mathilde 141
				foreach ($valeur as $val) {
142
					$val = $this->modifierValeur($val);
143
					$conditions[] = "$nom_champ LIKE ".$this->getBdd()->proteger($val);
144
				}
656 jpm 145
 
3 jpm 146
			} elseif ($this->parametres['recherche'] == 'floue') {
568 mathilde 147
				foreach ($valeur as $val) {
148
					$val = $this->getBdd()->proteger($val);
149
					$conditions[] = "( SOUNDEX($nom_champ) = SOUNDEX($val))".
150
											" OR ( SOUNDEX(REVERSE($nom_champ)) = SOUNDEX(REVERSE($val)))";
151
				}
926 raphael 152
				// utile pour la détermination à partir d'un nom retenu (concat(nom_sci,auteur)) lors
153
				// d'un import depuis le CEL
154
			} elseif ($this->parametres['recherche'] == 'concat' && $nom_champ == 'nom_sci') {
155
				$conditions[] = "CONCAT(nom_sci, ' ', auteur) = " . $this->getBdd()->proteger($orig_val);
156
 
3 jpm 157
			} else {
568 mathilde 158
				foreach ($valeur as $val) {
159
					$conditions[] = "$nom_champ LIKE ".$this->getBdd()->proteger($val);
160
				}
3 jpm 161
			}
162
		}
568 mathilde 163
		$this->requete_condition[]= '('.implode(' OR ', $conditions ).')';
607 mathilde 164
		$this->masque[$nom_champ] = $nom_champ.'='.implode(',',$valeur);
3 jpm 165
	}
166
 
167
	private function modifierValeur($valeur) {
168
		$valeur = $this->remplacerCaractereHybrideEtChimere($valeur);
169
		$valeur = $this->preparerChainePourRechercheEtendue($valeur);
170
		return $valeur;
171
	}
172
 
173
	private function remplacerCaractereHybrideEtChimere($valeur) {
174
		$caracteres = array('×', '%D7', '+', '%2B');
175
		$remplacements = array('x ','x ', '+', '+');
176
		$valeur = str_replace($caracteres, $remplacements, $valeur);
177
		return $valeur;
178
	}
179
 
180
	private function preparerChainePourRechercheEtendue($valeur) {
136 aurelien 181
		$valeur = str_replace(' ', '% ', trim($valeur));
3 jpm 182
		$valeur = $valeur.'%';
183
		return $valeur;
184
	}
185
 
91 jpm 186
	//+-------------------------------Fonctions d'analyse des ressources-------------------------------------+
3 jpm 187
 
188
	private function etreRessourceId() {
189
		$ok = false;
190
		if ($this->estUnIdentifiant() && count($this->ressources) == 1) {
191
			$ok = true;
192
		}
193
		return $ok;
194
	}
195
 
196
	public function traiterRessources() {
197
		if (isset($this->ressources) && count($this->ressources) > 0) {
198
			if ($this->ressources[0] == 'relations') {
990 mathias 199
				$this->traiterRessourceIdRelations();
3 jpm 200
			} elseif ($this->estUnIdentifiant()) { //l'identifiant peut etre de type /#id ou /nt:#id
201
				$this->traiterRessourcesIdentifiant(); // dans le service noms ou taxons
202
			} elseif ($this->ressources[0] == 'stats') { //ressource = noms/stats
203
				$this->traiterRessourcesStats();
204
			} else {
205
				$e = 'Erreur dans votre requete </br> Ressources disponibles : <br/>
206
					 <li> /'.$this->service.'/#id (id : L\'identifiant du nom rechercher)</li>
207
					 <li> /'.$this->service.'/nt:#id (id : Numero du taxon recherche)</li>
208
					 <li> /'.$this->service.'/stats </li>';
209
				$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
210
			}
211
		}
212
	}
213
 
214
	public function traiterRessourcesStats() {
215
		$this->format_reponse = $this->service.'/stats';
216
 
217
		$e = "Erreur dans votre requête </br> Ressources disponibles : $this->service/stats/[annees|rangs|initiales]";
218
		if (isset($this->ressources[1]) && !empty($this->ressources[1])) {
219
			switch ($this->ressources[1]) {
220
				case 'annees' :
221
					$this->traiterRessourceStatsAnnees();
222
					break;
223
				case 'rangs' :
224
					$this->traiterRessourceStatsRangs();
225
					break;
226
				case 'initiales' :
227
					$this->traiterRessourceStatsInitiales();
228
					break;
229
				default :
230
					$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
231
					break;
232
			}
233
		} else {
234
			$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
235
		}
236
	}
237
 
238
	/** Vérifie si la première valeur de la table de ressource est un identifiant :
239
	 * un numerique ou un numéro taxonomique sous la forme nt:xx */
240
	public function estUnIdentifiant() {
241
		return (is_numeric($this->ressources[0]) || (strrpos($this->ressources[0],'nt:') !== false
242
				&& is_numeric(str_replace('nt:','',$this->ressources[0]))));
243
	}
244
 
91 jpm 245
	//+------------------------------------------------------------------------------------------------------+
246
	// Fonction d'analyse des parametres
3 jpm 247
 
248
	/** Permet de remplir le tableau compo_nom. Il comprendra en fct du paramètre ns.structure les éléments à rajouter
249
	 * au nom_sci (annee, auteur, biblio ou addendum). */
250
	public function remplirTableCompositionNom($valeur) {
251
		$structure_nom = explode(',', $valeur);
656 jpm 252
 
3 jpm 253
		foreach ($structure_nom as $structure) {
656 jpm 254
			$structure = trim($structure);
255
			$patterns = array('/^an$/', '/^au$/', '/^bib$/', '/^ad$/', '/^sp$/', '/^gen$/', '/^ssp$/','/^fam$/',
256
				'/^au_ss$/','/^bib_ss$/');
257
			$champs = array('annee', 'auteur', 'biblio_origine', 'nom_addendum', 'epithete_sp', 'genre',
258
				'epithete_infra_sp','famille','auteur', 'biblio_origine');
259
 
260
			// avec str_replace() 'sp' est inclu dans 'ssp', et la conversion pour 'ssp' est mauvaise
261
			$this->compo_nom[$structure] = preg_replace($patterns, $champs, $structure);
262
		}
3 jpm 263
	}
264
 
265
	public function mettreAuFormat() {
266
		if ($this->parametres['ns.format'] == 'htm') {
267
			if (strrpos($this->requete_champ, 'nom_sci_html as nom_sci') === false) {
268
				$this->requete_champ = str_replace('nom_sci', 'nom_sci_html as nom_sci', $this->requete_champ);
269
			}
270
		}
271
	}
272
 
91 jpm 273
	//+------------------------------------------------------------------------------------------------------+
274
	// Fonctions de formatage
3 jpm 275
 
276
	/** Fonction permettant de creer la table dont le nom est passé en paramètre (champs_api, champs_bdtfx,
277
	 * correspondance_champs...). Les données de chaque table sont présentes dans le fichier de configuration config.ini
278
	 * @param String $table : Peut contenir plusieurs nom de table dont on souhaite récupérer les données : table,table,table. */
279
	public function recupererTableSignification($table) {
280
		$tables = explode(',', $table);
281
		foreach ($tables as $tab) {
282
			if ($tab == 'champs_comp') {
283
				$champ_bdnff_api = array_keys($this->champs_api); //on recupère le nom des champ ds la bdd
284
				$this->champs_comp = array_diff($this->champs_table, $champ_bdnff_api);
285
			} elseif ($tab == 'champs_api') {
286
				foreach ($this->correspondance_champs as $key => $val) {
287
					preg_match('/(hybride[.]parent_0[12](?:[.]notes)?|nom_sci[.][^.]+|[^.]+)(?:[.](id|code))?/', $val, $match);
288
					$val = $match[1];
289
					$this->champs_api[$key] = $val;
290
				}
291
			} else {
292
				$this->$tab = $this->recupererTableauConfig($tab);
293
			}
294
		}
295
	}
296
 
297
	public function formaterEnOss($resultat) {
298
		$table_nom = array();
299
		$oss = '';
300
		foreach ($resultat as $tab) {
301
			if (isset($tab['nom_sci']) ) {
302
				if (!in_array($tab['nom_sci'], $table_nom)) {
303
					$table_nom[] = $tab['nom_sci'];
568 mathilde 304
					$oss[] = $tab['nom_sci'].' '.$this->ajouterCompositionNom($tab);
3 jpm 305
				}
568 mathilde 306
			}else {
307
				$res = $this->ajouterCompositionNom($tab);
308
				if($res) {
309
					$oss[] = $res;
310
				}
3 jpm 311
			}
656 jpm 312
 
3 jpm 313
		}
656 jpm 314
 
3 jpm 315
		if (isset($this->masque)) $masque = implode('&', $this->masque);
316
		else $masque = 'Pas de masque';
317
		$table_retour_oss = array($masque, $oss);
318
		return $table_retour_oss;
319
	}
320
 
321
	public function afficherEnteteResultat($url_service) {
963 raphael 322
        $arr = array(
323
            'depart' => $this->limite_requete['depart'],
324
            'limite' => $this->limite_requete['limite'],
325
            'total'  => $this->total_resultat);
326
 
327
		if (isset($this->masque))
328
            $arr['masque'] = implode('&', $this->masque);
329
 
3 jpm 330
		$url = $this->formulerUrl($this->total_resultat, $url_service);
331
		if (isset($url['precedent']) && $url['precedent'] != '') {
963 raphael 332
			$arr['href.precedent'] = $url['precedent'];
3 jpm 333
		}
334
		if (isset($url['suivant']) && $url['suivant']   != '') {
963 raphael 335
			$arr['href.suivant']   = $url['suivant'];
3 jpm 336
		}
963 raphael 337
        return $arr;
3 jpm 338
	}
339
 
340
	public function afficherNomHrefRetenu($tab, $num) {
341
		$this->resultat_req = $tab;
342
		$this->afficherDonnees('num_nom', $num);
343
		if ($this->parametres['retour.format'] == 'min') { // sinon est affiché ds afficherDonnees(num_nom, $val) ci-dessus
326 delphine 344
			 $this->table_retour['nom_sci'] = $tab['nom_sci'];
572 mathilde 345
			 $this->table_retour['nom_sci_complet'] = $tab['nom_sci'].' '.$this->ajouterCompositionNom($tab);
3 jpm 346
		}
562 delphine 347
		if ($tab['num_nom_retenu'] != '') {
348
			$retenu = ($tab['num_nom_retenu'] == $num) ? 'true' : 'false';
349
		} else {
350
			$retenu = 'absent';
351
		}
352
		$this->table_retour['retenu'] = $retenu;
656 jpm 353
		// Pourquoi ce unset ? JPM - 28-03-2013
3 jpm 354
		unset($this->table_retour['id']);
355
	}
356
 
357
 
91 jpm 358
	//+------------------------------------------------------------------------------------------------------+
359
	// Fonction de formatage pour les services /#id/
3 jpm 360
 
361
	public function formaterId($resultat) {
362
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
363
		$this->resultat_req = $resultat;
112 jpm 364
 
3 jpm 365
		foreach ($resultat as $cle => $valeur) {
366
			if ($valeur != '') {
367
				$this->afficherDonnees($cle, $valeur);
368
			}
369
		}
104 delphine 370
		if (isset($this->parametres['retour.champs']) && $this->format_reponse == 'noms/id') {
371
			$retour = $this->table_retour;
372
			$this->table_retour = array();
373
			$champs = explode(',', $this->parametres['retour.champs']);
374
			$this->ajouterChampsPersonnalises($champs, $retour);
375
		}
3 jpm 376
		unset($this->table_retour['href']);
377
		return $this->table_retour;
378
	}
379
 
380
	public function formaterIdChamp($resultat) {
381
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
382
		$reponse_id = $this->formaterId($resultat);
383
		$this->table_retour = array();
384
		$champs = explode(' ', $this->ressources[1]);
385
		$this->ajouterChampsPersonnalises($champs, $reponse_id);
386
		return $this->table_retour;
387
	}
388
 
389
	protected function ajouterChampsPersonnalises($champs, $reponse_id) {
357 delphine 390
		$champs_a_libeller = array('nom_retenu', 'rang', 'basionyme', 'hybride', 'hybride.parent_01',
391
			 'hybride.parent_02', 'presence', 'tax_sup', 'statut_origine', 'statut_culture', 'statut_introduction');
3 jpm 392
		if (! is_null($champs) && is_array($champs) && count($champs) > 0) {
393
			foreach ($champs as $champ) {
394
				if ($this->verifierValiditeChamp($champ)) {
395
					if (strrpos($champ, '.*') !== false) {
396
						$this->afficherPointEtoile($champ, $reponse_id);
357 delphine 397
					} elseif (in_array($champ, $champs_a_libeller)) {
656 jpm 398
						$this->table_retour[$champ.'.libelle'] =
358 delphine 399
							(isset($reponse_id[$champ.'.libelle'])) ? $reponse_id[$champ.'.libelle'] : null;
3 jpm 400
					} else {
401
						$champ = $this->trouverChampBddCorrespondant($champ);
402
						$this->table_retour[$champ] = (isset($reponse_id[$champ])) ? $reponse_id[$champ] : null;
403
					}
404
				}
405
			}
406
		}
407
	}
408
 
409
	public function afficherPointEtoile($champ, $reponse) {
410
		preg_match('/^([^.]+\.)\*$/', $champ, $match);
411
		if ($match[1] == 'nom_sci') {
412
			$this->afficherNomSciPointEpithete($this->resultat_req);
413
		} else {
414
			foreach ($reponse as $chp => $valeur) {
415
				if (strrpos($chp, $match[1]) !== false) {
416
					if ($valeur != '') {
417
						$this->table_retour[$chp] = $valeur;
418
					} else {
419
						$this->table_retour[$chp] = null;
420
					}
421
				}
422
			}
423
		}
424
	}
425
 
426
	public function decomposerNomChamp($champ) {
427
		$decomposition = false;
428
		if (preg_match('/^(?:([^.]+\.parent_0[12]|[^.]+))(?:\.(.+))?$/', $champ, $match)) {
429
			$radical_champ = $match[1];
90 delphine 430
			$suffixe = (isset($match[2])) ? $match[2] : "";
3 jpm 431
			$decomposition = array($radical_champ, $suffixe);
432
		}
433
		return $decomposition;
434
	}
435
 
436
	public function verifierValiditeChamp($champ) {
437
		$decomposition = $this->decomposerNomChamp($champ);
438
		$validite_ressource = true;
439
		if ($decomposition) {
440
			list($radical, $suffixe) = $decomposition;
363 delphine 441
			$champs_complementaire = array('nom_retenu_complet', 'basionyme_complet');
3 jpm 442
			// on verifie si le nom du champ existe bien
443
			if (!$this->estChampApi($radical) && !$this->estChampComplementaire($radical)) {
363 delphine 444
				if (!in_array($radical, $champs_complementaire)) {
445
					$validite_ressource = false;
446
					$e = 'Le champ "'.$radical.'" n\'existe pas dans la base. <br/><br/>';
447
					$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
448
				}
3 jpm 449
			} elseif ($this->estUnPoint($champ)) {
450
				$validite_ressource = $this->verifierValiditeSuffixe($suffixe, $radical);
451
			}
452
		}
453
		return $validite_ressource;
454
	}
455
 
456
	public function estChampApi($radical_champ) {
457
		$champ_api_ok = false;
458
		if (in_array($radical_champ, $this->champs_api) || in_array($radical_champ, $this->correspondance_champs)) {
459
			$champ_api_ok = true;
460
		}
461
		return $champ_api_ok;
462
	}
463
 
464
	public function estChampComplementaire($radical_champ) {
465
		$champ_complementaire_ok = in_array($radical_champ, $this->champs_comp) ? true : false;
466
		return	$champ_complementaire_ok;
467
	}
468
 
469
	public function verifierValiditeSuffixe($suffixe, $radical_champ) {
470
		$validite_ressource = true;
471
		if ($this->correspondAUnId($radical_champ) || $radical_champ == 'id') {
472
			$this->verificationSuffixesIdentifiant($suffixe, $radical_champ, $validite_ressource);
473
		} elseif ($this->correspondAUnCode($radical_champ)) {
474
			$this->verificationSuffixesCodes($suffixe, $radical_champ, $validite_ressource);
475
		} elseif ($radical_champ == 'nom_sci') {
476
			if ($suffixe != '*') {
477
				$validite_ressource = false;
478
				$m = 'Erreur : Le suffixe demandé n\'existe pas pour le champ "'.$radical_champ.'".<br/>
479
					Les suffixes possibles sont les suivants : <li> * </li>';
480
				$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $m);
481
			}
482
		} else {
483
			$validite_ressource = false;
484
			$m = 'Erreur : Le paramètre "'.$radical_champ.'" ne peut pas présenter de suffixe. <br/><br/>';
485
			$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $m);
486
		}
487
		return $validite_ressource;
488
	}
489
 
490
	public function verificationSuffixesCodes(&$suffixe, &$radical_champ, &$validite_ressource ) {
491
		if (!in_array($suffixe, array('*', 'code', 'href', 'details'))) {
492
			$validite_ressource = false;
493
			$e = 'Erreur : Le suffixe demandé n\'existe pas pour le champ "'.$radical_champ.'.<br/> Les suffixes '
494
				.'possibles sont les suivants : <li> .* </li><li> .code </li><li> .href </li><li> .details </li>';
495
			$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
496
		}
497
	}
498
 
499
	public function verificationSuffixesIdentifiant(&$suffixe, &$radical_champ, &$validite_ressource) {
500
		if ((strrpos($radical_champ, 'parent') !== false && !in_array($suffixe, array('*', 'id', 'href', 'details', 'notes')))
501
			|| !in_array($suffixe, array('*', 'id', 'href', 'details')) && strrpos($radical_champ, 'parent') === false) {
502
			$validite_ressource = false;
503
			$e = 'Erreur : Le suffixe demandé n\'existe pas pour le champ "'.$radical_champ.'".<br/> Les suffixes '
504
				.'possibles sont les suivants : <li> .* </li><li> .id </li><li> .href </li><li> .details </li>'
505
				.'<li> .notes (seulement pour les hybride.parent)';
506
			$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
507
		}
508
	}
509
 
510
 
511
//------------------------------fonction de formatage pour les services /stats/-----------------------------------------
512
 
513
	public function formaterStatsAnnee($resultat) {
514
		foreach ($resultat as $cle_annee) {
515
			$annee = ($cle_annee['annee'] != '') ? $cle_annee['annee'] : 'ND';
516
			$nb = $cle_annee['nombre'];
517
			$retour_stats_annee[$annee] = $nb;
518
		}
519
		return $retour_stats_annee;
520
	}
521
 
522
	public function formaterStatsRang($resultat) {
523
		foreach ($resultat as $rangs) {
524
			if ($rangs['rang'] != 0) {
525
				$rang = $rangs['rang'];
526
				if ($this->parametres['retour.format'] == 'max') {
527
					$retour_rang[$rang]['rang'] = $this->ajouterSignificationCode('rang',$rang);
528
				}
529
				$nombre = $rangs['nombre'];
530
				$retour_rang[$rang]['nombre'] = $nombre;
531
			}
532
		}
533
		return $retour_rang;
534
	}
535
 
536
	public function formaterStatsInitiales($resultat) {
537
		$rang = null;
538
		$table_rang = array();
539
		foreach ($resultat as $tuple) {
540
			if ($tuple['rang'] != 0) {
541
				$this->memoriserRang($table_rang, $tuple, $rang);
542
				if ($tuple['lettre'] == 'x ') {
543
					$this->ajouterHybrideChimere('hybride', $rang, $tuple);
544
				} elseif ($tuple['lettre'] == '+ ') {
545
					$this->ajouterHybrideChimere('chimere', $rang, $tuple);
546
				} else {
547
					$l = substr($tuple['lettre'], 0, 1);
548
					if (isset($this->table_retour[$rang][$l])) {
549
						$this->table_retour[$rang][substr($tuple['lettre'], 0, 1)] += floatval($tuple['nb']);
550
					} else {
551
						$this->table_retour[$rang][substr($tuple['lettre'], 0, 1)] = floatval($tuple['nb']);
552
					}
553
				}
554
			}
555
		}
556
		return $this->table_retour;
557
	}
558
 
559
	public function memoriserRang(&$table_rang, $tuple, &$rang) {
560
		if (is_array($table_rang)) {
561
			if (!in_array($tuple['rang'], $table_rang)) {
562
				$rang = $tuple['rang'];
563
				$table_rang[] = $rang;
564
				if ($this->parametres['retour.format'] == 'max') {
565
					$rang = $this->ajouterSignificationCode('rang', $rang);
566
				}
567
			}
568
		}
569
	}
570
 
571
	public function ajouterHybrideChimere($groupe, &$rang, &$tuple) {
572
		if (isset($this->table_retour[$rang][str_replace('hybride', 'hyb', $groupe)])) {
573
			$this->table_retour[$rang][$groupe] += floatval($tuple['nb']);
574
		} else {
575
			$this->table_retour[$rang][$groupe] = floatval($tuple['nb']);
576
		}
577
	}
578
 
579
	//-----------------------------Fonctions d'affichage utiliser dans les fonctions de formatage---------------------------
580
 
581
	public function afficherDonnees($champApi, $valeur) {
582
		$champBdd = $this->trouverChampBddCorrespondant($champApi);
740 raphael 583
 
3 jpm 584
		if ($this->parametres['retour.format'] == 'min') {
133 aurelien 585
			if ($champApi == 'nom_sci') {
568 mathilde 586
				$valeur = $valeur.' '.$this->ajouterCompositionNom($this->resultat_req);
3 jpm 587
			}
325 delphine 588
			if ($champApi == 'nom_sci_html') {
568 mathilde 589
				$valeur = $valeur.' '.$this->ajouterCompositionNom($this->resultat_req, 'htm');
325 delphine 590
			}
3 jpm 591
			$this->table_retour[$champBdd] = $valeur;
770 raphael 592
			// on essaye de permettre l'obtention du nom_sci_complet, y compris en retour.format == 'min',
593
			// tout en évitant les appels aux ontologies
594
			/*if ($this->correspondAUnId($champBdd) || $champBdd == 'id' && $valeur != '0') {
595
				preg_match('/^([^.]+\.parent_0[12]|[^.]+)(?:\.id)?$/', $champBdd, $match);
596
				if(strpos($this->parametres['retour.format'], $match[1]) !== false) $this->afficherSignification($match[1], $valeur);
597
				}*/
3 jpm 598
		} else {
599
			$this->afficherToutesLesInfos($champBdd, $valeur);
600
		}
601
	}
602
 
603
	public function trouverChampBddCorrespondant($champApi) {
604
		if (array_key_exists($champApi, $this->champs_api)) {
605
			$champBdd = $this->correspondance_champs[$champApi];
606
		} else {
607
			$champBdd = $champApi;
608
		}
609
		return $champBdd;
610
	}
611
 
612
	public function afficherToutesLesInfos($nom_champ_api, $valeur) {
613
		if ($this->presentePlusieursId($nom_champ_api, $valeur)) {
614
			preg_match('/^([^.]+\.parent_0[12]|[^.]+)(?:\.id)?$/', $nom_champ_api, $match);
615
			$this->afficherInfosPrecises($match[1], 'details', $valeur);
616
			$this->table_retour[$nom_champ_api] = $valeur;
617
 
618
		} elseif (strrpos($nom_champ_api, 'parent') !== false && strrpos($nom_champ_api, 'notes') !== false) {
619
			$this->table_retour[$nom_champ_api] = $valeur;
620
 
621
		} elseif (($this->correspondAUnId($nom_champ_api) || $nom_champ_api == 'id' && $valeur != '0')) {
622
			preg_match('/^([^.]+\.parent_0[12]|[^.]+)(?:\.id)?$/', $nom_champ_api, $match);
623
			$this->afficherInfosPrecises($match[1], 'id,signification,href', $valeur);
624
 
625
		} elseif ($this->correspondAUnCode($nom_champ_api)) {
626
			preg_match('/^([^.]+)(?:\.code)?$/', $nom_champ_api, $match);
627
			$this->afficherInfosPrecises($match[1], 'code,signification,href', $valeur);
628
 
325 delphine 629
		} elseif ($nom_champ_api == 'nom_sci_html') {
326 delphine 630
			$this->table_retour['nom_sci_html'] = $valeur;
568 mathilde 631
			$this->table_retour['nom_sci_html_complet'] = $valeur.' '.$this->ajouterCompositionNom($this->resultat_req, 'htm');
325 delphine 632
		}elseif ($nom_champ_api != 'nom_sci') {
3 jpm 633
			$this->table_retour[$nom_champ_api] = $valeur;
634
		}
635
	}
636
 
637
	public function presentePlusieursId($ressource, $valeur = null) {
638
		if ($valeur) {
639
			$presente = strrpos($ressource, 'proparte') !== false && strrpos($valeur, ',') !== false;
640
		} else { //pour la vérification du champ, on ignore alors la valeur de la ressource
641
			$presente = strrpos($ressource, 'proparte') !== false;
642
		}
643
		return $presente;
644
	}
645
 
646
	public function afficherInfosPrecises($champ, $suffixe, $valeur) {
647
		$suffixes = explode(',', $suffixe);
648
		//on initialise au service appelé. Sera potentiellement modifié dans la fonction afficherSignification()
649
		$this->service_href = $this->service;
650
		foreach ($suffixes  as $suffixe) {
651
			switch ($suffixe) {
652
				case 'id' 			 :
653
					$this->table_retour[str_replace('id.id', 'id', $champ.'.id')] = $valeur;
654
					break;
655
				case 'details' 		 :
656
					$this->afficherTableDetails($champ, $valeur);
657
					break;
658
				case 'signification' :
659
					$this->afficherSignification($champ, $valeur);
660
					break;
661
				case 'href' 		 :
662
					$url = $this->creerUrl($champ, $valeur);
663
					$this->table_retour[str_replace('id.href', 'href', $champ.'.href')] = $url;
664
					break;
665
				case 'code' 		 :
666
					$this->table_retour[$champ.'.code'] = $this->obtenirCode($champ, $valeur);
667
					break;
668
				case 'notes' 		 :
669
					$this->table_retour[$champ.'.notes'] = $this->resultat_req[str_replace('.', '_', $champ).'_notes'];
670
					break;
671
				default : break;
672
			}
673
		}
674
	}
675
 
676
	public function afficherTableDetails($nom_champ_api, $valeur) {
677
		$tab_id = explode(',', $valeur);
678
		$tab_res = $this->table_retour;
679
		$this->table_retour = array();
680
		foreach ($tab_id as $id) {
681
			$this->afficherInfosPrecises($nom_champ_api, 'id,signification,href', $id);
682
			$tab_res[$nom_champ_api.'.details'][] = $this->table_retour;
683
			$this->table_retour = array();
684
		}
685
		$this->table_retour = $tab_res;
686
	}
687
 
688
	private function obtenirCode($champ, $valeur) {
689
		$code = $this->transformerChampEnCode($champ);
690
		return "bdnt.$code:$valeur";
691
	}
692
 
693
	private function transformerChampEnCode($champ) {
694
		if (is_null($this->relationsChampsCodesOntologie)) {
695
			$this->relationsChampsCodesOntologie = Outils::recupererTableauConfig('ChampsCodesOntologie');
696
		}
697
 
698
		$code = $champ;
699
		if (array_key_exists($champ, $this->relationsChampsCodesOntologie)) {
700
			$code = $this->relationsChampsCodesOntologie[$champ];
701
		}
702
		return $code;
703
	}
704
 
705
	public function creerUrl($champ, $valeur) {
706
		if ($this->correspondAUnId($champ) || $champ == 'id') {
707
			$service = $this->service_href;
708
			$url = $this->ajouterHref($service, $valeur);
709
		} else {
710
			$code = $this->transformerChampEnCode($champ);
711
			$url = $this->ajouterHrefAutreProjet('ontologies', "$code:", $valeur, 'bdnt');
712
		}
713
		return $url;
714
	}
715
 
716
	public function afficherSignification($champ, $valeur) {
717
		if ($champ == 'id' && isset($this->resultat_req['nom_sci']) && $this->resultat_req['num_nom'] == $valeur) {
718
			//si le nom_sci du num_nom que l'on veut afficher est déjà dans la table de résultat :
326 delphine 719
			$this->table_retour['nom_sci'] = $this->resultat_req['nom_sci'];
898 raphael 720
			$this->table_retour['nom_sci_complet'] = $this->resultat_req['nom_sci'] . (($suff = $this->ajouterCompositionNom($this->resultat_req)) ? ' ' . $suff : '');
3 jpm 721
		} elseif ($this->correspondAUnId($champ) || $champ == 'id') {
722
			$nom = $this->recupererNomSci($valeur);
723
			if ($nom != array()) {
357 delphine 724
				$this->table_retour[$champ.'.libelle'] = $nom['nom_sci'];
326 delphine 725
				$this->table_retour[$champ.'_html'] = $nom['nom_sci_html'];
726
				$this->table_retour[$champ.'_complet'] = $nom['nom_sci_complet'];
727
				$this->table_retour[$champ.'_html_complet'] = $nom['nom_sci_complet_html'];
3 jpm 728
				$this->service_href = $nom['service'];
729
			}
730
		} elseif ($this->correspondAUnCode($champ)) {
357 delphine 731
			$this->table_retour[$champ.'.libelle'] = $this->ajouterSignificationCode($champ, $valeur);
3 jpm 732
		}
733
	}
734
 
735
	/** Permet d'afficher les élements nomenclatural du nom_sci lors de l'appel dans le service noms/id/champ du champ^nom_sci.*/
736
	public function afficherNomSciPointEpithete($resultat) {
737
		$tab_nom_sci   = array('nom_supra_generique', 'genre', 'epithete_infra_generique', 'epithete_sp',
738
		'type_epithete', 'epithete_infra_sp', 'cultivar_groupe', 'cultivar', 'nom_commercial');
739
		foreach ($tab_nom_sci as $compo_nom) {
740
			if (isset($resultat[$compo_nom]) && !empty($resultat[$compo_nom])) {
741
				$this->table_retour['nom_sci.'.$compo_nom] = $resultat[$compo_nom];
742
			}
743
		}
744
	}
745
 
746
	public function ajouterSignificationCode($champ, $valeur) {
664 delphine 747
		if($this->termeOntologieEstEnCache($champ, $valeur)) {
748
			$nom_code = $this->obtenirTermeOntologieParCache($champ, $valeur);
656 jpm 749
		} else {
664 delphine 750
			$code = $this->transformerChampEnCode($champ);
751
			if (preg_match('/^([^_-]+)(?:_|-)([^_-]+)$/', $code, $match)) {
752
				$code = $match[1].ucfirst($match[2]);
629 aurelien 753
			}
870 delphine 754
			$requete = sprintf('SELECT * FROM %s WHERE id IN (SELECT id FROM %s WHERE code = "%s" AND classe_id = (SELECT id FROM %s WHERE code = "%s")) LIMIT 0, 100 -- %s:%s', Config::get('bdd_table_ontologies'), Config::get('bdd_table_ontologies'), $valeur, Config::get('bdd_table_ontologies'), $code, __FILE__,  __LINE__);
755
			$res = $this->getBdd()->recuperer($requete);
629 aurelien 756
			$nom_code = $valeur;
870 delphine 757
			if (is_array($res)) {
758
				$nom_code = $res['nom'];
629 aurelien 759
			}
664 delphine 760
			$this->mettreEnCacheOntologie($champ, $valeur, $nom_code);
3 jpm 761
		}
762
		return $nom_code;
763
	}
764
 
765
	public function recupererNomSci($id) {
766
		$nom = array();
767
		if ($id != 0) {
768
			if ($this->compo_nom == null) {
326 delphine 769
				$req = 'SELECT nom_sci, num_nom_retenu, nom_sci_html FROM '.$this->table.' WHERE num_nom = '.$id;
3 jpm 770
			} else { //on ajoute à la requete sql, les champs de ns.structure
771
				//print_r($this->compo_nom);
326 delphine 772
				$req = 'SELECT nom_sci, num_nom_retenu, nom_sci_html, '.implode(', ', $this->compo_nom)
3 jpm 773
						.' FROM '.$this->table
774
						.' WHERE num_nom = '.$id;
775
			}
776
			if ($this->parametres['ns.format'] == 'htm') {
777
				$req = str_replace('nom_sci', 'nom_sci_html as nom_sci', $req);
778
			}
740 raphael 779
			$res = $this->getBdd()->recuperer($req . ' -- ' . __FILE__ . ':' . __LINE__);
3 jpm 780
			if ($res) {
326 delphine 781
				$nom['nom_sci']	= $res['nom_sci'];
916 jpm 782
				$nom['nom_sci_html'] = $res['nom_sci_html'];
783
				$nom['nom_sci_complet'] = $res['nom_sci'].' '.$this->ajouterCompositionNom($res);
784
				$nom['nom_sci_complet_html'] = $res['nom_sci_html'].' '.$this->ajouterCompositionNom($res, 'htm');
3 jpm 785
				$nom['service'] = ($res['num_nom_retenu'] == $id && $this->service == 'taxons') ? 'taxons' : 'noms';
786
			}
787
		}
788
		return $nom;
789
	}
790
 
791
	/** Permet de retourner une chaine de caractère composée des parametres du nom (ns.structure : annnée, auteur,
792
	 * bibilio et addendum). A ajouter au nom scientifique */
325 delphine 793
	public function ajouterCompositionNom($tab_res, $format = '') {
794
		$format = ($format == '') ? $this->parametres['ns.format'] : $format;
568 mathilde 795
 
3 jpm 796
		$nom = '';
797
		if (isset($this->compo_nom)) {
325 delphine 798
			if ($format == 'htm') {
3 jpm 799
				$format = array(
800
					'au' => '<span class="auteur">%s</span>',
801
					'an' => '[<span class="annee">%s</span>]',
802
					'an_bib' => '[<span class="annee">%s</span>, <span class="biblio">%s</span>]',
803
					'bib' => '[<span class="biblio">%s</span>]',
804
					'ad' => '[<span class="adendum">%s</span>]');
805
			} else {
806
				$format = array(
807
					'au' => '%s',
808
					'an' => '[%s]',
809
					'an_bib' => '[%s, %s]',
810
					'bib' => '[%s]',
568 mathilde 811
					'ad' => '[%s]',
812
					'gen' => '%s',
813
					'sp' => '%s',
814
					'ssp' => '%s',
815
					'fam' => '%s',
816
					'au_ss' => '%s',
817
					'bib_ss' => '%s');
3 jpm 818
			}
112 jpm 819
			$compo_nom = array();
568 mathilde 820
 
3 jpm 821
			foreach ($this->compo_nom as $key => $champ) {
822
				if (isset($tab_res[$champ]) && !empty($tab_res[$champ])) {
823
					$compo_nom[$key] = $tab_res[$champ];
824
				}
825
			}
112 jpm 826
			$nom_complet = $this->formerNomComplet($compo_nom, $format);
568 mathilde 827
			$nom = implode(' ', $nom_complet);
3 jpm 828
		}
829
		return rtrim($nom, ' ');
830
	}
831
 
832
 
112 jpm 833
	public function formerNomComplet($compo_nom, $format) {
834
		$nom_complet = array();
3 jpm 835
		extract($compo_nom);
836
		if (isset($au)) $nom_complet[] = sprintf($format['au'], $au);
837
		if (isset($an)) {
838
			if (isset($bib)) {
839
				$nom_complet[] = sprintf($format['an_bib'], $an, $bib);
840
			} else {
841
				$nom_complet[] = sprintf($format['an'], $an);
842
			}
843
		} elseif (isset($bib)) {
844
			$nom_complet[] = sprintf($format['bib'], $bib);
845
		}
846
		if (isset($ad)) $nom_complet[] = sprintf($format['ad'], $ad);
568 mathilde 847
		if (isset($gen)) $nom_complet[] = sprintf($format['gen'], $gen);
848
		if (isset($ssp)) $nom_complet[] = sprintf($format['ssp'], $ssp);
849
		if (isset($sp)) $nom_complet[] = sprintf($format['sp'], $sp);
850
		if (isset($fam)) $nom_complet[] = sprintf($format['fam'], $fam);
851
		if (isset($au_ss)) $nom_complet[] = sprintf($format['au_ss'], $au_ss);
852
		if (isset($bib_ss)) {
853
			$bibl = $this->tronquerBiblio($bib_ss);
854
			//simule un 'select distinct' sur les biblio tronquées
656 jpm 855
			if (!isset($this->bib_traitees[$bibl])) {
568 mathilde 856
				$nom_complet[] = sprintf($format['bib_ss'],$bibl );
857
				$this->bib_traitees[$bibl] = 1;
858
			}
859
		}
3 jpm 860
		return $nom_complet;
861
	}
862
 
568 mathilde 863
	public function tronquerBiblio($valeur){
574 mathilde 864
		$bib = '';
865
		if(strpos($valeur,',') !== false) {
866
			$bib = explode(',',$valeur);
568 mathilde 867
		}
574 mathilde 868
		if(strpos($bib[0],';') !== false) {
656 jpm 869
 
574 mathilde 870
			$bib[0] = strstr($bib[0],';');
871
			$bib[0] = str_replace('; ','',$bib[0]);
872
		}
873
		return $bib[0];
568 mathilde 874
	}
3 jpm 875
 
568 mathilde 876
 
656 jpm 877
 
3 jpm 878
	public function correspondAUnCode($key) {
879
		return (strrpos($key, '.code') !== false) || (in_array($key.'.code', $this->correspondance_champs));
880
	}
881
 
882
	public function correspondAUnId($key) {
883
		return (strrpos($key, '.id') !== false) || (in_array($key.'.id', $this->correspondance_champs));
884
	}
885
 
886
	public function estUnPoint($key) {
887
		if (strrpos($key, 'hybride.parent') !== false) {
888
			$key = str_replace('hybride.parent', 'hybride_parent', $key);
889
		}
890
		return (strrpos($key, '.') !== false);
891
	}
892
 
893
	public function recupererMasquePrincipal() {
894
		$masque = null;
895
		$tab_masque   = array(
896
			'masque' => 'nom_sci',
897
			'masque_sg' => 'nom_supra_generique',
898
			'masque_gen' => 'genre',
899
			'masque_sp' => 'epithete_sp',
900
			'masque_ssp' => 'epithete_infra_sp',
901
			'masque_au' => 'auteur',
902
			'masque_an' => 'annee',
903
			'masque_bib' => 'biblio_origine',
904
			'masque_ad' => 'addendum',
905
			'masque_rg' => 'rang');
906
		$liste_masque = array();
907
 
908
		if (isset($this->masque['num_nom'])) {
909
			$liste_masque[] = $this->masque['num_nom'];
910
		}
911
 
912
		foreach ($tab_masque as $key => $filtre) {
913
            if (isset($this->masque[$filtre])) {
914
            	if (!isset($masque) && !in_array($filtre, array('rang', 'annee'))) {
915
            		$masque = array($key, $filtre);
916
            	}
917
                $liste_masque[] = $this->masque[$filtre];
918
            }
919
        }
920
        $this->masque = $liste_masque;
921
        return $masque;
922
	}
656 jpm 923
 
629 aurelien 924
	private function mettreEnCacheOntologie($categorie, $valeur, $correspondance) {
925
		if(!isset($this->ontologie[$categorie])) {
926
			$this->ontologie[$categorie] = array();
927
		}
928
		if(!isset($this->ontologie[$categorie][$valeur])) {
929
			$this->ontologie[$categorie][$valeur] = array();
930
		}
931
		$this->ontologie[$categorie][$valeur] = $correspondance;
932
	}
656 jpm 933
 
629 aurelien 934
	private function termeOntologieEstEnCache($categorie, $valeur) {
935
		return array_key_exists($categorie, $this->ontologie) && array_key_exists($valeur, $this->ontologie[$categorie]);
936
	}
656 jpm 937
 
629 aurelien 938
	private function obtenirTermeOntologieParCache($categorie, $valeur) {
939
		return $this->ontologie[$categorie][$valeur];
940
	}
3 jpm 941
}
942
?>