Subversion Repositories eFlore/Projets.eflore-projets

Rev

Rev 457 | Rev 536 | 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
/**
3
* Classe Commun.php est une classe abstraite qui contient les méthodes de base communes à tous les
4
* sous-services des projets.
5
*
6
* Encodage en entrée : utf8
7
* Encodage en sortie : utf8
8
* @package eflore-projets
9
* @author Jennifer DHÉ <jennifer.dhe@tela-botanica.org>
10
* @author Delphine CAUQUIL <delphine@tela-botanica.org>
11
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
12
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
13
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
14
* @version 1.0
15
* @copyright 1999-2011 Tela Botanica (accueil@tela-botanica.org)
16
*/
17
 
18
abstract class Commun {
19
 
20
	/** Objet Bdd. */
21
	private $Bdd = null;
22
	/** Objet Rest Client. */
23
	private $RestClient = null;
24
 
25
	/** Contients les paramètres. Doit remplacer table_param. */
26
	protected $parametres = array();
27
	/** Contients les ressources. Doit remplacer table_ressources. */
28
	protected $ressources = array();
29
	/** Le nom du service courrant. */
30
	protected $serviceNom = null;
31
 
32
	//Classe commune à tous les services web d'un projet. Contient par exemple les fonctions permettant de
33
	//renvoyer la réponse http...
34
	protected $entete_http; // Entete de la réponse correspondant au code de réponse de la requete http */
35
	protected $corps_http; // Tableau de résultat à retourner au format json ou la description de l'erreur si elle existe */
36
	protected $service; // Nom du service appelé
37
	/** Stocke la version du projet demandée dans la requete
38
	 *  - "*" : (/#projet/* /meta-donnees) Renvoi les meta-données de toutes les versions du projet
39
	 *  - "numero de la version" : (/#projet/2.00/meta-donnees) Renvoi les meta-données de la version 2.00 du projet */
40
	protected $version_projet = '+';
41
	protected $table_version; //Stocke les noms des tables de toutes les versions du projet disponibles
42
	/** tableau contenant tous les champs d'une table (est rempli par la fonction Commun::recupererNomChamp($table)) */
43
	protected $champs_table = array();
44
	private static $tri_multi_dimension = array();
45
	private static $tri_type = '';
46
 
47
	public function consulter($ressources, $parametres) {
236 delphine 48
		$this->ressources = $ressources;
49
		$this->parametres = $parametres;
50
		$this->chargerNomDuService();
3 jpm 51
 
236 delphine 52
		$this->traiterParametres();
53
		$this->traiterVersionProjet();
3 jpm 54
 
236 delphine 55
		$resultats = '';
56
		foreach ($this->table_version as $version) {
57
			$this->table = $version; //on stocke le nom de la table correspondant à la version du projet en cours
58
			$this->recupererNomChamp($this->table); //on récupère les noms des champs disponibles (Ds Commun.php)
59
			$this->traiterRessources(); //dans CommunNomsTaxons.php
60
			$requete = $this->assemblerLaRequete();
61
			$resultat = $this->getBdd()->recupererTous($requete);
62
			$versionResultat = $this->traiterResultat($resultat, $version, $requete);
63
			if (count($this->table_version) > 1) {
64
				$resultats[$version] = $versionResultat;
65
			} else {
66
				$resultats = $versionResultat;
3 jpm 67
			}
236 delphine 68
		}
3 jpm 69
 
70
		return $resultats;
71
	}
72
 
73
	private function chargerNomDuService() {
74
		$this->serviceNom = get_class($this);
75
	}
76
 
535 mathilde 77
	public function traiterResultat($resultat, $version) {
3 jpm 78
		$versionResultat = null;
79
		if ($resultat == '') {
80
			//cas ou la requete comporte des erreurs
81
			$message = 'La requête SQL formée comporte une erreur!';
82
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
83
			throw new Exception($message, $code);
84
		} elseif ($resultat) {
85
			$versionResultat = $this->retournerResultatFormate($resultat, $version);
86
		} else {
87
			$message = 'Les données recherchées sont introuvables.';
88
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
89
			throw new Exception($message, $code);
90
		}
91
		return $versionResultat;
92
	}
93
 
94
	//+------------------------------------------------------------------------------------------------------+
95
	// Méthodes concernant les paramètres
96
	/**
97
	 *  Permet de récupérer une liste des noms des champs de la table passée en paramètre
98
	 *  @param $table : Nom de la table dont on souhaite connaitre les champs
99
	 */
100
	public function recupererNomChamp($table) {
101
		$requete = 'SHOW FIELDS FROM '.$table;
102
		$resultat = $this->getBdd()->recupererTous($requete);
103
		if ($resultat == '') {
104
			$e = 'La requête SQL formée comporte une erreur!';
105
			$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e);
106
		} elseif ($resultat) {
107
			foreach ($resultat as $info) {
108
				$this->champs_table[] = $info['Field'];
109
			}
110
		} else {
111
			$m = "La table recherchée n'existe pas";
112
			$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $m);
113
		}
