Subversion Repositories eFlore/Projets.eflore-projets

Rev

Rev 856 | Rev 859 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 856 Rev 858
Line 14... Line 14...
14 
 *
 14 
 *
15 
 * TODO: masque.titre => masque.tag
 15 
 * TODO: masque.titre => masque.tag
16 
 *
 16 
 *
17 
 */
 17 
 */
Line -... Line 18...
- 
 
 18 
 
- 
 
 19 
// affecte le nombre d'ids autorisés dans le dernier segment d'URL
- 
 
 20 
// *et* la valeur maximale autorisée pour navigation.limite.
- 
 
 21 
define('_COSTE_TEXTE_MAX_RESULT_LIMIT', 500);
18 
 
 22 
 
19 
/*restore_error_handler();
 23 
/*restore_error_handler();
20 
  error_reporting(E_ALL);*/
 24 
  error_reporting(E_ALL);*/
21 
class Textes {
 25 
class Textes {
22 
	// paramètres autorisés
 26 
	// paramètres autorisés
Line 101... Line 105...
101 
		// en cas d'accès phpunit
 105 
		// en cas d'accès phpunit
102 
		else {
 106 
		else {
103 
			$uri = $ressources;
 107 
			$uri = $ressources;
104 
		}
 108 
		}
Line 105... Line -...
105 
 
 - 
 
106 
		if(is_null($parametres)) $parametres = Array();
 - 
 
107 
		$params = self::requestFilterParams($parametres);
 - 
 
108 
 
 109 
 
109 
		// renvoie du plain/text d'aide (cf fin de programme)
 110 
		// renvoie du plain/text d'aide (cf fin de programme)
110 
		if(count($uri) == 1 && $uri[0] == 'aide') return self::aide();
 - 
 
111
- 
 
112 
		$id = 0;
 - 
 
113 
		// getNN renvoie le num_nom passé comme segment d'URI
 - 
 
114 
		// ou bien l'extrait du pattern bdtfx.nn:#id
 - 
 
Line 115... Line 111...
115 
		if(count($uri) == 1) $id = self::getNN($uri[0]);
 111 
		if(count($uri) == 1 && $uri[0] == 'aide') return self::aide();
116 
 
 112 
 
117 
 
 113 
 
118 
		// en cas d'échec (id invalide), bail-out
 114 
		if(is_null($parametres)) $parametres = Array();
119 
		// note: NULL is ok, mais FALSE est le retour de getNN()
 115 
		$params = self::requestFilterParams($parametres);
120 
		if($id === FALSE || count($uri) > 1) {
 116 
		// les contraintes liées aux ids (passés comme composants d'URL)
- 
 
 117 
		// sont ajoutées aux params [sans être accepté comme paramètre d'URL]
- 
 
 118 
		$params['_ids'] = self::requestFilterIds($uri);
- 
 
 119 
 
Line 121... Line -...
121 
			// http_response_code(500);
 - 
 
122 
			throw new Exception('not supported', 500);
 - 
 
123 
		}
 - 
 
124 
 
 - 
 
125 
		// XXX: temporaires, pour chopper $db dans l'instance
 - 
 
126 
		// (non disponibles dans nos helpers statics)
 120 
		// XXX: temporaires, passage de $db aux fonctions
127 
		$GLOBALS[__FILE__] = $db;
 121 
		// de toolkits
128 
		$req = self::getCosteInfo($params, $id);
 122 
		$req = self::getCosteInfo($params, $db);
129 
		unset($GLOBALS[__FILE__]);
 123 
 
130 
		$res = $db->recupererTous($req);
 124 
		$res = $db->recupererTous($req);
Line 162... Line 156...
162 
	}
 156 
	}
Line 163... Line 157...
163 
 
 157 
 
164 
 
 158 
 
165 
	// la fonction central: récupère les infos à partir de paramètres
 159 
	// la fonction central: récupère les infos à partir de paramètres
166 
	// et une optionnel contrainte de num_nom
 - 
 
