WebSVN – eFlore/Applications.cel – Diff – /trunk/jrest/bibliotheque/GestionChampsEtendus.php


<?php
// declare(encoding='UTF-8');
/**
 * Classe de gestion de l'ajout, modification et suppression des champs supplémentaires des obs et images.
 *
 * @internal   Mininum PHP version : 5.2
 * @category   CEL
 * @package    Services
 * @subpackage Bibliothèques
 * @version    0.1
 * @author     Mathias CHOUET <mathias@tela-botanica.org>
 * @author     Raphaël Droz <raphael@tela-botania.org>
 * @author     Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @author     Aurelien PERONNET <aurelien@tela-botanica.org>
 * @license    GPL v3 <http://www.gnu.org/licenses/gpl.txt>
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
 */
class GestionChampsEtendus extends Cel {
 
	private $mode = null;
	private $table_obs_etendus = null;
	private $champ_id = null;
 
	public function __construct($config, $mode = 'obs') {
		parent::__construct($config);
		$this->mode = $mode;
		$this->table_obs_etendus = 'extended_field_occurrence';
		$this->champ_id = 'occurrence_id';
		
	}
 
	/**
	* Renvoie true ou false suivant que l'element indiqué possède une valeur
	* pour la clé indiquée
	*
	* @param int $id_element_lie
	* @param string $cle
	* @param string $valeur
	* @return bool
	*/
	public function existe($id_element_lie, $cle) {
		$id = Cel::db()->proteger($id_element_lie);
		$cle = Cel::db()->proteger($cle);
		$requete = 'SELECT COUNT(*) >= 1 AS existe '.
			"FROM {$this->table_obs_etendus} ".
			"WHERE {$this->champ_id} = $id ".
			"	AND extended_field_id = $cle ".
			' -- '.__FILE__.':'.__LINE__;;
 
		$resultat = Cel::db()->requeter($requete);
		return ($resultat[0]['existe'] == '1');
	}
 
	/**
	* Renvoie tous les champs étendus associé à l'élément passé en paramètre
	*
	* @param int $id_element_lie
	* @return array tableau associatif des champs de la table etendu
	*/
	public function consulter($id_element_lie) {
		$id = Cel::db()->proteger($id_element_lie);
		$requete = 'SELECT * '.
			"FROM {$this->table_obs_etendus} ".
			"WHERE {$this->champ_id} = $id ".
			' -- '.__FILE__.':'.__LINE__;
		$resultat = Cel::db()->requeter($requete);
		return $resultat;
	}
 
	/**
	* Renvoie tous les champs étendus associés aux éléments passés en paramètre.
	* Retour sous forme de tableau associatif de tableau d'objets ChampEtendu.
	* Les objets ChampEtendu sont regroupés par id d'élement.
	*
	* @param array $ids_element_lies tableau d'id des éléments liés (obs ou image).
	* @return array tableau associatif de tableau d'objets ChampEtendu.
	*/
	public function consulterParLots(Array $ids_element_lies) {
		$champs_etendus_par_element = array();
		if (!empty($ids_element_lies)) {
			$ids_element_lies = array_map(array(Cel::db(), 'proteger'),$ids_element_lies);
			$ids = implode(',', $ids_element_lies);
 
			$requete = "SELECT occurrence_id, occurrence_id as id_observation, value as valeur, `field_id`as cle FROM {$this->table_obs_etendus} o join extended_field f
			     on f.`id` =  extended_field_id WHERE {$this->champ_id} IN ($ids) ";
			$resultats = Cel::db()->requeter($requete);
			
			foreach ($resultats as &$ligne) {
				$id_element = $ligne[$this->champ_id];
				if (!isset($champs_etendus_par_element[$id_element])) {
					$champs_etendus_par_element[$id_element] = array();
				}
				$champ_etendu = new ObsEtendue();
				$champ_etendu->id = $id_element;
				$champ_etendu->cle = $ligne['cle'];
				$champ_etendu->valeur = $ligne['valeur'];
 
				$champs_etendus_par_element[$id_element][] = $champ_etendu;
			}
		}
		return $champs_etendus_par_element;
	}
 
	/**
	 * Ajoute un champ étendu.
	 * Si la clé existe déjà, seule valeur du champ est mise à jour
	 *
	 * @param ChampEtendu $champ_etendu
	 * @return bool true si l'ajout a eu lieu
	 */
	public function ajouter(ChampEtendu $champ_etendu) {
		$id = Cel::db()->proteger($champ_etendu->id);
		$cle = Cel::db()->proteger($champ_etendu->cle);
		$valeur = Cel::db()->proteger($champ_etendu->valeur);
 
		$requete = "INSERT INTO {$this->table_obs_etendus} ".
			"( {$this->champ_id}, extended_field_id, value) ".
			"VALUES ($id, $cle, $valeur) ".
			"ON DUPLICATE KEY UPDATE value = VALUES(value) ".
			' -- '.__FILE__.':'.__LINE__;
 
		// la partie on duplicate key est spécifique mysql mais il sera facile de s'en passer le jour
		// où l'on change de sgbd
		$ajout = Cel::db()->executer($requete);
		return ($ajout !== false);
	}
 
