Documentation de l'objet bab database : Différence entre versions

Version du 18 décembre 2007 à 11:54

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_error()

valeur retournée : FALSE si il n'y a pas eu d'erreur dans le dernière requête ou un message d'erreur en chaîne de caractères si il y a eu une erreur lors de la dernière requête.

$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.