Class Bdd

Classe Bdd, d'accés au base de données. Elle fait office d'abstraction légère de base de données en utilisant diverses possibilités d'accès aux bases de données (PDO, mysql, mysqli, SQLite3). Les valeurs pour le paramètre 'bdd_abstraction' du fichier config.ini sont : pdo, mysql, mysqli, sqlite3 Vous pouvez aussi utiliser : "php:Bdd::ABSTRACTION_PDO","php:Bdd::ABSTRACTION_MYSQL", "php:Bdd::ABSTRACTION_MYSQLI", "php:Bdd::ABSTRACTION_SQLITE3". Elle peut être étendue, pour ajouter le support d'autres bases de données où prendre en compte des méthodes spécifique à un type d'abstraction.

Package: Framework
Category: php 5.2
Copyright: Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
License: Licence CECILL
License: Licence GNU-GPL
Author: Aurélien PERONNET <aurelien@tela-botanica.org>
Author: Jean-Pascal MILCENT <jpm@tela-botanica.org>
Located at Bdd.php

Methods summary
`public`	# `__construct( )` Constructeur par défaut, appelé à l'initialisation. Constructeur par défaut, appelé à l'initialisation.
`protected`	# `initialiserProtocole( )` Initialise les constantes de classe à leur bonne valeur et déclenche une erreur si le protocole n'est pas bien défini. Initialise les constantes de classe à leur bonne valeur et déclenche une erreur si le protocole n'est pas bien défini.
`protected`	# `connecter( )` Connection à la base de données en utilisant les informations fournies par le fichier de configuration. Cette méthode est private et final car elle n'a pas vocation a être appelée par l'utilisateur. TODO : il est peut être nécessaire pour MYSQL, MYSQLi et SQLITE3 afin d'éviter les boucles infinis d'erreur quand la bdd n'est pas configuré d'utiliser : $this->connexion->query (comme pour PDO) Connection à la base de données en utilisant les informations fournies par le fichier de configuration. Cette méthode est private et final car elle n'a pas vocation a être appelée par l'utilisateur. TODO : il est peut être nécessaire pour MYSQL, MYSQLi et SQLITE3 afin d'éviter les boucles infinis d'erreur quand la bdd n'est pas configuré d'utiliser : $this->connexion->query (comme pour PDO)
`public boolean`	# `ping( )` Permet de tester, puis de reconnecter une connection au cas ou celle aurait été perdue (utile dans le cas d'une connection ouverte depuis trop longtemps) Permet de tester, puis de reconnecter une connection au cas ou celle aurait été perdue (utile dans le cas d'une connection ouverte depuis trop longtemps) Returns `boolean`
`final protected`	# `requete( mixed $requete )` Deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see requeter
`public mixed`	# `requeter( string $requete )` Execute une requête et retourne le résultat tel que renvoyé par l'abstraction courante. Execute une requête et retourne le résultat tel que renvoyé par l'abstraction courante. Parameters `$requete` `string` la requête à effectuer Returns `mixed` un objet contenant le résultat de la requête
`final protected`	# `requeteUn( mixed $requete, mixed $mode = Bdd::MODE_ASSOC )` Deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see recuperer
`public mixed`	# `recuperer( string $requete, string $mode = Bdd::MODE_ASSOC )` Execute une requête et retourne le premier résultat sous forme de tableau (par défaut) ou d'objet. Les noms des champs de la base de données correspondent aux noms des clés du tableau ou aux noms des attributs de l'objet. Execute une requête et retourne le premier résultat sous forme de tableau (par défaut) ou d'objet. Les noms des champs de la base de données correspondent aux noms des clés du tableau ou aux noms des attributs de l'objet. Parameters `$requete` `string` la requête à effectuer `$mode` `string` le mode de retour ASSOC (Bdd::MODE_ASSOC) pour un tableau ou OBJECT (Bdd::MODE_OBJET) pour un objet. Returns `mixed` un objet ou un tableau contenant le résultat de la requête
`final protected`	# `requeteTous( mixed $requete, mixed $mode = Bdd::MODE_ASSOC )` Deprecated changement de nom. Disparaîtra dans la version 0.4. Utiliser à la place : @see recupererTous
`public array`	# `recupererTous( string $requete, string $mode = Bdd::MODE_ASSOC )` Execute une requête et retourne un tableau de résultats. Un résultat peut être présentés sous forme de tableau (par défaut) ou d'objet. Les noms des champs de la base de données correspondent aux noms des clés du tableau résultat ou aux noms des attributs de l'objet résultat. Execute une requête et retourne un tableau de résultats. Un résultat peut être présentés sous forme de tableau (par défaut) ou d'objet. Les noms des champs de la base de données correspondent aux noms des clés du tableau résultat ou aux noms des attributs de l'objet résultat. Parameters `$requete` `string` la requête à effectuer `$mode` `string` le mode de retour des résultats : ASSOC (Bdd::MODE_ASSOC) pour un tableau ou OBJECT (Bdd::MODE_OBJET) pour un objet. Returns `array` un tableau contenant les résultats sous forme d'objets ou de tableau (par défaut).
`public mixed`	# `proteger( Mixed $donnees )` Protège une chaine de caractères ou le contenu d'un tablea avant l'insertion dans la base de données (ajout de quotes ou guillemets). Protège une chaine de caractères ou le contenu d'un tablea avant l'insertion dans la base de données (ajout de quotes ou guillemets). Parameters `$donnees` `Mixed` une chaine ou un tableau à protéger Returns `mixed` la chaine ou le tableau à protégé
`public`	# `protegerTableau( array $tableau )` Deprecated changement de nom. Deviendra "private" dans la version 0.5. Utiliser à la place : @see proteger
`public mixed`	# `recupererIdDernierAjout( mixed $parametres = null )` Retourne l'identifiant de la dernière ligne insérée, ou la dernière valeur d'une séquence d'objets, dépendamment, dans le cas de PDO, du driver utilisé. Les méthodes utilisées pour retourner l'identifiant peuvent avoir des comportements différent. Consulter la documentation PHP correspondant à l'abstraction choisie avant de l'utiliser : Retourne l'identifiant de la dernière ligne insérée, ou la dernière valeur d'une séquence d'objets, dépendamment, dans le cas de PDO, du driver utilisé. Les méthodes utilisées pour retourner l'identifiant peuvent avoir des comportements différent. Consulter la documentation PHP correspondant à l'abstraction choisie avant de l'utiliser : Parameters `$parametres` `mixed` un paramètre éventuel à transmettre (en fonction de l'abstraction de BDD utilisée). Returns `mixed` le dernier identifiant de clé primaire ajouté dans la base de données (string ou int). Link(http://fr.php.net/manual/fr/function.mysql-insert-id.php, mysql_insert_id()) Link(http://fr.php.net/manual/fr/pdo.lastinsertid.php, PDO::lastInsertId([ string $name = NULL ])) Link(http://fr.php.net/manual/fr/sqlite3.lastinsertrowid.php, SQLite3::lastInsertRowID()) Link(http://php.net/manual/en/mysqli.insert-id.php, mysqli->insert_id())
`public`	# `__destruct( )` Destructeur de classe, se contente de fermer explicitement la connexion à la base de donnée. Destructeur de classe, se contente de fermer explicitement la connexion à la base de donnée.