	/**
	 * Ajoute plusieurs champs étendus à la fois.
	 * Si la clé existe déjà, seule la valeur du champ est mise à jour
	 *
	 * @param array $champs_etendus tableau d'objets ChampEtendu
	 * @return bool true si l'ajout a eu lieu
	 */
	public function ajouterParLots(Array $champs_etendus) {
		if (! $champs_etendus) return TRUE; // le tableau ... vide à été inséré
 
		$lignes = array();
		foreach ($champs_etendus as $champ_etendu) {
			$id = Cel::db()->proteger($champ_etendu->id);
			$cle = Cel::db()->proteger($champ_etendu->cle);
			$valeur = Cel::db()->proteger($champ_etendu->valeur);
 
			$lignes[] = "($id, $cle, $valeur)";
		}
 
		// la partie on duplicate key est spécifique mysql mais il sera facile de s'en passer le jour
		// où l'on change de sgbd
		$ajout = Cel::db()->executer(sprintf(
			"INSERT INTO %s (%s, extended_field_id, valeur) VALUES %s ON DUPLICATE KEY UPDATE value = VALUES(valeur) -- %s:%d",
			$this->table_obs_etendus,
			$this->champ_id,
			implode(',', $lignes),
			__FILE__, __LINE__));
		return ($ajout !== false);
	}
 
	/**
	 * Modifie un champ étendu associé à l'élément passé en paramètre
	 *
	 * @param ChampEtendu $champ_etendu
	 * @return bool true si la modification a eu lieu
	 */
	public function modifier(ChampEtendu $champ_etendu) {
		$id = Cel::db()->proteger($champ_etendu->id);
		$cle = Cel::db()->proteger($champ_etendu->cle);
		$valeur = Cel::db()->proteger($champ_etendu->valeur);
 
		$requete = "UPDATE {$this->table_obs_etendus} ".
			"SET value = $valeur ".
			"WHERE extended_field_id = $cle".
			"	AND {$this->champ_id} = $id ".
			' -- '.__FILE__.':'.__LINE__;
		$modif = Cel::db()->executer($requete);
		return ($modif !== false);
	}
 
	/**
	* Supprime le champ champ étendu associé à l'élément et au nom de clé passés en paramètre
	*
	* @param int $id_element_lie
	* @param string $cle
	* @return bool
	*/
	public function supprimer($id_element_lie, $cle) {
		$id = Cel::db()->proteger($id_element_lie);
		$cle = Cel::db()->proteger($cle);
		$requete = "DELETE FROM {$this->table_obs_etendus} ".
			"WHERE extended_field_id = $cle ".
			"AND {$this->champ_id} = $id ".
			' -- '.__FILE__.':'.__LINE__;
		$suppr = Cel::db()->executer($requete);
		return ($suppr !== false);
	}
 
	/**
	* Supprime tous les champs champ étendu associés à l'élément passés en paramètre
	*
	* @param int $id_element_lie
	* @return bool
	*/
	public function vider($id_element_lie) {
		$id = Cel::db()->proteger($id_element_lie);
		$requete = "DELETE FROM {$this->table_obs_etendus} ".
			"WHERE {$this->champ_id} = $id ".
			' -- '.__FILE__.':'.__LINE__;
		$suppr = Cel::db()->executer($requete);
		return ($suppr !== false);
	}
 
	/**
	* Supprime tous les champs champ étendu associés aux éléments passés en paramètre
	*
	* @param array $ids_elements_lies
	* @return bool
	*/
	public function viderParLots($ids_elements_lies) {
		$ids = $this->protegerTableau($ids_elements_lies);
		$requete = "DELETE FROM {$this->table_obs_etendus} ".
			"WHERE {$this->champ_id} IN (".implode(',',$ids).") ".
			' -- '.__FILE__.':'.__LINE__;
		$suppr = Cel::db()->executer($requete);
		return ($suppr !== false);
	}
 
	/**
	* Revnoie tous les intitules aux éléments passés en paramètre
	*
	* @param array $ids_elements_lies
	* @return bool
	*/
	public function consulterClesParLots($ids_elements_lies) {
		$cles_fmt = array();
		if(!empty($ids_elements_lies)) {
			$ids = $this->protegerTableau($ids_elements_lies);
			$requete = "SELECT `field_id`as cle  FROM `extended_field` f join extended_field_occurrence o 
			     on f.`id` =  extended_field_id WHERE `occurrence_id` in  (".implode(',',$ids).") ".
				' -- '.__FILE__.':'.__LINE__;
			$cles = Cel::db()->requeter($requete);
			$i = 0;
			foreach($cles as &$cle) {
				$cles_fmt[$cle['cle']] = $i++;
			}
		}
		return array_values(array_flip($cles_fmt));
	}
 
 
 
