Subversion Repositories eFlore/Applications.cel

<?php

/**

* PHP Version 5

*

* @category  PHP

* @package   jrest

* @author    Aurelien Peronnet <aurelien@tela-botanica.org>

* @copyright 2010 Tela-Botanica

* @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL

* @version   SVN: <svn_id>

* @link      /doc/jrest/

*/

/**

* Classe de gestion de l'ajout, modification et suppression des champs supplémentaires des obs et images

*

* in=utf8

* out=utf8

*

*/

class GestionChampsEtendus extends Cel {

	private $mode = null;

	private $table_champs_etendus = null;

	private $champ_id = null;

	public function GestionChampsEtendus($config, $mode) {

		parent::__construct($config);

		$this->mode = $mode;

		if($this->mode == 'obs') {

			$this->mode = 'obs';

			$this->table_champs_etendus = 'cel_obs_etendues';

			$this->champ_id = 'id_observation';

		} else if($this->mode == 'image') {

			$this->mode = 'image';

			$this->table_champs_etendus = 'cel_images_etendues';

			$this->champ_id = 'id_image';

		} else {

			throw new Exception('Mode inconnu, les modes autorisés sont "obs" et "image"');

		}

	}

	/**

	* 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 champEtenduExistePourElement($id_element_lie, $cle) {

		$requete = "SELECT COUNT(*) >= 1 as existe FROM ".$this->table_champs_etendus." ".

					"WHERE ".$this->champ_id." = ".$this->proteger($id_element_lie)." ".

					"AND cle = ".$this->proteger($cle);

		$resultat = $this->executerRequete($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

	*/

	public function obtenirChampsEtendusPourElement($id_element_lie) {

		$requete = "SELECT * FROM ".$this->table_champs_etendus." ".

						"WHERE ".$this->champ_id." = ".$this->proteger($id_element_lie)." ";

		$resultat = $this->executerRequete($requete);

		return $resultat;

	}

	/**

	* Renvoie tous les champs étendus associés aux éléments passés en paramètre

	* Sous forme tableau de tableaux associatifs clé valeur regroupé par id d'élement

	*

	* @param array $ids_element_lies

	* @return array

	*/

	public function obtenirChampsEtendusPourElementsMultiples($ids_element_lies) {

		$champs_etendus_par_element = array();

		if(!empty($ids_element_lies)) {

			$ids_element_lies = array_map(array($this, 'proteger'),$ids_element_lies);

			$requete = "SELECT * FROM ".$this->table_champs_etendus." ".

								"WHERE ".$this->champ_id." IN (".implode(',',$ids_element_lies).") ";

			$resultats = $this->executerRequete($requete);

			$champs_etendus_par_element = array();

			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();

				}

				$champs_etendus_par_element[$id_element][$ligne['cle']] = $ligne['valeur'];

			}

		}

		return $champs_etendus_par_element;

	}

	/**

	 * Ajoute un champ étendu à l'élément passé en paramètre,

	 * si la clé existe déjà, seule valeur du champ est mise à jour

	 *

	 * @param int $id_element_lie

	 * @param string $cle

	 * @param string $valeur

	 * @return bool

	 */

	public function ajouterChampEtendu($id_element_lie, $cle, $valeur) {

		$requete = "INSERT INTO ".$this->table_champs_etendus." ".

		           "(".$this->champ_id.", cle, valeur) ".

		           "VALUES (".$this->proteger($id_element_lie).",".$this->proteger($cle).",".$this->proteger($valeur).") ".

		           "ON DUPLICATE KEY UPDATE valeur = VALUES(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 = $this->executerRequeteSimple($requete);

		return ($ajout !== false);

	}

	/**

	* Ajoute des champs étendus à l'élément passé en paramètre,

	* si la clé existe déjà, seule la valeur du champ est mise à jour

	*

	* @param int $id_element_lie

	* @param array $cles_valeurs tableau de clés => valeurs à associer à l'élément

	* @return bool

	*/

	public function ajouterChampsEtendusMultiples($id_element_lie, $cles_valeurs) {

		$lignes = array();

		foreach($cles_valeurs as $cle => $valeur) {

			$lignes[] = "(".$this->proteger($id_element_lie).",".$this->proteger($cle).",".$this->proteger($valeur).")";

		}

		$requete = "INSERT INTO ".$this->table_champs_etendus." ".

			           "(".$this->champ_id.", cle, valeur) ".

			           "VALUES ".implode(',', $lignes)." ".

			           "ON DUPLICATE KEY UPDATE valeur = VALUES(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 = $this->executerRequeteSimple($requete);

		return ($ajout !== false);

	}

	/**

	* Ajoute des champs étendus aux éléments passés en paramètre,

	* si la clé existe déjà, seule la valeur du champ est mise à jour

	*

	* @param array $elements_cles_valeurs tableau associatif de la forme id, cle, valeur

	* @return bool

	*/

	public function ajouterChampsEtendusMultiplesAElementsMultiples($elements_cles_valeurs) {

		$lignes = array();

		foreach($elements_cles_valeurs as &$element) {

			$lignes[] = "(".$this->proteger($element['id']).",".$this->proteger($element['cle']).",".$this->proteger($element['valeur']).")";

		}

		$requete = "INSERT INTO ".$this->table_champs_etendus." ".

				           "(".$this->champ_id.", cle, valeur) ".

				           "VALUES ".implode(',', $lignes)." ".

				           "ON DUPLICATE KEY UPDATE valeur = VALUES(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 = $this->executerRequeteSimple($requete);

		return ($ajout !== false);

	}

	/**

	 * Modifie un champ étendu associé à l'élément passé en paramètre

	 *

	 * @param int $id_element_lie

	 * @param string $cle

	 * @param string $valeur

	 * @return bool

	 */

	public function modifierChampEtendu($id_element_lie, $cle, $valeur) {

		$requete = "UPDATE ".$this->table_champs_etendus." ".

				           "SET valeur = ".$this->proteger($valeur)." ".

				           "WHERE cle = ".$this->proteger($cle)." AND ".

						   $this->champ_id." = ".$this->proteger($id_element_lie);

		$modif = $this->executerRequeteSimple($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 supprimerChampEtendu($id_element_lie, $cle) {

		$requete = "DELETE FROM ".$this->table_champs_etendus." ".

					"WHERE cle = ".$this->proteger($cle)." AND ".

					$this->champ_id." = ".$this->proteger($id_element_lie);

		$suppr = $this->executerRequeteSimple($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 supprimerChampsEtendusAElement($id_element_lie) {

		$requete = "DELETE FROM ".$this->table_champs_etendus." ".

							"WHERE ".$this->champ_id." = ".$this->proteger($id_element_lie);

		$suppr = $this->executerRequeteSimple($requete);

		return ($suppr !== false);

	}

}

?>