La classe peut soit lancer des exceptions de la classe Exception native de php5, soit une classe étendue personnalisée. Cela se paramètre dans le fichier DB.param.php en renseignant le nom de la classe à utiliser.
Il faut donc impérativement (pour que le code soit propre) utiliser une syntaxe avec des blocs try/catch, ou bien utiliser une fonction de de gestion des exception définie par set_exception_handler().
Les fonctions publiques implémentées à l'heure actuelle sont :
- connect()
- disconnect()
- query()
- prepare() : cette méthode simule le comportement de la fonction php pg_prepare spécifique à PostGreSQL. Elle "stocke" une requête pour utilisation ultérieure. S'utilise avec execute()
- execute() : execute une requête stockée avec prepare(). Des paramètres peuvent figurer dans la requête, comme illustré dans le code ci-dessus.
- fetch_row, fetch_array, fetch_assoc : retourent une ligne sous forme respectivement de tableau numérique, numérique et associatifg, associatif.
- fetch_arrowset, fetch_arrayset, fetch_assocset : retournent un tableau numérique contenant le résultat des fonctions précédentes
- num_rows, affected_rows
Il s'agit du minimum vital.
Les variables publiques accessibles sont :
- sql : On peut y stocker une requête. Par défaut, la fonction query() utilise cette variable si aucune requête n'est passée en argument.
- num_queries : nombre de requêtes exécutées par la méthode query() (qui est également appelée par la méthode execute() )
- result : par défaut, les fonctions prenant un résultat en argument utilisent cette variable, qui est automatiquement renseignée par query(). On peut leur passer une autre ressource résultat (facultatif).
Le code est normalement assez clair et documenté pour qu'on comprenne aisément ce qui s'y passe.