114
	}
115
 
116
	/**
117
	 * Fonction permettant de creer la table dont le nom est passé en paramètre (champs_api, champs_bdtfx,
118
	 * correspondance_champs...). Les données de chaque table sont présentes dans le fichier de configuration config.ini
119
	 * @param String $table : Peut contenir plusieurs nom de table dont on souhaite récupérer les données : table,table,table.
120
	 * 	Ex : recupererTableConfig('champs_api,champs_bdtfx')
121
	 */
122
	public function recupererTableConfig($table) {
123
		$tables = explode(',', $table);
124
		foreach ($tables as $tab) {
125
			$tableau = explode(',', Config::get($tab));
126
			$tableau = array_map('trim', $tableau);
127
			foreach ($tableau as $champ) {
128
				list($code, $rang) = explode('=', $champ);
129
				$tab_tampon[$code] = $rang;
130
			}
131
			$this->$tab = $tab_tampon;
132
			$tab_tampon = array();
133
		}
134
	}
135
 
136
	public function renvoyerErreur($entete, $message) {
137
		throw new Exception($message, $entete);
138
	}
139
 
140
	/**
141
	 * Permet de remplir la variable version_projet et de retirer cette donnée du tableau des ressources
142
	 * @param $ressources
143
	 */
144
	public function traiterVersionProjet() {
81 delphine 145
		if (isset($this->parametres['version.projet'])) {
92 jpm 146
			if (preg_match('/^[0-9]+(?:[._][0-9]+|)$/', $this->parametres['version.projet'])) {
81 delphine 147
				$this->version_projet = $this->parametres['version.projet'];
92 jpm 148
				$this->version_projet = 'v'.str_replace('.', '_', $this->version_projet);
149
			} else  {
150
				$this->version_projet = $this->parametres['version.projet'];
3 jpm 151
			}
152
		}
153
		//si la liste des noms est demandée pr toutes les versions, on affiche seulement la dernière version :
154
		if ($this->version_projet == '*' && $this->ressources == array()) {
92 jpm 155
			$message = "L'affichage de plusieurs versions ne fonctionne que pour les ressources de type /ressources/#id";
156
			$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
157
			throw new Exception($message, $code);
3 jpm 158
		}
159
		//on recupère les versions du projet disponible dans la table des meta-donnees (utilisation service MetaDonnees)
160
		$table_num_version = $this->recupererVersionDisponible();
161
		//on recupere la liste des noms des tables de la bdd correspondant aux differentes versions du projet en fct de la ou les versions demandées
162
		$this->recupererListeNomTablePrChaqueVersion($table_num_version);
163
	}
164
 