Constants summary
`string`	`ERREUR_REQUETE_TPL`	`'Requête echec.\nFichier : %s.\nLigne : %s.\nMessage : %s.\nRequête : %s'`	# Constante stockant le squelette du message en cas d'erreur de requête sql. Constante stockant le squelette du message en cas d'erreur de requête sql.
`string`	`ERREUR_CONNEXION_TPL`	`'Erreur de connexion à la base de données, vérifiez les paramètres du fichier de configuration.\nMessage : %S.'`	# Constante stockant le squelette du message en cas d'erreur de connexion à la base de données. Constante stockant le squelette du message en cas d'erreur de connexion à la base de données.
`string`	`ERREUR_SELECTION_BDD_TPL`	`'Erreur de sélection de la base de données, vérifiez les paramètres du fichier de configuration.\nMessage : %S.'`	# Constante stockant le squelette du message en cas d'erreur de sélection de la base de données. Constante stockant le squelette du message en cas d'erreur de sélection de la base de données.
`string`	`ABSTRACTION_PDO`	`'pdo'`	# Constante stockant le code pour l'abstraction de PDO. Constante stockant le code pour l'abstraction de PDO.
`string`	`ABSTRACTION_MYSQL`	`'mysql'`	# Constante stockant le code pour l'abstraction de mysql. Constante stockant le code pour l'abstraction de mysql.
`string`	`ABSTRACTION_MYSQLI`	`'mysqli'`	# Constante stockant le code pour l'abstraction de mysqli. Constante stockant le code pour l'abstraction de mysqli.
`string`	`ABSTRACTION_SQLITE3`	`'sqlite3'`	# Constante stockant le code pour l'abstraction de SQLite3. Constante stockant le code pour l'abstraction de SQLite3.
`string`	`MODE_ASSOC`	`'ASSOC'`	# Constante stockant le code pour le mode tableau associatif des résultats des requêtes. Constante stockant le code pour le mode tableau associatif des résultats des requêtes.
`string`	`MODE_OBJET`	`'OBJECT'`	# Constante stockant le code pour le mode objet des résultats des requêtes. Constante stockant le code pour le mode objet des résultats des requêtes.

Properties summary
`protected string`	`$ASSOC`	`''`	# Mode de fetch associatif Mode de fetch associatif
`protected string`	`$OBJECT`	`''`	# Mode de fetch objet Mode de fetch objet
`protected mixed`	`$abstraction`		# abstraction de base de données utilisée abstraction de base de données utilisée
`protected mixed`	`$dsn`		# DSN pour accéder à la base de données DSN pour accéder à la base de données
`protected mixed`	`$type`		# Type de base de données (mysql, mysqli, etc ...) Type de base de données (mysql, mysqli, etc ...)
`protected mixed`	`$hote`		# Hote herbergeant la base de données Hote herbergeant la base de données
`protected mixed`	`$bdd_nom`		# Nom de la base de données à laquelle le modèle doit se connecter Nom de la base de données à laquelle le modèle doit se connecter
`protected mixed`	`$utilisateur`		# Nom d'utilisateur Nom d'utilisateur
`protected mixed`	`$pass`		# Mot de passe Mot de passe
`protected mixed`	`$encodage`	`null`	# Encodage de la base de données Encodage de la base de données
`protected mixed`	`$connexion`	`null`	# Connexion à la base de données Connexion à la base de données
`protected array`	`$parametres_obligatoires`	`array('bdd_abstraction', 'bdd_protocole', 'bdd_serveur', 'bdd_nom', 'bdd_utilisateur', 'bdd_mot_de_passe', 'bdd_encodage')`	# Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe. Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.

Packages

Classes

Class Bdd

Returns

Deprecated

Parameters

Returns

Deprecated

Parameters

Returns

Deprecated

Parameters

Returns

Parameters

Returns

Deprecated

Parameters

Returns

Link(http://fr.php.net/manual/fr/function.mysql-insert-id.php,

Link(http://fr.php.net/manual/fr/pdo.lastinsertid.php,

Link(http://fr.php.net/manual/fr/sqlite3.lastinsertrowid.php,

Link(http://php.net/manual/en/mysqli.insert-id.php,