WebSVN – eFlore/Applications.del – Diff – /trunk/services/modules/0.1/images/ListeImages2.php


<?php
/**
 * @author		Raphaël Droz <raphael@tela-botanica.org>
 * @copyright	Copyright (c) 2013, Tela Botanica (accueil@tela-botanica.org)
 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
 * @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=ApiIdentiplante01Images
 *
 * Backend pour PictoFlora (del.html#page_recherche_images)
 *
 *
 * == Notes ==
 *
 * tri=votes et tri=tags: affectent le choix des images affichées (donc getIdImages())
 * Cependant ce total ne nous intéresse même pas (MoyenneVotePresenteur.java s'en occupe).
 * Seul tri=date_transmission nous évite l'AVG() + GROUP BY
 *
 * protocole: il affecte l'affichage des information, mais le JSON contient déjà
 * l'intégralité (chercher les données de vote pour 1 ou plusieurs protocoles) est quasi-identique.
 * Par contre, le tri par moyenne des votes, sous-entend "pour un protocole donné".
 * Dès lors le choix d'un protocole doit avoir été fait afin de régler le JOIN et ainsi l'ORDER BY.
 * (cf requestFilterParams())
 *
 * Histoire: auparavant (pré-r142x) un AVG + GROUP BY étaient utilisés pour générer on-the-fly les valeurs
 * utilisées ensuite pour l'ORDER BY. La situation à base de del_image_stat
 * est déjà bien meilleure sans être pour autant optimale. cf commentaire de sqlAddConstraint()
 *
 *
 * Tags:
 * Le comportement habituel dans le masque *général*: les mots sont séparés par des espaces,
 * implod()ed par des AND (tous les mots doivent matcher).
 * Et le test effectué doit matcher sur:
 * %(les tags d'observations)% *OU* %(les tags d'images)% *OU* %(les tags publics)%
 *
 * Le comportement habituel dans le masque *tag*: les mots ne sont *pas* splittés (1 seule expression),
 * Et le test effectué doit matcher sur:
 * ^(expression)% *OU* %(expression)% [cf getConditionsImages()]
 *
 * Par défaut les tags sont comma-separated (OU logique).
 * Cependant pour conserver le comportement du masque général qui sous-entend un ET logique sur
 * des tags séparés par des espaces recherche 
 *
 * TODO:
 * -affiner la gestion de passage de mots-clefs dans le masque général.
 * - subqueries dans le FROM pour les critère WHERE portant directement sur v_del_image
 * plutôt que dans WHERE (qui nécessite dès lors un FULL-JOIN)
 * (http://www.mysqlperformanceblog.com/2007/04/06/using-delayed-join-to-optimize-count-and-limit-queries/)
 * - éviter de dépendre d'une jointure systématique sur `cel_obs`, uniquement pour `(date_)transmission
 * (cf VIEW del_image)
 * - poursuivre la réorganisation des méthodes statiques parmis Observation, ListeObservations et ListeImages2
 * - *peut-être*: passer requestFilterParams() en méthode de classe
 *
 *
 * MySQL sux:
 * EXPLAIN SELECT  id_image FROM v_del_image vdi WHERE vdi.id_image IN (SELECT ce_image FROM del_image_tag WHERE actif = 1 LIMIT 1);
 *	MySQL doesn't yet support 'LIMIT & IN/ALL/ANY/SOME subquery
 * EXPLAIN SELECT * FROM del_image WHERE id_image IN (SELECT 3);
 *	PRIMARY
 * EXPLAIN SELECT * FROM del_image WHERE id_image IN (SELECT MIN(3));
 *	DEPENDENT SUBQUERY ... ... ... mwarf !
 * EXPLAIN SELECT  id_image FROM v_del_image vdi WHERE vdi.id_image IN (SELECT ce_image FROM del_image_tag WHERE actif = 1);
 *	5.5: MATERIALIZED		del_image_tag	ALL				ce_image NULL NULL NULL 38276 Using where
 *	5.1: DEPENDENT SUBQUERY	del_image_tag	index_subquery	ce_image ce_image 8 func 1 Using where
 * FORCE INDEX/IGNORE INDEX semble incapable de résoudre le problème de l'optimiseur MySQL
 *
 */
 