165
	/**
166
	 * Recupération des versions disponibles par appel du service metaDonnees
167
	 * Verification de l'existance du service recherché dans la requete (si précisé : hors *)
168
	 * @return array  : tableau contenant le numéro de chaque version disponible
169
	 */
170
	public function recupererVersionDisponible() {
171
		$versions_dispo = '';
172
		$req_version = 'SELECT version FROM '.Config::get('bdd_table_meta');
173
		$res_version = $this->getBdd()->recupererTous($req_version);
174
		if ($res_version == '') { //cas ou la requete comporte des erreurs
175
			$e = "La requête SQL de versionnage formée comporte une erreur : $req_version";
176
			$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e);
177
		} elseif ($res_version) {
178
			foreach ($res_version as $version) {
179
				$versions_dispo[] = $version['version'];
180
			}
181
		} else {
182
			$m = 'Versions introuvables dans la table des méta-données';
183
			$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $m);
184
		}
185
		return $versions_dispo;
186
	}
187
 
188
	public function recupererListeNomTablePrChaqueVersion($table_num_version) {
189
		switch ($this->serviceNom) {
190
			case 'Ontologies' :
191
				$prefixe_table = 'bdd_table_ontologies';
192
				break;
193
			default:
194
				$prefixe_table = 'bdd_table';
195
		}
196
		switch ($this->version_projet) {
197
			case '+' :
198
				$derniere_version = $table_num_version[count($table_num_version) - 1];
199
				$this->table_version[] = Config::get($prefixe_table).'_v'.str_replace('.', '_', $derniere_version);
200
				break;
201
			case '*' :
202
				foreach ($table_num_version as $num_version) {
203
					$this->table_version[] = Config::get($prefixe_table).'_v'.str_replace('.', '_', $num_version);
204
				}
205
				break;
206
			default  :
207
				$this->table_version[] = Config::get($prefixe_table).'_'.$this->version_projet;
208
				break;
209
		}
210
	}
211
 
212
	/**
213
	 * Est appelée pour former l'url complete des resultats precedants ou suivants.
214
	 * @param int : Permet de connaitre le nombre de noms obtenus par la requete
215
	 * @return string Retourne l'url complete des resultats precedents ou suivant sous la forme d'un tableau
216
	 */
217
	public function formulerUrl($nb_resultat, $id = null) {
218
		$url = array();
219
		$debut_url = Config::get('url_service').$id.'?';
220
		//on recré l'url sans les parametres de navigation qui seront rajouter ci-apres. On les enlève dc de la table des parametres
221
		foreach($this->parametres as $cle => $val) {
222
			$param_url[str_replace('_', '.', $cle)] = $val;
223
		}
224
 
225
		$this->recupererLesLimitesSuivantes($nb_resultat, $param_url);
226
		if (isset($param_url['navigation.depart']) && isset($param_url['navigation.limite'])) {
227
			$url['suivant'] = $debut_url.http_build_query($param_url);
228
		}
229
 
230
		$this->recupererLesLimitesPrecedentes($param_url);
231
		if (isset($param_url['navigation.depart']) && isset($param_url['navigation.limite'])) {
232
			$url['precedent'] = $debut_url.http_build_query($param_url);
233
		}
234
		return $url;
235
	}
236
 
237
	public function supprimerNavigation(&$param_url) {
238
		unset($param_url['navigation.depart']);
239
		unset($param_url['navigation.limite']);
240
	}
241
 
242
	/**
243
	 * Description :
244
	 * Permet de former les limites de la requete retournant les résultats suivants.
245
	 * Cette url sera afficher dans l'entete de la reponse retournée en format JSON (retour.format=defaut).
246
	 * @param int : $nb_resultat : Permet de connaitre le nombre de résultats obtenus par la requete
247
	 * @return string : la fin de l'url decrivant les limites des resultats suivants. Si aucun résultats ne suient,
248
	 * une chaine de caractère vide est retournée
249
	 */
