DB_common::getAll()

DB_common::getAll() -- Récupère toutes les lignes

Synopsis

array &getAll (string $query [, array $params = array() [, integer $fetchmode = DB_FETCHMODE_DEFAULT]])

Description

Récupère le résultat entier d'une requête dans un tableau imbriqué. La fonction prend soin d'exécuter la requête et de libérer le résultat à la fin.

Paramètres

chaîne de caractères $query

La requête SQL à préparer.

array $params

tableau à utiliser dans l'exécution de la requête. Le nombre d'éléments du tableau doit correspondre au nombre de marqueurs dans la requête.

prepare()/ execute() sont utilisées.

Avertissement

Cette méthode n'autorise pas les scalaires en tant qu'argument.

entier $fetchmode

le mode de récupération à utiliser. Par défaut, c'est DB_FETCHMODE_DEFAULT, qui demande à la méthode d'utiliser le mode de récupération courant de DB. Le mode de récupération courant peut être changé en utilisant setFetchMode(). Les valeurs possibles sont :

  • DB_FETCHMODE_ORDERED

  • DB_FETCHMODE_ASSOC

  • DB_FETCHMODE_OBJECT

  • DB_FETCHMODE_ORDERED | DB_FETCHMODE_FLIPPED

  • DB_FETCHMODE_ASSOC | DB_FETCHMODE_FLIPPED

Valeur retournée

array - un tableau imbriqué ou un objet DB_Error en cas d'erreurs.

Valeurs renvoyées

Tableau 34-1. Valeurs PEAR_Error possibles

Code erreurMessage erreurRaisonSolution
DB_ERROR_INVALID invalid La requête SQL à préparer n'est pas valide. Voyez la documentation de prepare(), si vous voulez utiliser une requête SQL avec des marqueurs.
DB_ERROR_MISMATCH mismatch Le nombre de paramètres ne correspond pas au nombre de marqueurs dans la requête préparée. Vérifiez le nombre de marqueurs dans la requête prepare() passée à $query. Il doit être égal au nombre d'entrées passées à $params.
DB_ERROR_NODBSELECTED no database selected Aucune base de données n'a été sélectionnée. Vérifiez le DSN dans connect().
tout autre code erreur  Erreur spécifique à la base de données. Vérifiez la section spécifique à la base de données dans le manuel PHP pour trouver la raison de cette erreur. Dans la plupart des cas, il s'agit d'une requête mal formée. Comme l'utilisation de LIMIT dans une requête envoyée à une base de données Oracle.

Note

Cette fonction ne peut pas être appelée de façon statique.

Exemple

Voir aussi

setFetchMode(), getOne(), getRow(), getCol(), getAssoc(), query(), << Introduction - Préparation & Exécution >>