| New file |
|---|
| 0,0 → 1,142 |
|---|
| <?php |
| // declare(encoding='UTF-8'); |
| /** |
| * Classe de gestion de la base de données. |
| * |
| * @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-botanica.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 Bdd extends PDO { |
| |
| const SQL_MODE_ASSOC = PDO::FETCH_ASSOC; |
| const SQL_MODE_OBJET = PDO::FETCH_OBJ; |
| const SQL_RETOUR_COMPLET = 'All'; |
| const SQL_RETOUR_LIGNE = 'Row'; |
| const SQL_RETOUR_COLONNE = 'Column'; |
| const SQL_RETOUR_BRUT = 'Raw'; |
| |
| public function __construct($config, $base = 'database_cel') { |
| $cfg = $config[$base]; |
| // ATTENTION : la connexin à la bdd peut échouer si l'host vaut localhost. Utiliser 127.0.0.1 à la place. |
| $dsn = $cfg['phptype'].':dbname='.$cfg['database'].';host='.$cfg['hostspec']; |
| try { |
| // Création de la connexion en UTF-8 à la BDD |
| parent::__construct($dsn, $cfg['username'], $cfg['password'], array(PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES 'UTF8'")); |
| // Affiche les erreurs détectées par PDO (sinon mode silencieux => aucune erreur affichée) |
| parent::setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); |
| } catch (PDOException $e) { |
| echo 'La connexion à la base de donnée via PDO a échoué : ' .$dsn . "\n". $e->getMessage(); |
| } |
| } |
| |
| /** |
| * Protège automatiquement toutes les chaines comprises entre deux caractères '|'. |
| * Puis execute la requete. |
| * @see protegerRequete() |
| * @param unknown_type $requete |
| */ |
| public function requeter($requete, $retour = self::SQL_RETOUR_COMPLET, $mode = PDO::FETCH_ASSOC) { |
| return $this->executerRequete($requete, $retour, $mode); |
| } |
| |
| /** |
| * Execute la requete retournant une seule ligne de résultat. |
| * @param String $requete |
| */ |
| public function requeterLigne($requete, $mode = PDO::FETCH_ASSOC) { |
| return $this->executerRequete($requete, self::SQL_RETOUR_LIGNE, $mode); |
| } |
| |
| /** |
| * Execute la requete retournant une seule colone de résultat. |
| * @param String $requete |
| */ |
| public function requeterValeurUnique($requete, $mode = PDO::FETCH_ASSOC) { |
| return $this->executerRequete($requete, self::SQL_RETOUR_COLONNE, $mode); |
| } |
| |
| public function executerRequete($requete, $retour = self::SQL_RETOUR_COMPLET, $mode = PDO::FETCH_ASSOC) { |
| $resultat = false; |
| try { |
| switch ($retour) { |
| case self::SQL_RETOUR_COMPLET : |
| $resultat = $this->query($requete)->fetchAll($mode);// Retourne toutes les lignes |
| break; |
| case self::SQL_RETOUR_LIGNE : |
| $resultat = $this->query($requete)->fetch($mode);// Retourne la première ligne |
| break; |
| case self::SQL_RETOUR_COLONNE : |
| $resultat = $this->query($requete)->fetchColumn();// Retourne la première colonne de la première ligne |
| break; |
| case self::SQL_RETOUR_BRUT : |
| $resultat = $this->query($requete);// Retourne l'objet brut pour être utilisé dans une boucle de type foreach |
| break; |
| default: |
| $this->debug[] = "Le type de retour '$retour' est inconnu."; |
| } |
| if ($resultat === false) { |
| $this->debug[] = "La requête a retourné aucun résultat : $requete"; |
| } |
| } catch (PDOException $e) { |
| $msgTpl = "Requête echec.\nFichier : %s.\nLigne : %s.\nMessage : %s.\nRequête : %s"; |
| $this->debug[] = sprintf($msgTpl, $e->getFile(), $e->getLine(), $e->getMessage(), $requete); |
| } |
| return $resultat; |
| } |
| |
| /** |
| * Execute la requete retournant l'objet brut de résultat pour l'utiliser dans un foreach. |
| * @param String $requete |
| */ |
| public function requeterBrut($requete) { |
| return $this->executerRequete($requete, self::SQL_RETOUR_BRUT); |
| } |
| |
| public function executer($requete) { |
| try { |
| $resultat = $this->exec($requete); |
| if ($resultat === false) { |
| $this->debug[] = "La requête a échoué : $requete"; |
| } |
| } catch (PDOException $e) { |
| $message = "Fichier : {$e->getFile()} \nLigne : {$e->getLine()} \nMessage : {$e->getMessage()} \nRequête : $requete"; |
| $code = E_USER_ERROR; |
| throw new Exception($message, $code); |
| } |
| return $resultat; |
| } |
| |
| public function proteger($donnees) { |
| if (is_array($donnees)) { |
| $retour = $this->protegerTableau($donnees); |
| } else { |
| $retour = $this->quote($donnees); |
| } |
| return $retour; |
| } |
| |
| private function protegerTableau(Array $tableau) { |
| foreach ($tableau as $id => $val) { |
| if (is_array($val)) { |
| $tableau[$id] = $this->protegerTableau($val); |
| } else { |
| $tableau[$id] = $this->proteger($val); |
| } |
| } |
| return $tableau; |
| } |
| |
| public function obtenirDernierId() { |
| return $this->lastInsertId(); |
| } |
| } |
| Property changes: |
|---|
| Added: svn:mergeinfo |
|---|
| Merged /branches/v1.7-croissant/jrest/lib/Bdd2.php:r1855,1879-1880,1885-1886,1917,1923,1983 |
|---|
| Merged /branches/v2.0-elagueuse/jrest/lib/Bdd2.php:r2099-2100 |
|---|
| Merged /branches/topic-dbsingleton/jrest/lib/Bdd2.php:r1720-1764 |
|---|
| Merged /branches/v1.8-debroussailleuse/jrest/lib/Bdd2.php:r1981,1987,1992 |
|---|