250
	public function recupererLesLimitesSuivantes($nb_resultat, &$param_url_suiv) {
251
		$this->supprimerNavigation($param_url);
252
		$depart = $this->limite_requete['depart'];
253
		$limite = $this->limite_requete['limite'];
254
		$depart_suivant = $depart + $limite;
255
		$limite_suivant = $limite;
256
		if ($nb_resultat > $depart_suivant) {
257
			$param_url_suiv['navigation.depart'] = $depart_suivant;
258
			$param_url_suiv['navigation.limite'] = $limite_suivant;
259
		} else {
260
			$param_url_suiv['navigation.depart'] = null;
261
			$param_url_suiv['navigation.limite'] = null;
262
		}
263
	}
264
 
265
	/**
266
	 * Description :
267
	 * Permet de former les limites de la requete retournant les résultats precedents.
268
	 * Cette url sera afficher dans l'entete de la taxons/105reponse retournée en format JSON (retour.format=defaut)
269
	 * @return string : la fin de l'url decrivant les limites des resultats precedents.
270
	 * Si aucun résultats ne precedent, une chaine de caractère vide est retournée
271
	 */
272
	public function recupererLesLimitesPrecedentes(&$param_url) {
273
		$this->supprimerNavigation($param_url);
274
		$depart = $this->limite_requete['depart'];
275
		$limite = $this->limite_requete['limite'];
276
		if ($depart == 0) {
277
			$url_precedente = '';
278
		} else {
279
			if (($depart - $limite) < 0) {
280
				$depart_precedent = 0;
281
			} else {
282
				$depart_precedent = $depart - $limite;
283
			}
284
			$param_url['navigation.depart'] = $depart_precedent;
285
			$param_url['navigation.limite'] = $limite;
286
		}
287
	}
288
 
289
	public function ajouterHref($service, $val) {
290
		// http://tela-botanica.org/service:eflore:0.1/[projet]/[version_projet]/[service]/[ressource]:[valeur]
291
		if ($this->version_projet == '+') {
292
			$url = Config::get('url_service_base').Config::get('nom_projet').'/'.$service.'/'.$val;
293
		} else {
151 delphine 294
			$url = Config::get('url_service_base').Config::get('nom_projet').'/'.$service.'/'.$val.'?version.projet='.ltrim($this->version_projet, 'v');
3 jpm 295
		}
296
		return $url;
297
	}
298
 
299
	public function ajouterHrefAutreProjet($service, $ressource, $valeur, $projet = null, $param = null) {
300
		//on enleve les GA et Co, les meta ou les "_"
301
		$this->transliterer($service, $valeur);
302
		//on définit les nom des projets, des services et des ressources de l'url (dans les méta-donnees)
303
		$tab = array(
304
			'langue' 			  => array('service' => 'langues', 'projet' => 'iso-639-1', 'ressource' => ''),
305
			'couverture_spatiale' => array('service' => 'zone-geo', 'projet' => 'iso-3166-1', 'ressource' => ''),
265 jpm 306
			'type' 				  => array('service' => 'ontologies', 'projet' => 'eflore', 'ressource' => 'contactType:'),
307
			'datum' 			  => array('service' => 'ontologies', 'projet' => 'eflore', 'ressource' => 'datum:')
3 jpm 308
		);
309
		if (array_key_exists($service, $tab)) {
310
			extract($tab[$service]);
311
		} else {
312
			if (strpos(Config::get('nom_projet'), 'bd') === 0 && $projet == null) {
313
				$projet 		= 'bdnt';
314
				$service 		= 'ontologies';
315
				$ressource 		= '';
316
			}
317
		}
88 delphine 318
		$param = ($param) ? "?".$param : "";
3 jpm 319
		$url = Config::get('url_service_base').$projet.'/'.$service.'/'.$ressource.$valeur.$param;
320
		return $url;
321
	}
322
 
323
	/**Permet de consulter une url et retourne le résultat ou une erreur
324
	 * @param $url	 */
