(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDOStatement::fetchAll — Récupère les lignes restantes d'un ensemble de résultats
$mode = PDO::FETCH_DEFAULT): array$mode = PDO::FETCH_COLUMN, int $column): array$mode = PDO::FETCH_CLASS, string $class, ?array $constructorArgs): array
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.
Vous pouvez spécifier quelle colonne vous voulez avec le paramètre
column.
Pour récupérer uniquement les valeurs uniques d'une seule colonne depuis
le jeu de résultats, utilisez PDO::FETCH_COLUMN avec
PDO::FETCH_UNIQUE.
Pour retourner un tableau associatif groupé par les valeurs d'une
colonne spécifique, utilisez PDO::FETCH_COLUMN avec
PDO::FETCH_GROUP.
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.
PDOStatement::fetchAll() retourne un tableau contenant toutes les lignes du jeu d'enregistrements. Le tableau représente chaque ligne comme soit un tableau de valeurs des colonnes, soit un objet avec des propriétés correspondant à chaque nom de colonne. Un tableau vide est retourné s'il y a zéro résultat.
L'utilisation de cette méthode pour récupérer de gros jeux de résultats
peut augmenter les ressources du système, mais également ces ressources.
Plutôt que de récupérer toutes les données et de les manipuler avec PHP,
utilisez le serveur de base de données pour manipuler les jeux de résultats.
Par exemple, utilisez les clauses WHERE et
ORDER BY dans vos requêtes SQL pour restreindre les résultats
avant de les récupérer et de les traiter avec PHP.
Émet une erreur de niveau E_WARNING si l'attribut PDO::ATTR_ERRMODE est défini
à PDO::ERRMODE_WARNING.
Lève une exception PDOException si l'attribut PDO::ATTR_ERRMODE est défini
à PDO::ERRMODE_EXCEPTION.
| Version | Description |
|---|---|
| 8.0.0 |
Cette méthode retourne désormais toujours un tableau,
auparavant false pouvait être retourné en cas d'échec.
|
Exemple #1 Récupération de toutes les lignes d'un jeu de résultats
<?php
$sth = $dbh->prepare("SELECT nom, couleur FROM fruit");
$sth->execute();
/* Récupération de toutes les lignes d'un jeu de résultats */
print("Récupération de toutes les lignes d'un jeu de résultats :\n");
$result = $sth->fetchAll();
print_r($result);
?>
Résultat de l'exemple ci-dessus est similaire à :
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
)
)
Exemple #2 Récupération de toutes les valeurs d'une seule colonne depuis un jeu de résultats
L'exemple suivant montre comment retourner toutes les valeurs d'une seule colonne depuis un jeu de résultats, même si la requête SQL retourne plusieurs colonnes par lignes.
<?php
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();
/* Récupération de toutes les valeurs de la première colonne */
$result = $sth->fetchAll(PDO::FETCH_COLUMN, 0);
var_dump($result);
?>
Résultat de l'exemple ci-dessus est similaire à :
Array(3)
(
[0] =>
string(5) => apple
[1] =>
string(4) => pear
[2] =>
string(10) => watermelon
)
Exemple #3 Grouper toutes les valeurs d'une seule colonne
L'exemple suivant montre comment retourner un tableau associatif
groupé par les valeurs de la colonne spécifiée d'un jeu de résultats.
Le tableau contient trois clés : les valeurs apple
et pear sont retournées sous la forme de tableaux
qui contiennent deux couleurs différentes, tandis que
watermelon est retourné sous la forme d'un tableau
qui contient uniquement une seule couleur.
<?php
$insert = $dbh->prepare("INSERT INTO fruit(name, colour) VALUES (?, ?)");
$insert->execute(array('apple', 'green'));
$insert->execute(array('pear', 'yellow'));
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();
/* Grouper les valeurs de la première colonne */
var_dump($sth->fetchAll(PDO::FETCH_COLUMN|PDO::FETCH_GROUP));
?>
Résultat de l'exemple ci-dessus est similaire à :
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"
}
}
Exemple #4 Instancier une classe pour chaque résultat
L'exemple suivant montre le comportement de
PDO::FETCH_CLASS.
<?php
class fruit {
public $name;
public $colour;
}
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();
$result = $sth->fetchAll(PDO::FETCH_CLASS, "fruit");
var_dump($result);
?>
Résultat de l'exemple ci-dessus est similaire à :
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"
}
}
Exemple #5 Appel d'une fonction pour chaque résultat
L'exemple suivant montre le comportement de
PDO::FETCH_FUNC.
<?php
function fruit($name, $colour) {
return "{$name}: {$colour}";
}
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();
$result = $sth->fetchAll(PDO::FETCH_FUNC, "fruit");
var_dump($result);
?>
Résultat de l'exemple ci-dessus est similaire à :
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"
}