Documentation de l'objet bab database : Différence entre versions
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' | + | 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
Sommaire
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.