PDOStatement::execute
<<<		 PDOStatement::fetch PDOStatement::fetchAll
>>>
8.96 Fonctions PDO
8 Référence des fonctions
 Manuel PHP
. Introduction
. Installation
. Drivers PDO
. Classes pré-définies
. Constantes pré-définies
. PDO::beginTransaction
. PDO::commit
. PDO::__construct
. PDO::errorCode
. PDO::errorInfo
. PDO::exec
. PDO::getAttribute
. PDO::lastInsertId
. PDO::prepare
. PDO::query
. PDO::quote
. PDO::rollBack
. PDO::setAttribute
. PDOStatement::bindColumn
. PDOStatement::bindParam
. PDOStatement::columnCount
. PDOStatement::errorCode
. PDOStatement::errorInfo
. PDOStatement::execute
->PDOStatement::fetch
. PDOStatement::fetchAll
. PDOStatement::fetchSingle
. PDOStatement::getAttribute
. PDOStatement::getColumnMeta
. PDOStatement::rowCount
. PDOStatement::setAttribute
. PDOStatement::setFetchMode

8.96.25 PDOStatement::fetch() Récupère la ligne suivante d'un jeu de résultats

[ Exemples avec pdostatement_fetch ]   CVS uniquement

array  PDOStatement::fetch ( int   fetch_style , int   cursor_orientation , int   cursor_offset )
Attention

Cette fonction est EXPERIMENTALE . Cela signifie que le comportement de cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.

PDOStatement::fetch récupère une ligne depuis un jeu de résultats associé à l'objet PDOStatement .

    fetch_style
    Contrôle comment la prochaine ligne sera retournée à l'appelant. Cette valeur doit être une des constantes PDO_FETCH_* , et par défaut, vaut PDO_FETCH_BOTH .
      PDO_FETCH_ASSOC : retourne un tableau indexé par le nom de la colonne comme retourné dans le jeu de résultats
      PDO_FETCH_BOTH (défaut): retourne un tableau indexé par les noms de colonnes mais aussi les numéros de colonnes, comme retournés dans le jeu de résultats
      PDO_FETCH_BOUND : retourne TRUE et assigne les valeurs des colonnes de votre jeu de résultats dans les variables PHP à laquelles elles sont liées avec la méthode PDOStatement::bindParam
      PDO_FETCH_LAZY : combine PDO_FETCH_BOTH et PDO_FETCH_OBJ , créant ainsi les noms des variables de l'objet, comme elles sont accédées
      PDO_FETCH_OBJ : retourne un objet anonyme avec les noms de propriétés qui correspondent aux noms de colonnes retournés dans le jeu de résultats
      PDO_FETCH_NUM : retourne un tableau indexé par le numéro de la colonne comme elle est retourné dans votre jeu de résultat, commençant à 0
    cursor_orientation
    Pour un objet PDOStatement représentant un curseur scrollable, cette valeur détermine quelle ligne sera retournée à l'appelant. Cette valeur doit être une des constantes PDO_FETCH_ORI_* , et par défaut, vaut PDO_FETCH_ORI_NEXT .
    offset
    Pour un objet PDOStatement représentant un curseur scrollable pour lequel le paramètre cursor_orientation est défini à PDO_FETCH_ORI_ABS , cette valeur spécifie le numéro absolu de la ligne dans le jeu de résultats qui doit être récupérée.

    Pour un objet PDOStatement représentant un curseur scrollable pour lequel le paramètre cursor_orientation est défini à PDO_FETCH_ORI_REL , cette valeur spécifie la ligne à récupérer relativement à la position du curseur avant l'appel à la fonction PDOStatement::fetch .

Récupération de lignes en utilisant différentes méthodes

<?php
$sth = $dbh->prepare("SELECT nom, couleur FROM fruit");
$sth->execute();

/* styles PDOStatement::fetch */
print("PDO_FETCH_ASSOC: ");
print("Retourne la ligne suivante en tant qu'un tableau indexé par le nom des colonnes\n");
$result = $sth->fetch(PDO_FETCH_ASSOC);
print_r($result);
print("\n");

print("PDO_FETCH_BOTH: ");
print("Retourne la ligne suivante en tant qu'un tableau indexé par le nom et le numéro de la colonne\n");
$result = $sth->fetch(PDO_FETCH_BOTH);
print_r($result);
print("\n");

print("PDO_FETCH_LAZY: ");
print("Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés\n");
$result = $sth->fetch(PDO_FETCH_LAZY);
print_r($result);
print("\n");

print("PDO_FETCH_OBJ: ");
print("Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés\n");
$result = $sth->fetch(PDO_FETCH_OBJ);
print $result->NAME;
print("\n");
?>
Récupération des lignes avec un curseur scrollable

<?php
function readDataForwards($dbh) {
  $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY BET';
  try {
    $stmt = $dbh->prepare($sql, array(PDO_ATTR_CURSOR, PDO_CURSOR_SCROLL));
    $stmt->execute();
    while ($row = $stmt->fetch(PDO_FETCH_NUM, PDO_FETCH_ORI_NEXT)) {
      $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n";
      print $data;
    }
    $stmt = null;
  }
  catch (PDOException $e) {
    print $e->getMessage();
  }
}
function readDataBackwards($dbh) {
  $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY bet';
  try {
    $stmt = $dbh->prepare($sql, array(PDO_ATTR_CURSOR, PDO_CURSOR_SCROLL));
    $stmt->execute();
    $row = $stmt->fetch(PDO_FETCH_NUM, PDO_FETCH_ORI_LAST);
    do {
      $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n";
      print $data;
    } while ($row = $stmt->fetch(PDO_FETCH_NUM, PDO_FETCH_ORI_PRIOR));
    $stmt = null;
  }
  catch (PDOException $e) {
    print $e->getMessage();
  }
}
               
print "Lecture en avant :\n";
readDataForwards($conn);
               
print "Lecture en arrière :\n";
readDataBackwards($conn);
?>

<< PDOStatement::fetch >>
PDOStatement::execute Fonctions PDO PDOStatement::fetchAll