PDOStatement::fetchAll

Liste de paramètres

mode

Contrôle le contenu du tableau retourné comme documenté dans la fonction PDOStatement::fetch(). Valeur par défaut : PDO::ATTR_DEFAULT_FETCH_MODE (qui prend sa valeur par défaut de PDO::FETCH_BOTH).

Pour retourner un tableau contenant toutes les valeurs d'une seule colonne depuis le jeu de résultats, spécifiez PDO::FETCH_COLUMN. Il est possible de spécifier quelle colonne l'on veut avec le paramètre column.

Pour indexer le tableau résultant par la valeur d'une certaine colonne (plutôt que par des nombres consécutifs), placez le nom de cette colonne en premier dans la liste des colonnes en SQL, et utiliser PDO::FETCH_UNIQUE. Cette colonne doit contenir uniquement des valeurs uniques, sinon certaines données seront perdues.

Pour regrouper les résultats sous la forme d'un tableau à trois dimensions indexé par les valeurs d'une colonne spécifiée, placez le nom de cette colonne en premier dans la liste des colonnes en SQL et utiliser PDO::FETCH_GROUP.

Pour regrouper les résultats sous la forme d'un tableau à deux dimensions, utiliser un OU bit-à-bit avec PDO::FETCH_GROUP et PDO::FETCH_COLUMN. Les résultats seront regroupés par la première colonne, la valeur de l'élément du tableau étant une liste d'entrées correspondantes de la seconde colonne.

Les paramètres suivants sont dynamiques et dépendent du mode de récupération. Ils ne peuvent pas être utilisés avec des paramètres nommés.

column

Utilisé avec PDO::FETCH_COLUMN. Renvoie la colonne indiquée indexée à 0.

class

Utilisé avec PDO::FETCH_CLASS. Renvoie des instances de la classe spécifiée, en faisant correspondre les colonnes de chaque ligne à des propriétés nommées dans la classe.

constructorArgs

Arguments du constructeur personnalisé de la classe lorsque l'argument mode est à PDO::FETCH_CLASS.

callback

Utilisé avec PDO::FETCH_FUNC. Renvoie les résultats de l'appel de la fonction spécifiée, en utilisant les colonnes de chaque ligne comme paramètres dans l'appel.

Récupération de toutes les lignes d'un jeu de résultats :
Array
(
    [0] => Array
        (
            [nom] => apple
            [0] => apple
            [couleur] => red
            [1] => red
        )

    [1] => Array
        (
            [nom] => pear
            [0] => pear
            [couleur] => green
            [1] => green
        )

    [2] => Array
        (
            [nom] => watermelon
            [0] => watermelon
            [couleur] => pink
            [1] => pink
        )

)

Array(3)
(
    [0] =>
    string(5) => apple
    [1] =>
    string(4) => pear
    [2] =>
    string(10) => watermelon
)

array(3) {
  ["apple"]=>
    array(2) {
      [0]=>
        string(5) "green"
      [1]=>
        string(3) "red"
    }
  ["pear"]=>
    array(2) {
      [0]=>
        string(5) "green"
      [1]=>
        string(6) "yellow"
    }
  ["watermelon"]=>
    array(1) {
      [0]=>
        string(5) "pink"
    }
}

array(3) {
  [0]=>
  object(fruit)#1 (2) {
    ["name"]=>
    string(5) "apple"
    ["colour"]=>
    string(5) "green"
  }
  [1]=>
  object(fruit)#2 (2) {
    ["name"]=>
    string(4) "pear"
    ["colour"]=>
    string(6) "yellow"
  }
  [2]=>
  object(fruit)#3 (2) {
    ["name"]=>
    string(10) "watermelon"
    ["colour"]=>
    string(4) "pink"
  }
  [3]=>
  object(fruit)#4 (2) {
    ["name"]=>
    string(5) "apple"
    ["colour"]=>
    string(3) "red"
  }
  [4]=>
  object(fruit)#5 (2) {
    ["name"]=>
    string(4) "pear"
    ["colour"]=>
    string(5) "green"
  }
}

array(3) {
  [0]=>
  string(12) "apple: green"
  [1]=>
  string(12) "pear: yellow"
  [2]=>
  string(16) "watermelon: pink"
  [3]=>
  string(10) "apple: red"
  [4]=>
  string(11) "pear: green"
}