PDOStatement::fetchAll
PDOStatement::fetchAll — Retourne un tableau contenant toutes les lignes d'un jeu de résultats (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
Description
Syntaxe
array PDOStatement::fetchAll ([ int $fetch_style [, mixed $fetch_argument [, array $ctor_args = array() ]]] )
Parameters
fetch_style
Contrôle la manière dont la prochaine ligne sera renvoyée à l'appelant. Cette valeur doit être l'une des constantes PDO::FETCH_*, avec pour valeur par défaut celle de PDO::ATTR_DEFAULT_FETCH_MODE (la valeur par défaut est PDO::FETCH_BOTH).
Pour retourner un tableau contenant toutes les valeurs d'une seule colonne du jeu de résultats, spécifiez PDO::FETCH_COLUMN. Récupérez la colonne souhaitée en spécifiant le paramètre column-index.
Pour récupérer les valeurs uniques d'une seule colonne du jeu de résultats, effectuez un OU binaire entre PDO::FETCH_COLUMN et PDO::FETCH_UNIQUE.
Pour retourner un tableau associatif groupé par les valeurs d'une colonne spécifiée, effectuez un OU binaire entre PDO::FETCH_COLUMN et PDO::FETCH_GROUP.
fetch_argument
Selon la valeur du paramètre fetch_style, ce paramètre a différentes significations :
-
PDO::FETCH_COLUMN: Retourne la colonne spécifiée indexée à partir de 0. -
PDO::FETCH_CLASS: Retourne des instances de la classe spécifiée, en associant les colonnes de chaque ligne aux noms de propriétés correspondants de la classe. -
PDO::FETCH_FUNC: Passe les colonnes de chaque ligne comme arguments à la fonction spécifiée et retourne le résultat de l'appel de la fonction.
ctor_args
Lorsque le paramètre fetch_style est PDO::FETCH_CLASS, ce sont les arguments du constructeur de la classe définie par l'utilisateur.
Valeurs de retour
PDOStatement::fetchAll() renvoie un tableau contenant toutes les lignes restantes du jeu de résultats. Chaque ligne de ce tableau est soit un tableau de valeurs de colonnes, soit un objet dont les propriétés correspondent à chaque nom de colonne.
L'utilisation de cette méthode pour récupérer un grand jeu de résultats augmentera la charge système et peut consommer beaucoup de ressources réseau. Plutôt que de récupérer toutes les données et de les traiter en PHP, envisagez d'utiliser le service de base de données pour gérer le jeu de résultats. Par exemple, utilisez les clauses WHERE et ORDER BY en SQL pour restreindre les résultats avant de récupérer les données et de les traiter via PHP.
Exemples
Récupérer toutes les lignes restantes d'un jeu de résultats
<?php
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();
/* 获取结果集中所有剩余的行 */
print("Fetch all of the remaining rows in the result set:\n");
$result = $sth->fetchAll();
print_r($result);
?>
L'exemple ci-dessus affichera :
Fetch all of the remaining rows in the result set:
Array
(
[0] => Array
(
[NAME] => pear
[0] => pear
[COLOUR] => green
[1] => green
)
[1] => Array
(
[NAME] => watermelon
[0] => watermelon
[COLOUR] => pink
[1] => pink
)
)
Récupérer toutes les valeurs d'une seule colonne d'un jeu de résultats
L'exemple suivant montre comment renvoyer toutes les valeurs d'une seule colonne d'un jeu de résultats, même si l'instruction SQL elle-même peut renvoyer plusieurs colonnes par ligne.
<?php
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();
/* 获取第一列所有值 */
$result = $sth->fetchAll(PDO::FETCH_COLUMN, 0);
var_dump($result);
?>
L'exemple ci-dessus affichera :
Array(3)
(
[0] =>
string(5) => apple
[1] =>
string(4) => pear
[2] =>
string(10) => watermelon
)
Regrouper toutes les valeurs par une seule colonne
L'exemple suivant montre comment renvoyer un tableau associatif regroupé par les valeurs d'une colonne spécifiée dans le jeu de résultats. Le tableau contient trois clés : les tableaux apple et pear renvoyés contiennent deux couleurs différentes, tandis que le tableau watermelon renvoyé ne contient qu'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();
/* 根据第一列分组 */
var_dump($sth->fetchAll(PDO::FETCH_COLUMN|PDO::FETCH_GROUP));
?>
L'exemple ci-dessus affichera :
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) "green"
}
}
Instancie une classe pour chaque ligne de résultats
L'exemple suivant illustre le comportement du style de récupération 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);
?>
L'exemple ci-dessus affichera :
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"
}
}
Appelle une fonction pour chaque ligne
L'exemple suivant illustre le comportement du style de récupération 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);
?>
L'exemple ci-dessus affichera :
array(3) {
[0]=>
string(12) "apple: green"
[1]=>
string(12) "pear: yellow"
[2]=>
string(16) "watermelon: pink"
}
Autres extensions
Manuel de référence PHP PDO