New file |
0,0 → 1,301 |
<?php |
/** |
* PHP Version 5 |
* in=utf8 |
* out=utf8 |
* |
* @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 |
*/ |
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 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_champs_etendus} ". |
"WHERE {$this->champ_id} = $id ". |
" AND cle = $cle "; |
|
$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_champs_etendus} WHERE {$this->champ_id} = $id "; |
$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 * FROM {$this->table_champs_etendus} 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 ChampEtendu(); |
$champ_etendu->id = $id_element; |
$champ_etendu->cle = $ligne['cle']; |
$champ_etendu->label = $ligne['label']; |
$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); |
$label = Cel::db()->proteger($champ_etendu->label); |
$valeur = Cel::db()->proteger($champ_etendu->valeur); |
|
$requete = "INSERT INTO {$this->table_champs_etendus} ". |
"( {$this->champ_id}, cle, label, valeur) ". |
"VALUES ($id, $cle, $label, $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 = 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); |
$label = Cel::db()->proteger($champ_etendu->label); |
$valeur = Cel::db()->proteger($champ_etendu->valeur); |
|
$lignes[] = "($id, $cle, $label, $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, cle, label, valeur) VALUES %s ON DUPLICATE KEY UPDATE valeur = VALUES(valeur) -- %s:%d", |
$this->table_champs_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); |
$label = Cel::db()->proteger($champ_etendu->label); |
$valeur = Cel::db()->proteger($champ_etendu->valeur); |
|
$requete = "UPDATE {$this->table_champs_etendus} ". |
"SET label = $label, valeur = $valeur ". |
"WHERE cle = $cle". |
" AND {$this->champ_id} = $id "; |
|
$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_champs_etendus} WHERE cle = $cle AND {$this->champ_id} = $id "; |
$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_champs_etendus} WHERE {$this->champ_id} = $id "; |
$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_champs_etendus} WHERE {$this->champ_id} IN (".implode(',',$ids).") "; |
$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 cle FROM {$this->table_champs_etendus} WHERE {$this->champ_id} IN (".implode(',',$ids).") "; |
$cles = Cel::db()->requeter($requete); |
$i = 0; |
foreach($cles as &$cle) { |
$cles_fmt[$cle['cle']] = $i++; |
} |
} |
return array_values(array_flip($cles_fmt)); |
} |
|
/** |
* Renvoie la liste des groupes de champs étendus |
*/ |
public function consulterGroupesChampsEtendusPredefinis() { |
$groupes = array(); |
/*$requete = "SELECT * FROM {$this->table_champs_etendus}_groupes "; |
$champs = Cel::db()->executerRequete($requete); |
|
foreach ($champs as $champ) { |
if(!isset($groupes[$champ['groupe']])) { |
$groupes[$champ['groupe']] = array(); |
} |
$groupes[$champ['groupe']][$champ['cle']] = $champ['label']; |
}*/ |
return $groupes; |
} |
|
/** |
* 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) { |
$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. 'œ' |
$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; |
} |
} |
?> |