PDOStatement::fetchAll
(PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
PDOStatement::fetchAll — Retourne un tableau contenant toutes les lignes du jeu d'enregistrements
Description
$fetch_style
[, mixed $fetch_argument
[, array $ctor_args
= array()
]]] )Liste de paramètres
-
fetch_style
-
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 dePDO::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ètrecolumn-index
.Pour récupérer uniquement les valeurs uniques d'une seule colonne depuis le jeu de résultats, utilisez
PDO::FETCH_COLUMN
avecPDO::FETCH_UNIQUE
.Pour retourner un tableau associatif groupé par les valeurs d'une colonne spécifique, utilisez
PDO::FETCH_COLUMN
avecPDO::FETCH_GROUP
. -
fetch_argument
-
Cet argument prend une valeur différente en fonction de la valeur de l'argument
fetch_style
:-
PDO::FETCH_COLUMN
: Retourne le numéro de la colonne demandée (indexée à partir de 0). -
PDO::FETCH_CLASS
: Retourne une instance de la classe désirée. Les colonnes sélectionnées sont liées aux attributs de la classe. -
PDO::FETCH_FUNC
: Retourne la valeur de retour de la fonction de rappel précisée.
-
-
ctor_args
-
Arguments du constructeur personnalisé de la classe lorsque l'argument
fetch_style
est àPDO::FETCH_CLASS
.
Valeurs de retour
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.
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.
Exemples
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);
?>
<?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);
?>
<?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));
?>
<?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);
?>
<?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 va afficher quelque chose de similaire à :
array(3) { [0]=> string(12) "apple: green" [1]=> string(12) "pear: yellow" [2]=> string(16) "watermelon: pink" }
Voir aussi
- PDO::query() - Exécute une requête SQL, retourne un jeu de résultats en tant qu'objet PDOStatement
- PDOStatement::fetch() - Récupère la ligne suivante d'un jeu de résultats PDO
- PDOStatement::fetchColumn() - Retourne une colonne depuis la ligne suivante d'un jeu de résultats
- PDO::prepare() - Prépare une requête à l'exécution et retourne un objet
- PDOStatement::setFetchMode() - Définit le mode de récupération par défaut pour cette requête