	/**
	 * Transforme un label en clé.
	 * Supprime tous les accents et caractères spéciaux.
	 * Accole les mots pour créer un chatmot.
	 *
	 * @param string le label.
	 * @return string la clé correspondante
	 */
	public function transformerLabelEnCle($label) {
		//TODO: cette fonction est elle encore pertinente
		// maintenant que la notion de label est supprimée ?
		$cle = strtolower(trim($label));
 
		// Suppression des mots inutiles
		$mots_a_remplacer = array(' le ', ' la ', ' les ', ' des ', ' de ', " l'", " d'", ' à ', ' au ');
		$cle = str_replace($mots_a_remplacer, ' ', $cle);
 
		// Remplacement parenthèses et crochets et leurs contenus
		$cle = preg_replace('/\([^)]+\)/', '', $cle);
		$cle = preg_replace('/\[[^\]]+\]/', '', $cle);
 
		// Remplacement des accents (voir : http://www.weirdog.com/blog/php/supprimer-les-accents-des-caracteres-accentues.html )
		$cle = htmlentities($cle, ENT_NOQUOTES, 'utf-8');
		$cle = preg_replace('/&([A-za-z])(?:acute|cedil|circ|grave|orn|ring|slash|th|tilde|uml);/', '\1', $cle);
		$cle = preg_replace('/&([A-za-z]{2})(?:lig);/', '\1', $cle); // pour les ligatures e.g. '&oelig;'
		$cle = preg_replace('/&[^;]+;/', '', $cle); // supprime les autres caractères
 
		// Suppression définitive de tout ce qui n'est pas ASCII
		$cle = preg_replace('/[^a-zA-Z0-9 ]/', ' ', $cle);
		$cle = preg_replace('/\s+/', ' ', $cle);
 
		// Accollement des mots
		$cle = ucwords($cle);
		$cle = str_replace(' ', '', $cle);
		$cle{0} = strtolower($cle{0});
 
		return $cle;
	}
}

Subversion Repositories eFlore/Applications.cel

(root)/trunk/jrest/bibliotheque/GestionChampsEtendus.php @ 3473 – Rev 3494 → 3535

Rev 3494		Rev 3535
1	`<?php`	1	`<?php`
2	`// declare(encoding='UTF-8');`	2	`// declare(encoding='UTF-8');`
3	`/**`	3	`/**`
4	`* Classe de gestion de l'ajout, modification et suppression des champs supplémentaires des obs et images.`	4	`* Classe de gestion de l'ajout, modification et suppression des champs supplémentaires des obs et images.`
5	`*`	5	`*`
6	`* @internal Mininum PHP version : 5.2`	6	`* @internal Mininum PHP version : 5.2`
7	`* @category CEL`	7	`* @category CEL`
8	`* @package Services`	8	`* @package Services`
9	`* @subpackage Bibliothèques`	9	`* @subpackage Bibliothèques`
10	`* @version 0.1`	10	`* @version 0.1`
11	`* @author Mathias CHOUET <mathias@tela-botanica.org>`	11	`* @author Mathias CHOUET <mathias@tela-botanica.org>`
12	`* @author Raphaël Droz <raphael@tela-botania.org>`	12	`* @author Raphaël Droz <raphael@tela-botania.org>`
13	`* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>`	13	`* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>`
14	`* @author Aurelien PERONNET <aurelien@tela-botanica.org>`	14	`* @author Aurelien PERONNET <aurelien@tela-botanica.org>`
15	`* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>`	15	`* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>`
16	`* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>`	16	`* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>`
17	`* @copyright 1999-2014 Tela Botanica <accueil@tela-botanica.org>`	17	`* @copyright 1999-2014 Tela Botanica <accueil@tela-botanica.org>`
18	`*/`	18	`*/`
19	`class GestionChampsEtendus extends Cel {`	19	`class GestionChampsEtendus extends Cel {`
20		20
21	`private $mode = null;`	21	`private $mode = null;`
22	`private $table_obs_etendus = null;`	22	`private $table_obs_etendus = null;`
23	`private $champ_id = null;`	23	`private $champ_id = null;`
24		24
25	`public function __construct($config, $mode = 'obs') {`	25	`public function __construct($config, $mode = 'obs') {`
26	`parent::__construct($config);`	26	`parent::__construct($config);`
27	`$this->mode = $mode;`	27	`$this->mode = $mode;`
28	`$this->table_obs_etendus = 'extended_field_occurrence';`	28	`$this->table_obs_etendus = 'extended_field_occurrence';`
29	`$this->champ_id = 'occurrence_id';`	29	`$this->champ_id = 'occurrence_id';`
30		30
31	`}`	31	`}`
32		32
33	`/**`	33	`/**`
34	`* Renvoie true ou false suivant que l'element indiqué possède une valeur`	34	`* Renvoie true ou false suivant que l'element indiqué possède une valeur`
35	`* pour la clé indiquée`	35	`* pour la clé indiquée`
36	`*`	36	`*`
37	`* @param int $id_element_lie`	37	`* @param int $id_element_lie`
38	`* @param string $cle`	38	`* @param string $cle`
39	`* @param string $valeur`	39	`* @param string $valeur`
40	`* @return bool`	40	`* @return bool`