require_once(dirname(__FILE__) . '/../DelTk.php');
 
require_once(dirname(__FILE__) . '/../observations/Observation.php');
restore_error_handler();
restore_exception_handler();
error_reporting(E_ALL);
 
// del/services/0.1/images?navigation.depart=0&navigation.limite=12&tri=votes&ordre=desc
// del/services/0.1/images?navigation.depart=0&navigation.limite=12&tri=votes&ordre=desc&masque=plop
// del/services/0.1/images?navigation.depart=0&navigation.limite=12&tri=votes&ordre=desc&protocole=3
// del/services/0.1/images?navigation.depart=0&navigation.limite=12&tri=votes&ordre=desc&protocole=3&masque=plop
 
class ListeImages2 {
 
	// TODO: PHP-x.y, ces variables devrait être des "const"
	static $format_image_possible = array('O','CRX2S','CRS','CXS','CS','XS','S','M','L','XL','X2L','X3L');
 
	static $tri_possible = array('date_transmission', 'date_observation', 'votes', 'tags');
 
	// en plus de ceux dans DelTk
	static $parametres_autorises = array('protocole', 'masque.tag_cel', 'masque.tag_pictoflora', 'masque.milieu');
 
	static $default_params = array('navigation.depart' => 0, 'navigation.limite' => 10,
    'tri' => 'date_transmission', 'ordre' => 'desc',
    // spécifiques à PictoFlora:
    'format' => 'XL');
 
	static $default_proto = 3; // proto par défaut: capitalisation d'img (utilisé uniquement pour tri=(tags|votes))
 
	static $mappings = array(
		'observations' => array( // v_del_image
			"id_observation" => 1,
			"date_observation" => 1,
			"date_transmission" => 1, 
			"famille" => "determination.famille",
			"nom_sel" => "determination.ns",
			"nom_sel_nn" => "determination.nn",
			"nom_referentiel" => "determination.referentiel",
			"nt" => "determination.nt",
			"ce_zone_geo" => "id_zone_geo",
			"zone_geo" => 1,
			"lieudit" => 1,
			"station" => 1,
			"milieu" => 1,
			"mots_cles_texte" => "mots_cles_texte",
			"commentaire" => 1,
			"ce_utilisateur" => "auteur.id",
			"nom_utilisateur" => "auteur.nom",
			"prenom_utilisateur" => "auteur.prenom",
		),
		'images' => array( // v_del_image
			'id_image' => 1,
			// l'alias suivant est particulier: in-fine il doit s'appeler mots_cles_texte
			// mais nous afin d'éviter un conflit d'alias nous le renommons plus tard (reformateImagesDoubleIndex)
			'i_mots_cles_texte' => 1
		));
 
 
	public function __construct(Conteneur $conteneur = null) {
		$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
		$this->conteneur->chargerConfiguration('config_images.ini');
		$this->gestionBdd = $conteneur->getGestionBdd();
		$this->bdd = $this->gestionBdd->getBdd();	
	}
 
