Zend Framework 1.7.9 Manual

La méthode fetch() permet de ne récupérer qu'un seul résultat dans le statement précédemment exécuté. Trois paramètres sont disponibles pour cette méthode, tous optionnels :

• Fetch style en premier, permet de spécifier le mode de capture du résultat. C'est la structure dans laquelle celui-ci vous sera retourné. Voyez Changer le mode de récupération (Fetch Mode) pour une description des valeurs valides et de la forme des résultats alors renvoyés.

• Cursor orientation est le second paramètre. Par défaut il vaut Zend_Db::FETCH_ORI_NEXT, ce qui signifie que chaque appel futur à fetch() retourne l'enregistrement suivant.

• Offset, en troisième paramètre. Si le paramètre "cursor orientation" est réglé sur Zend_Db::FETCH_ORI_ABS, alors le numéro d'offset est le numéro du résultat à retourner, dans le statement. Si c'est Zend_Db::FETCH_ORI_REL, le numéro d'offset est relatif à la position du curseur avant l'appel à fetch().

fetch() retourne false si il n'y a plus de résultats restants dans le statement.

$stmt = $db->query('SELECT * FROM bugs');

while ($row = $stmt->fetch()) {
    echo $row['bug_description'];
}

Voyez aussi » PDOStatement::fetch().

Pour récupérer tous les résultats d'un statement, utilisez fetchAll(). Ceci est équivalent à appeler fetch() dans un boucle et retourner tous les résultats dans un tableau. La méthode fetchAll() accepte deux paramètres. Le premier est le mode de capture (fetch style), le deuxième est le numéro de la colonne à retourner, si Zend_Db::FETCH_COLUMN est utilisé.

$stmt = $db->query('SELECT * FROM bugs');

$rows = $stmt->fetchAll();

echo $rows[0]['bug_description'];

Voyez aussi » PDOStatement::fetchAll().

Par défaut l'objet statement retourne les colonnes du jeu de résultat en tant que tableau associatif, en mappant les noms des colonne sur leur valeur. Vous pouvez cependant spécifier un format différent, comme il est possible de faire avec la classe de l'adaptateur. La méthode setFetchMode() permet ceci. Indiquez un mode de capture en utilisant les constantes de la classe Zend_Db : FETCH_ASSOC, FETCH_NUM, FETCH_BOTH, FETCH_COLUMN, et FETCH_OBJ. Voyez Changer le mode de récupération (Fetch Mode) pour plus d'informations sur ces modes de capture. Les appels suivants à fetch() ou fetchAll() utiliseront le mode spécifié auparavant.

$stmt = $db->query('SELECT * FROM bugs');

$stmt->setFetchMode(Zend_Db::FETCH_NUM);

$rows = $stmt->fetchAll();

echo $rows[0][0];

Voyez aussi » PDOStatement::setFetchMode().

Pour retourner une colonne de résultat depuis un statement, utilisez la méthode fetchColumn(). Le paramètre optionnel est un entier représentant l'index de la colonne désirée, par défaut zéro. Cette méthode retourne un type scalaire, ou false s'il n'y a plus de résultats dans le statement.

Notez que cette méthode se comporte différemment de fetchCol() de l'adaptateur. La méthode fetchColumn() du statement retourne une seule valeur d'un seul résultat. fetchCol() de l'adaptateur retourne un tableau de valeurs issues de la première colonne du jeu résultat.

$sql = 'SELECT bug_id, bug_description, bug_status FROM bugs';

$stmt = $db->query($sql);

$bug_status = $stmt->fetchColumn(2);

Voyez aussi » PDOStatement::fetchColumn().

Pour récupérer une colonne de résultat en tant qu'objet, depuis un statement exécuté, utilisez la méthode fetchObject(). Celle-ci prend deux paramètres optionnels. Le premier est une chaîne indiquant le nom de la classe que l'on souhaite se voir retourner, par défaut il s'agit de "stdClass". Le deuxième paramètre est un tableau de paramètres qui sera passé au constructeur de cette classe.

$sql = 'SELECT bug_id, bug_description, bug_status FROM bugs';

$stmt = $db->query($sql);

$obj = $stmt->fetchObject();

echo $obj->bug_description;

Voyez aussi » PDOStatement::fetchObject().