325
	public function consulterHref($url) {
326
		$res = $this->getRestClient()->consulter($url);
327
		$entete = $this->getRestClient()->getReponseEntetes();
328
		//Si le service meta-donnees fonctionne correctement, l'entete comprend la clé wrapper_data
329
		if (isset($entete['wrapper_data'])) {
330
			$res = json_decode($res);
331
			return $res;
332
		} else {
333
			$u = 'L\'url <a href="'.$url.'">'.$url.'</a> lancée via RestClient renvoie une erreur';
334
			$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $u);
335
		}
336
	}
337
 
338
	public function transliterer(&$service, &$val) {
339
		if (preg_match('/^.+:(.+)$/', $val, $match)) {
340
			$val = $match[1];
341
		}
342
		$service = str_replace(array('_Ga','_Co','_meta'), '', $service);
343
		if ($service == 'rang') {
344
			$ressource = 'rangTaxo';
345
		} elseif (preg_match('/^(statut)(?:_|-)([^_-]+)$/', $service, $match)) {
346
			$service = $match[1].ucfirst($match[2]);
347
		} elseif (strrpos($service, 'datum') !== false) {
348
			$service = 'datum';
349
		}
350
	}
351
 
352
	// prend en valeur la valeur de la recherche, les résultats approchés, le paramétre recherche
353
	// retourne le tableau trié en fonction de la ressemble entre le résultat approché et la valeur recherchée
354
	public function trierRechercheFloue($nom_demande, $tab_approchee, $nom) {
355
		$trie = '';
356
		$resultat = array();
357
		foreach ($tab_approchee as $id => $tab) {
358
			$nom_demande_ss = strtolower(Chaine::supprimerAccents($nom_demande));
359
			$nom_flou_ss = strtolower(Chaine::supprimerAccents($tab[$nom]));
360
			$stat = array();
361
			// Prime pour la ressemblance globale :
362
			$score = 500 - levenshtein($nom_flou_ss, $nom_demande_ss);
363
			// On affine
364
			$score = $score + (similar_text($nom_demande_ss, $nom_flou_ss) * 3);
365
			$stat['score'] = $score;
366
			foreach ($tab as $key => $valeur) {
367
				$stat[$key] = $valeur;
368
			}
369
			$resultat[] = $stat;
370
		}
371
 
372
 
373
		// Vérification que nous avons bien trouvé un nom approché
374
		if (count($resultat) > 0) {
375
			$trie = Tableau::trierMD($resultat, array('score' => SORT_DESC));
376
		}
377
		return $trie;
378
	}
379
 
380
	protected function recupererTableauConfig($param) {
381
		$tableau = array();
382
		$tableauPartiel = explode(',', Config::get($param));
383
		$tableauPartiel = array_map('trim', $tableauPartiel);
384
		foreach ($tableauPartiel as $champ) {
385
			if (strpos($champ, '=') === false) {
386
				$tableau[] = $champ;
387
			} else {
388
				list($cle, $val) = explode('=', $champ);
389
				$tableau[$cle] = $val;
390
			}
391
		}
392
		return $tableau;
393
	}
394
 
395
	//+------------------------------------------------------------------------------------------------------+
396
	// Méthodes d'accès aux objets du Framework
397
	/**
398
	 * Méthode de connection à la base de données sur demande.
399
	 * Tous les services web n'ont pas besoin de s'y connecter.
400
	 */
401
	protected function getBdd() {
402
		if (! isset($this->Bdd)) {
403
			$this->Bdd = new Bdd();
404
		}
405
		return $this->Bdd;
406
	}
407
 
408
	/**
409
	 * Méthode permettant de faire appel à un client REST en fonction des besoins du service.
410
	 */
411
	protected function getRestClient() {
412
		if (! isset($this->RestClient)) {
413
			$this->RestClient = new RestClient();
414
		}
415
		return $this->RestClient;
416
	}
417
}
418
?>