	public function consulter($ressources, $parametres) {
		/* Certes nous sélectionnons ici (nom|prenom|courriel)_utilisateur de cel_obs, mais il ne nous intéressent pas
		   Par contre, ci-dessous nous prenons i_(nom|prenom|courriel)_utilisateur.
		   Notons cependant qu'aucun moyen ne devrait permettre que i_*_utilisateur != *_utilisateur
		   Le propriétaire d'une obs et de l'image associée est *toujours* le même. */
		array_walk(self::$mappings['observations'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
		array_walk(self::$mappings['images'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
		// pour les votes, les mappings de "Observation" nous suffisent
		array_walk(Observation::$mappings['votes'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
 
		// la nécessité du 'groupby' dépend des 'join's utilisés (LEFT ou INNER) ainsi que de la cardinalité
		// de `ce_image` dans ces tables jointes.
		// Contrairement à IdentiPlantes, nous n'avons de HAVING pour PictoFlora, mais par contre un ORDER BY
		$req = array('select' => array(), 'join' => array(), 'where' => array(), 'groupby' => array(), 'orderby' => array());
 
 
		$db = $this->bdd;
 
		// filtrage de l'INPUT général, on réutilise 90% de identiplante en terme de paramètres autorisés
		// ($parametres_autorises) sauf... masque.type qui fait des modif' de WHERE sur les mots-clefs.
		// Évitons ce genre de chose pour PictoFlora et les risques de conflits avec masque.tag
		// même si ceux-ci sont improbables (pas d'<input> pour cela).
		$params_ip = DelTk::requestFilterParams($parametres,
        array_diff(DelTk::$parametres_autorises,
        array('masque.type')),
        $this->conteneur);
 
		// notre propre filtrage sur l'INPUT
		$params_pf = self::requestFilterParams($parametres,
        array_merge(DelTk::$parametres_autorises,
        self::$parametres_autorises));
 
		/* filtrage des tags + sémantique des valeurs multiples:
		   Lorsqu'on utilise masque.tag* pour chercher des tags, ils sont
		   postulés comme séparés par des virgule, et l'un au moins des tags doit matcher. */
		$params_pf['masque.tag_cel'] = DelTk::buildTagsAST(@$parametres['masque.tag_cel'], 'OR', ',');
		$params_pf['masque.tag_pictoflora'] = DelTk::buildTagsAST(@$parametres['masque.tag_pictoflora'], 'OR', ',');
 
		$params = array_merge(
            DelTk::$default_params, // paramètre par défaut Identiplante
            self::$default_params, // paramètres par défaut PictoFlora
            $params_ip, // les paramètres passés, traités par Identiplante
            $params_pf); // les paramètres passés, traités par PictoFlora
 
		// XXX: temp tweak
		/* $this->conteneur->setParametre('url_images', sprintf($this->conteneur->getParametre('url_images'),
		   "%09d", $params['format']));*/
 
		// création des contraintes (génériques de DelTk)
		DelTk::sqlAddConstraint($params, $db, $req);
 
 
		// création des contraintes spécifiques (sur les tags essentiellement)
		self::sqlAddConstraint($params, $db, $req, $this->conteneur);
		// création des contraintes spécifiques impliquées par le masque général
		self::sqlAddMasqueConstraint($params, $db, $req, $this->conteneur);
		// l'ORDER BY s'avére complexe
		self::sqlOrderBy($params, $db, $req);
 
		// 1) grunt-work: *la* requête de récupération des id valides (+ SQL_CALC_FOUND_ROWS)
		// $idobs_tab = ListeObservations::getIdObs($params, $req, $db);
		$idobs_tab = self::getIdImages($params, $req, $db);
 
		// Ce n'est pas la peine de continuer s'il n'y a pas eu de résultats dans la table del_obs_images
		if(!$idobs_tab) {
			$resultat = new ResultatService();
			$resultat->corps = array('entete' => DelTk::makeJSONHeader(0, $params, Config::get('url_service')),
            'resultats' => array());
			return $resultat;
			/*
              header('HTTP/1.0 404 Not Found');
              // don't die (phpunit)
              throw(new Exception()); */
		}
 
 
		// idobs est une liste (toujours ordonnée) des id d'observations recherchées
		$idobs = array_values(array_map(create_function('$a', 'return $a["id_image"];'), $idobs_tab));
		$total = $db->recuperer('SELECT FOUND_ROWS() AS c'); $total = intval($total['c']);
 
		$liaisons = self::chargerImages($db, $idobs);
 
		/* 
        // Q&D
        $images = array();
        $o = new Observation($this->conteneur);
        foreach($idobs as $i) {
        $images[$i] = $o->consulter(array($i), array('justthrow' => 1));
        }
		*/
		list($images, $images_keyed_by_id_image) = self::reformateImagesDoubleIndex(
			$liaisons,
			$this->conteneur->getParametre('url_images'),
			$params['format']);
 
 
		// on charge les votes pour ces images et pour *tous* les protocoles
		$votes = Observation::chargerVotesImage($db, $liaisons, NULL);
 
		// subtilité, nous passons ici le tableau d'images indexé par id_image qui est bien plus pratique pour
		// associer les vote à un tableau, puisque nous ne connaissons pas les id d'observation.
		// Mais magiquement (par référence), cela va remplir notre tableau indexé par couple d'id (id_image, id_observation)
		// cf reformateImagesDoubleIndex() à qui revient la tâche de créer ces deux versions simultanément lorsque
		// c'est encore possible.
		if($votes) Observation::mapVotesToImages($votes, $images_keyed_by_id_image);
 
		// les deux masques de tags sont transformés en AST dans le processus de construction de la requête.
		// Reprenous les paramètres originaux non-nettoyés (ils sont valables car le nettoyage est déterministe)
		$params_header = array_merge($params, array_filter(array('masque.tag_cel' => @$parametres['masque.tag_cel'],
        'masque.tag_pictoflora' => @$parametres['masque.tag_pictoflora'])));
		$resultat = new ResultatService();
		$resultat->corps = array('entete' => DelTk::makeJSONHeader($total, $params_header, Config::get('url_service')),
        'resultats' => $images);
		return $resultat;
	}
 
	/**
	 * TODO: partie spécifique liées à la complexité de PictoFlora:
	 * génération de la clause ORDER BY (génère la valeur de la clef orderby' de $req)
	 * nécessaire ? tableau sprintf(key (tri) => value (ordre), key => value ...).
	 * Cependant il est impensable de joindre sur un AVG() des valeurs des votes pour
	 * *chaque* couple (id_image, protocole) de la base afin de trouver les images
	 * les "mieux notées", ou bien les images ayant le "plus de tags" (COUNT())
	 */
	static function sqlOrderBy($p, $db, &$req) {
		// parmi self::$tri_possible
		if($p['tri'] == 'votes') { // LEFT JOIN sur "dis" ci-dessous
			$req['orderby'] = 'dis.moyenne ' . $p['ordre'] . ', dis.nb_votes ' . $p['ordre'];
			return;
		}
		
		if($p['tri'] == 'tags') { // LEFT JOIN sur "dis" ci-dessous
			$req['orderby'] = 'dis.nb_tags ' . $p['ordre'];
			return;
		}
 
		if($p['tri'] == 'date_observation') {
			$req['orderby'] = 'date_observation ' . $p['ordre'] . ', id_observation ' . $p['ordre'];
			return;
		}
 
		// tri == 'date_transmission'
		// avant cel:r1860, date_transmission pouvait être NULL
		// or nous voulons de la consistence (notamment pour phpunit)
		$req['orderby'] = 'date_transmission ' . $p['ordre'] . ', id_observation ' . $p['ordre'];
	}
 
	/*
	 * in $p: un tableau de paramètres, dont:
	 * - 'masque.tag_cel': *tableau* de mots-clefs à chercher parmi cel_image.mots_clefs_texte
	 * - 'masque.tag_pictoflora': *tableau* de mots-clefs à chercher parmi del_image_tag.tag_normalise
	 * - 'tag_explode_semantic': défini si les éléments sont tous recherchés ou NON
	 *
	 * in/ou: $req: un tableau de structure de requête MySQL
	 *
	 * Attention, le fait que nous cherchions masque.tag_cel OU/ET masque.tag_cel
	 * ne dépend pas de nous, mais du niveau supérieur de construction de la requête:
	 * Soit directement $this->consulter() si des masque.tag* sont passés
	 * (split sur ",", "AND" entre chaque condition, "OR" pour chaque valeur de tag)
	 * Soit via sqlAddMasqueConstraint():
	 * (pas de split, "OR" entre chaque condition) [ comportement historique ]
	 * équivalent à:
	 * (split sur " ", "OR" entre chaque condition, "AND" pour chaque valeur de tag)
	 *
	 */
	static function sqlAddConstraint($p, $db, &$req, Conteneur $c = NULL) {
		// TODO implement dans DelTk ?
		if(!empty($p['masque.milieu'])) {
			$req['where'][] = 'vdi.milieu LIKE '.$db->proteger('%' . $p['masque.milieu'].'%');
		}
 
 
		/* Pour le tri par AVG() des votes nous avons toujours un protocole donné,
		   celui-ci indique sur quels votes porte l'AVG.
		   (c'est un *vote* qui porte sur un protocole et non l'image elle-même) */
		/* TODO: perf problème:
		   1) SQL_CALC_FOUND_ROWS: fixable en:
           - dissociant le comptage de la récup d'id + javascript async
           - ou ne rafraîchir le total *que* pour les requête impliquant un changement de pagination
           (paramètre booléen "with-total" par exemple)
		   2) jointure forcées: en utilisant `del_imagè`, nous forçons les 2 premiers
           JOIN sur cel_obs_images et cel_obs pour filtrer sur "transmission".
           Dénormaliser cette valeur et l'intégrer à `cel_images` ferait économiser cette couteuse
           jointure, ... lorsqu'aucun masque portant sur `cel_obs` n'est utilisé
		   3) non-problème: l'ordre des joins est forcé par l'usage de la vue:
           (cel_images/cel_obs_images/cel_obs/del_image_stat)
           Cependant c'est à l'optimiseur de définir son ordre préféré. */
		if($p['tri'] == 'votes') {
			// $p['protocole'] *est* défini (cf requestFilterParams())
			// petite optimisation: INNER JOIN si ordre DESC car les 0 à la fin
			if($p['ordre'] == 'desc') {
				// pas de group by nécessaire pour cette jointure
				// PRIMARY KEY (`ce_image`, `ce_protocole`)
				$req['join'][] = sprintf('INNER JOIN del_image_stat dis'.
                ' ON vdi.id_image = dis.ce_image'.
                ' AND dis.ce_protocole = %d',
                $p['protocole']);
			} else {
				$req['join'][] = sprintf('LEFT JOIN del_image_stat dis'.
                ' ON vdi.id_image = dis.ce_image'.
                ' AND dis.ce_protocole = %d',
                $p['protocole']);
				// nécessaire (dup ce_image dans del_image_stat)
				$req['groupby'][] = 'vdi.id_observation';
			}
		}
 
		if($p['tri'] == 'tags') {
			$req['join'][] = sprintf('%s JOIN del_image_stat dis ON vdi.id_image = dis.ce_image',
            ($p['ordre'] == 'desc') ? 'INNER' : 'LEFT');
			// nécessaire (dup ce_image dans del_image_stat)
			$req['groupby'][] = 'vdi.id_observation';
		}
 
		// car il ne sont pas traités par la générique requestFilterParams() les clefs "masque.tag_*"
		// sont toujours présentes; bien que parfois NULL.
		if($p['masque.tag_cel']) {
			if(isset($p['masque.tag_cel']['AND'])) {
				// TODO: utiliser les tables de mots clefs normaliées dans tb_cel ?
				// et auquel cas laisser au client le choix du couteux "%" ?
				$tags = $p['masque.tag_cel']['AND'];
				array_walk($tags, create_function('&$val, $k, $db',
                '$val = sprintf("CONCAT(vdi.mots_cles_texte,vdi.i_mots_cles_texte) LIKE %s",
																  $db->proteger("%".$val."%"));'),
                $db);
				$req['where'][] = '(' . implode(' AND ', $tags) . ')';
			}
			else {
				$req['where'][] = sprintf("CONCAT(vdi.mots_cles_texte,vdi.i_mots_cles_texte) REGEXP %s",
                $db->proteger(implode('|', $p['masque.tag_cel']['OR'])));
			}
		}
 
 
		// XXX: utiliser tag plutôt que tag_normalise ?
		if($p['masque.tag_pictoflora']) {
			// pas de LEFT JOIN ? ou bien peut-être en cas de tri, mais nous parlons bien ici d'un masque
			/* $req['join'][] = 'LEFT JOIN del_image_tag dit ON dit.ce_image = vdi.id_image';
			   $req['where'][] = 'dit.actif = 1'; */
 
 
            // Note à propos des 4 "@ instruction" ci-dessous (notamment sur recupererTous())
            // REGEXP permet un puissant mécanisme de sélection des obs/image à qui sait
            // l'utiliser, mais peut sortir une erreur en cas de REGEXP invalide
            // ex: REGEX "^(".
            // Pour l'heure nous ignorons ce type d'erreur car aucun de nos champ de recherche
            // ne peuvent (ou ne devrait) comporter des meta-caractères
            // ([])?*+\\
 
 
			// ==== commenté pour l'instant pour cause de soucis d'optimiseur MySQL (cf commentaire en intro) ====
			/*
              if(isset($p['masque.tag_pictoflora']['AND'])) {
              // optimsation: en cas de "AND" on sort() l'input et le GROUP_CONCAT()
              // donc nous utilisons des ".*" plutôt que de multiples conditions et "|"
              sort($p['masque.tag_pictoflora']['AND']);
              $req['where'][] = sprintf("vdi.id_image IN (SELECT ce_image FROM del_image_tag WHERE actif = 1".
              " GROUP BY ce_image".
              " HAVING GROUP_CONCAT(tag_normalise ORDER BY tag_normalise) REGEXP %s)",
              $db->proteger(implode('.*', $p['masque.tag_pictoflora']['AND'])));
              }
              else {
              $req['where'][] = sprintf("vdi.id_image IN (SELECT ce_image FROM del_image_tag WHERE actif = 1".
              " GROUP BY ce_image".
              " HAVING GROUP_CONCAT(tag_normalise) REGEXP %s)",
              $db->proteger(implode('|', $p['masque.tag_pictoflora']['OR'])));
              }
			*/
 
			// ==== XXX: puisque on est bassiné par cette "DEPENDENT SUBQUERY", nous la faisons donc indépendemment ====
			if(isset($p['masque.tag_pictoflora']['AND'])) {
				// optimsation: en cas de "AND" on sort() l'input et le GROUP_CONCAT()
				// donc nous utilisons des ".*" plutôt que de multiples conditions et "|"
				sort($p['masque.tag_pictoflora']['AND']);
 
				// plutôt que db->connexion->query->fetchColumn(), une API pourrie nous oblige à ...
				$ids = @$db->recupererTous(sprintf(
					"SELECT ce_image FROM del_image_tag WHERE actif = 1".
					" GROUP BY ce_image".
					" HAVING GROUP_CONCAT(tag_normalise ORDER BY tag_normalise) REGEXP %s",
					$db->proteger(implode('.*', $p['masque.tag_pictoflora']['AND']))));
 
				// puis:
				$ids = @array_map(create_function('$e', 'return $e["ce_image"];'), $ids);
				if($ids) $req['where'][] = sprintf("vdi.id_image IN (%s)", implode(',', $ids));
 
			}
			else {
				$ids = @$db->recupererTous(sprintf(
					"SELECT ce_image FROM del_image_tag WHERE actif = 1".
					" GROUP BY ce_image".
					" HAVING GROUP_CONCAT(tag_normalise) REGEXP %s",
					$db->proteger(implode('|', $p['masque.tag_pictoflora']['OR']))));
 
				$ids = @array_map(create_function('$e', 'return $e["ce_image"];'), $ids);
				if($ids) $req['where'][] = sprintf("vdi.id_image IN (%s)", implode(',', $ids));
			}
 
		}
	}
 
 
	static function getIdImages($p, $req, $db) {
		return $db->recupererTous(sprintf(
			'SELECT SQL_CALC_FOUND_ROWS id_image' .
			' FROM v_del_image vdi'.
			' %s' . // LEFT JOIN if any
			' WHERE %s'. // where-clause ou TRUE
			' %s'. // group-by
			' ORDER BY %s'.
			' LIMIT %d, %d -- %s',
						 
			$req['join'] ? implode(' ', array_unique($req['join'])) : '',
			$req['where'] ? implode(' AND ', $req['where']) : 'TRUE',
			
			$req['groupby'] ? ('GROUP BY ' . implode(', ', array_unique($req['groupby']))) : '',
			
			$req['orderby'],
			
			$p['navigation.depart'], $p['navigation.limite'], __FILE__ . ':' . __LINE__));
 
	}
 
	static function chargerImages($db, $idImg) {
		$obs_fields = DelTk::sqlFieldsToAlias(self::$mappings['observations'], NULL);
		$image_fields = DelTk::sqlFieldsToAlias(self::$mappings['images'], NULL);
	
		return $db->recupererTous(sprintf('SELECT '.
        ' CONCAT(id_image, "-", id_observation) AS jsonindex,'.
        ' %1$s, %2$s FROM v_del_image '.
        ' WHERE %3$s'.
        ' -- %4$s',
        $obs_fields, $image_fields,
        sprintf('id_image IN (%s)', implode(',', $idImg)),
        __FILE__ . ':' . __LINE__));
 
	}
 
	/* "masque" ne fait jamais que faire une requête sur la plupart des champs, (presque) tous traités
	   de manière identique à la seule différence que:
	   1) ils sont combinés par des "OU" logiques plutôt que des "ET".
	   2) les tags sont traités différemment pour conserver la compatibilité avec l'utilisation historique:
       Tous les mots-clefs doivent matcher et sont séparés par des espaces
       (dit autrement, str_replace(" ", ".*", $mots-clefs-requête) =~ $mots-clefs-mysql)
	   Pour plus d'information: (ListeObservations|DelTk)::sqlAddMasqueConstraint() */
	static function sqlAddMasqueConstraint($p, $db, &$req, Conteneur $c = NULL) {
		if(!empty($p['masque'])) {
			$or_params = array('masque.auteur' => $p['masque'],
            'masque.departement' => $p['masque'],
            'masque.commune' => $p['masque'], // TODO/XXX ?
            'masque.id_zone_geo' => $p['masque'],
 
            /* tous-deux remplacent masque.tag
               mais sont traité séparément des requestFilterParams() */
            // 'masque.tag_cel' => $p['masque'],
            // 'masque.tag_pictoflora' => $p['masque'],
 
            'masque.ns' => $p['masque'],
            'masque.famille' => $p['masque'],
            'masque.date' => $p['masque'],
            'masque.genre' => $p['masque'],
            'masque.milieu' => $p['masque'],
 
            // tri est aussi nécessaire car affecte les contraintes de JOIN
            'tri' => $p['tri'],
            'ordre' => $p['ordre']);
 
			$or_masque = array_merge(
				DelTk::requestFilterParams($or_params, NULL, $c /* pour masque.departement */),
				self::requestFilterParams($or_params));
 
			/* Lorsqu'on utilise le masque général pour chercher des tags, ils sont
			   postulés comme séparés par des espaces, et doivent être tous matchés. */
			$or_masque['masque.tag_cel'] = DelTk::buildTagsAST($p['masque'], 'AND', ' ');
			$or_masque['masque.tag_pictoflora'] = DelTk::buildTagsAST($p['masque'], 'AND', ' ');
 
 
			// pas de select, groupby & co ici: uniquement 'join' et 'where'
			$or_req = array('join' => array(), 'where' => array());
			DelTk::sqlAddConstraint($or_masque, $db, $or_req);
 
			self::sqlAddConstraint($or_masque, $db, $or_req);
 
			if($or_req['where']) {
				$req['where'][] = '(' . implode(' OR ', $or_req['where']) . ')';
				// utile au cas ou des jointures seraient rajoutées
				$req['join'] = array_unique(array_merge($req['join'], $or_req['join']));
			}
		}
	}
 
 
	// cf Observation::reformateObservationSimpleIndex() et ListeObservations::reformateObservation()
    // (trop de variétés de formatage, à unifier côté client pour unifier côté backend ...)
	static function reformateImagesDoubleIndex($obs, $url_pattern = '', $image_format = 'XL') {
		// XXX: cf Observation.php::consulter(), nous pourriouns ici
		// conserver les valeurs vides (pour les phptests notamment, ou non)
		// $obs = array_map('array_filter', $obs);
		$obs_merged = $obs_keyed_by_id_image = array();
		foreach($obs as $o) {
			// ceci nous complique la tâche pour le reste du processing...
			$id = $o['jsonindex'];
			// ainsi nous utilisons deux tableaux: le final, indexé par couple d'id(image-obs)
			// et celui indexé par simple id_image qui est fort utile pour mapVotesToImages()
			// mais tout deux partage leur référence à "protocole"
			$image = array(
				'id_image' => $o['id_image'],
				'binaire.href' => sprintf($url_pattern, $o['id_image'], $image_format),
				'mots_cles_texte' => @$o['i_mots_cles_texte'], // @, peut avoir été filtré par array_map() ci-dessus
			);
			unset($o['id_image'], $o['i_mots_cles_texte'], $o['jsonindex']);
			if(!isset($obs_merged[$id])) $obs_merged[$id] = $image;
			$obs_merged[$id]['observation'] = $o;
			$obs_merged[$id]['protocoles_votes'] = array();
			
			$obs_keyed_by_id_image[$image['id_image']]['protocoles_votes'] = &$obs_merged[$id]['protocoles_votes'];
		}
 
		return array($obs_merged,$obs_keyed_by_id_image);
	}
 
 
 
	// complete & override DelTk::requestFilterParams() (même usage)
	static function requestFilterParams(Array $params, $parametres_autorises = NULL) {
		if($parametres_autorises) { // filtrage de toute clef inconnue
			$params = array_intersect_key($params, array_flip($parametres_autorises));
		}
 
		$p = array();
		$p['tri'] = DelTk::unsetIfInvalid($params, 'tri', self::$tri_possible);
		$p['format'] = DelTk::unsetIfInvalid($params, 'format', self::$format_image_possible);
 
		// "milieu" inutile pour IdentiPlantes ?
		if(isset($params['masque.milieu'])) $p['masque.milieu'] = trim($params['masque.milieu']);
 
		// compatibilité
		if(isset($params['masque.tag'])) {
			$params['masque.tag_cel'] = $params['masque.tag_pictoflora'] = $params['masque.tag'];
		}
 
		if($p['tri'] == 'votes' || $p['tri'] == 'tags') {
			// ces critère de tri des image à privilégier ne s'applique qu'à un protocole donné
			if(!isset($params['protocole']) || !is_numeric($params['protocole']))
				$p['protocole'] = self::$default_proto;
			else
				$p['protocole'] = intval($params['protocole']);
		}
 
		return array_filter($p, create_function('$a','return !in_array($a, array("",false,null),true);'));
	}
 
 
 
	// met à jour *toutes* les stats de nombre de tags et de moyenne des votes
	static function _update_statistics($db) {
		$db->requeter("TRUNCATE TABLE del_image_stat");
		$db->requeter(<<<EOF
INSERT INTO `del_image_stat` (
	SELECT id_image, divo.ce_protocole, divo.moyenne, divo.nb_votes, dit.ctags 
	FROM `tb_cel`.`cel_images` ci 
	LEFT JOIN 
	( SELECT ce_image, ce_protocole, AVG(valeur) AS moyenne, COUNT(valeur) AS nb_votes FROM del_image_vote 
	  GROUP BY ce_image, ce_protocole ) AS divo
	ON ci.id_image = divo.ce_image 
	LEFT JOIN 
	( SELECT ce_image, COUNT(id_tag) as ctags FROM del_image_tag 
	  GROUP BY ce_image ) AS dit 
	ON ci.id_image = dit.ce_image )
EOF
		);
	}
 
	static function revOrderBy($orderby) {
		return $orderby == 'asc' ? 'desc' : 'asc';
	}
}
Subversion Repositories eFlore/Applications.del

(root)/trunk/services/modules/0.1/images/ListeImages2.php – Rev 1491 → 1492