167 
	static function getCosteInfo(array $params, $id = NULL) {
 - 
 
168 
		assert('is_int($id)');
 160 
	// et une optionnel contrainte de num_nom
169 
 
 161 
	static function getCosteInfo(array $params, $db) {
170 
		// contraintes (WHERE):
 162 
		// contraintes (WHERE):
171 
		$constraints = self::sqlAddConstraint($params);
 - 
 
172 
		// ajout de la contrainte sur num_nom si un composant d'URL supplémentaire
 - 
 
173 
		// comportant un #id existe
 - 
 
Line 174... Line 163...
174 
		if($id) array_unshift($constraints, "c.num_nom = $id");
 163 
		$constraints = self::sqlAddConstraint($params, $db);
175 
 
 164 
		// XXX: que faire en l'absence de contrainte ? pour l'instant : "WHERE 1"
176 
 
 165 
 
Line 209... Line 198...
209 
 
 198 
 
210 
	// SQL helpers
 199 
	// SQL helpers
211 
	// le préfix de coste_v2_00 est "c"
 200 
	// le préfix de coste_v2_00 est "c"
212 
	// le préfix de florecoste_pages sur la description est est "dsc"
 201 
	// le préfix de florecoste_pages sur la description est est "dsc"
213 
	// le préfix de florecoste_pages sur la clef de détermination est est "cle"
 202 
	// le préfix de florecoste_pages sur la clef de détermination est est "cle"
214 
	static function sqlAddConstraint($params) {
 - 
 
215 
		$q = $GLOBALS[__FILE__];
 - 
 
216 
 
 203 
	static function sqlAddConstraint($params, $db) {
217 
		$stack = array();
 204 
		$stack = array();
218 
		if(!empty($params['masque.ns'])) {
 205 
		if(!empty($params['masque.ns'])) {
219 
			if($params['recherche'] == 'etendue')
 206 
			if($params['recherche'] == 'etendue')
220 
				$stack[] = 'c.nom_sci LIKE ' . $q->proteger('%' . trim($params['masque.ns']) . '%');
 207 
				$stack[] = 'c.nom_sci LIKE ' . $db->proteger('%' . trim($params['masque.ns']) . '%');
221 
			elseif($params['recherche'] == 'floue')
 208 
			elseif($params['recherche'] == 'floue')
222 
				$stack[] = sprintf(self::$soundex_scheme,
 209 
				$stack[] = sprintf(self::$soundex_scheme,
223 
								   'c.nom_sci',
 210 
								   'c.nom_sci',
224 
								   $q->proteger('%' . trim($params['masque.ns']) . '%'));
 211 
								   $db->proteger('%' . trim($params['masque.ns']) . '%'));
225 
			else
 212 
			else
226 
				$stack[] = 'c.nom_sci = ' . $q->proteger(trim($params['masque.ns']));
 213 
				$stack[] = 'c.nom_sci = ' . $db->proteger(trim($params['masque.ns']));
Line 227... Line 214...
227 
		}
 214 
		}
228 
 
 215 
 
229 
		// le masque sur texte est toujours un LIKE() "étendue", sauf si "floue" spécifié
 216 
		// le masque sur texte est toujours un LIKE() "étendue", sauf si "floue" spécifié
230 
		if(!empty($params['masque.txt'])) {
 217 
		if(!empty($params['masque.txt'])) {
231 
			if($params['recherche'] == 'floue') {
 218 
			if($params['recherche'] == 'floue') {
232 
				$stack[] = sprintf(self::$soundex_scheme,
 219 
				$stack[] = sprintf(self::$soundex_scheme,
233 
								   'dsc.body',
 220 
								   'dsc.body',
234 
								   $q->proteger('%' . trim($params['masque.txt']) . '%'));
 221 
								   $db->proteger('%' . trim($params['masque.txt']) . '%'));
235 
			}
 222 
			}
236 
			else {
 223 
			else {
237 
				$stack[] = 'dsc.body LIKE ' . $q->proteger('%' . trim($params['masque.txt']) . '%');
 224 
				$stack[] = 'dsc.body LIKE ' . $db->proteger('%' . trim($params['masque.txt']) . '%');
Line 238... Line 225...
238 
			}
 225 
			}
239 
		}
 226 
		}
240 
 
 227 
 
241 
		if(!empty($params['masque.titre'])) {
 228 
		if(!empty($params['masque.titre'])) {
242 
			if($params['recherche'] == 'stricte') {
 229 
			if($params['recherche'] == 'stricte') {
243 
				$stack[] = sprintf('(dsc.tag = %1$s OR cle.tag = %1$s)',
 230 
				$stack[] = sprintf('(dsc.tag = %1$s OR cle.tag = %1$s)',
244 
								   $q->proteger(trim($params['masque.titre'])));
 231 
								   $db->proteger(trim($params['masque.titre'])));
245 
			}
 232 
			}
246 
			else {
 233 
			else {
247 
				$stack[] = sprintf('(dsc.tag LIKE %1$s OR cle.tag LIKE %1$s)',
 234 
				$stack[] = sprintf('(dsc.tag LIKE %1$s OR cle.tag LIKE %1$s)',
Line 248... Line 235...
248 
								   $q->proteger('%' .  trim($params['masque.titre']) . '%'));
 235 
								   $db->proteger('%' .  trim($params['masque.titre']) . '%'));
249 
			}
 236 
			}
250 
		}
 237 
		}
Line 251... Line 238...
251 
 
 238 
 
252 
		if(array_key_exists('masque.famille', $params)) {
 239 
		if(array_key_exists('masque.famille', $params)) {
253 
			$stack[] = 'b.famille LIKE ' . $q->proteger(trim($params['masque.famille']));
 240 
			$stack[] = 'b.famille LIKE ' . $db->proteger(trim($params['masque.famille']));
Line 254... Line 241...
254 
		}
 241 
		}
255 
 
 242 
 
256 
		if(array_key_exists('masque.page', $params)) {
 243 
		if(array_key_exists('masque.page', $params)) {
Line -... Line 244...
- 
 
 244 
			$stack[] = 'c.page = ' . intval($params['masque.page']);
- 
 
 245 
		}
- 
 
 246 
 
- 
 
 247 
		if(array_key_exists('masque.tome', $params)) {
- 
 
 248 
			$stack[] = 'c.tome = ' . intval($params['masque.tome']);
- 
 
 249 
		}
257 
			$stack[] = 'c.page = ' . intval($params['masque.page']);
 250 
 
258 
		}
 251 
		// ajout de la contrainte sur num_nom si un composant d'URL supplémentaire
Line 259... Line 252...
259 
 
 252 
		// comportant un #id existe, cf self::requestFilterIds()
Line 348... Line 341...
348 
		// renvoie FALSE ou NULL si absent ou invalide
 341 
		// renvoie FALSE ou NULL si absent ou invalide
349 
		$p['navigation.limite'] = filter_var(@$params['navigation.limite'],
 342 
		$p['navigation.limite'] = filter_var(@$params['navigation.limite'],
350 
												  FILTER_VALIDATE_INT,
 343 
												  FILTER_VALIDATE_INT,
351 
												  array('options' => array('default' => NULL,
 344 
												  array('options' => array('default' => NULL,
352 
																		   'min_range' => 1,
 345 
																		   'min_range' => 1,
353 
																		   'max_range' => 500)));
 346 
																		   'max_range' => _COSTE_TEXTE_MAX_RESULT_LIMIT)));
354 
		$p['navigation.depart'] = filter_var(@$params['navigation.depart'],
 347 
		$p['navigation.depart'] = filter_var(@$params['navigation.depart'],
355 
												  FILTER_VALIDATE_INT,
 348 
												  FILTER_VALIDATE_INT,
356 
												  array('options' => array('default' => NULL,
 349 
												  array('options' => array('default' => NULL,
357 
																		   'min_range' => 0,
 350 
																		   'min_range' => 0,
358 
																		   'max_range' => 10000))); // count(1) from coste_v2_00
 351 
																		   'max_range' => 10000))); // count(1) from coste_v2_00
Line 363... Line 356...
363 
		$p = array_merge(self::$default_params, $p);
 356 
		$p = array_merge(self::$default_params, $p);
Line 364... Line 357...
364 
 
 357 
 
365 
		return $p;
 358 
		return $p;
Line -... Line 359...
- 
 
 359 
	}
- 
 
 360 
 
- 
 
 361 
	static function requestFilterIds($uri) {
- 
 
 362 
		if(count($uri) != 1) return NULL;
- 
 
 363 
 
- 
 
 364 
		// getNN renvoie le num_nom passé comme segment d'URI
- 
 
 365 
		// ou bien l'extrait du pattern bdtfx.nn:(#id)
- 
 
 366 
		$ids = array_filter(array_map(array(__CLASS__, 'getNN'), explode(',', $uri[0])));
- 
 
 367 
 
- 
 
 368 
		// en cas d'échec (tous les id sont invalides), bail-out
- 
 
 369 
		if(!$ids) {
- 
 
 370 
			// http_response_code(500);
- 
 
 371 
			throw new Exception('not supported', 500);
- 
 
 372 
		}
- 
 
 373 
 
- 
 
 374 
		return array_slice($ids, 0, _COSTE_TEXTE_MAX_RESULT_LIMIT);
366 
	}
 375 
	}
367 
 
 376 
 
368 
	static function aide() {
 377 
	static function aide() {
369 
		header("Content-Type: text/plain; charset=utf-8");
 378 
		header("Content-Type: text/plain; charset=utf-8");
370 
		return sprintf("
 379 
		return sprintf("
371 
Service coste/textes:
 380 
Service coste/textes:
Line 372... Line 381...
372 
Retourne des informations (choisies) à propos d'un taxon donné (à partir de son numéro nomenclatural
 381 
Retourne des informations (choisies) à propos d'un taxon donné (à partir de son numéro nomenclatural
373 
Retourne des informations (choisies) à propos de taxons recherchés (à partir de divers critères)
 382 
Retourne des informations (choisies) à propos de taxons recherchés (à partir de divers critères)
374 
 
 383 
 
375 
Usage:
 - 
 
376 
			coste/textes/bdtfx.nn:#id?<params>
 384 
Usage:
377 
			coste/textes/#id?<params>
 385 
			coste/textes/<liste-num_nom>?<params>
378 
			coste/textes?<params>
 386 
* <liste-num_nom> étant une liste de numéros nomenclaturaux de taxons bdtfx séparés par des virgules
379 
* #id étant un numéro nomenclatural d'un taxon bdtfx
 387 
  au format <#id> ou <bdtfx.nn:#id>
380 
* retour.champs une liste de champs séparés par des virgules parmi *,%s
 388 
* retour.champs une liste de champs séparés par des virgules parmi *,%s
381 
* les paramètres acceptés sont les suivants: %s
 389 
* les paramètres acceptés sont les suivants: %s