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

De OviWiki
Aller à : navigation, rechercher
m ($babDB->db_query(string))
Ligne 13 : Ligne 13 :
  
 
valeur retournée : la ressource MySQL
 
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) ===
 
=== $babDB->db_fetch_assoc(ressource) ===
  
cette fonction permet d'obtenir la ligne suivante du résultat d'un requète
+
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
 
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.
 
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.

Version du 18 décembre 2007 à 11:50

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.