Documentation de l'objet bab database

De OviWiki
Aller à : navigation, rechercher

Introduction

Dans Ovidentia, l'objet bab_datable est instancié qu'une seule fois, existe donc un variable global $babDB disponible en permanence qui contiens cet objet. Dans une fonction, il faut faire global $babDB pour rendre disponible la variable dans le contexte du module.


Méthodes

$babDB->db_query(string)

Exécuter une requète SQL

paramètre : la requête SQL à executer

valeur retournée : la ressource MySQL


$babDB->db_queryWem(string)

Exécuter une requète SQL sans gestionnaire d'erreur, le script continue son exécution même en cas d'erreur

paramètre : la requête SQL à executer

valeur retournée : la ressource MySQL


$babDB->db_fetch_assoc(ressource)

cette fonction permet d'obtenir la ligne suivante du résultat d'une requête

paramètre : ressource MySQL obtenue à partir d'une requête SQL

valeur retournée : un tableau associatif, les clés du tableau sont les noms des colonnes.


$babDB->db_fetch_array(ressource)

cette fonction permet d'obtenir la ligne suivante du résultat d'une requête

paramètre : ressource MySQL obtenue à partir d'une requête SQL

valeur retournée : un tableau associatif, les clés du tableau sont les noms des colonnes et des clés numériques.


$babDB->db_num_rows(ressource)

cette fonction permet d'obtenir le nombre de lignes de résultats d'une requête SELECT

paramètre : ressource MySQL obtenue à partir d'une requête SQL

valeur retournée : nombre entier


$babDB->db_affected_rows([ressource])

Retourne le nombre de lignes affectées lors de la dernière requête INSERT, UPDATE, REPLACE ou DELETE

paramètre : ressource MySQL obtenue à partir d'une requête SQL, si le paramètre n'est pas indiqué, c'est la dernière requête qui sera prise en compte

valeur retournée : nombre entier



$babDB->db_data_seek(ressource, int)

Déplace le pointeur interne de résultat MySQL

paramètre 1 : ressource MySQL obtenue à partir d'une requête SQL paramètre 2 : Position souhaité dans la liste des résultats

valeur retournée : Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.