PDOStatement::fetchAll
PDOStatement::fetchAll — Gibt ein Array zurück, das alle Zeilen einer Ergebnismenge enthält (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
Beschreibung
Syntax
array PDOStatement::fetchAll ([ int $fetch_style [, mixed $fetch_argument [, array $ctor_args = array() ]]] )
Parameters
fetch_style
Steuert, wie die nächste Zeile an den Aufrufer zurückgegeben wird. Dieser Wert muss eine der PDO::FETCH_*-Konstanten sein und hat standardmäßig den Wert von PDO::ATTR_DEFAULT_FETCH_MODE (Standard ist PDO::FETCH_BOTH).
Um ein Array zurückzugeben, das alle Werte einer einzelnen Spalte aus der Ergebnismenge enthält, geben Sie PDO::FETCH_COLUMN an. Rufen Sie die gewünschte Spalte ab, indem Sie den Parameter column-index angeben.
Um eindeutige Werte einer einzelnen Spalte aus der Ergebnismenge abzurufen, verknüpfen Sie PDO::FETCH_COLUMN bitweise per OR mit PDO::FETCH_UNIQUE.
Um ein assoziatives Array zurückzugeben, das nach den Werten einer angegebenen Spalte gruppiert ist, verknüpfen Sie PDO::FETCH_COLUMN bitweise per OR mit PDO::FETCH_GROUP.
fetch_argument
Abhängig vom Wert des Parameters fetch_style hat dieser Parameter unterschiedliche Bedeutungen:
-
PDO::FETCH_COLUMN: Gibt die angegebene Spalte zurück, indiziert beginnend bei 0. -
PDO::FETCH_CLASS: Gibt Instanzen der angegebenen Klasse zurück und ordnet die Spalten jeder Zeile den entsprechenden Eigenschaftsnamen in der Klasse zu. -
PDO::FETCH_FUNC: Übergibt die Spalten jeder Zeile als Argumente an die angegebene Funktion und gibt das Ergebnis des Funktionsaufrufs zurück.
ctor_args
Wenn der Parameter fetch_style PDO::FETCH_CLASS ist, sind dies die Konstruktorargumente der benutzerdefinierten Klasse.
Rückgabewerte
PDOStatement::fetchAll() gibt ein Array zurück, das alle verbleibenden Zeilen der Ergebnismenge enthält. Jede Zeile dieses Arrays ist entweder ein Array von Spaltenwerten oder ein Objekt mit Eigenschaften, die jedem Spaltennamen entsprechen.
Die Verwendung dieser Methode zum Abrufen einer großen Ergebnismenge erhöht die Systemlast und kann viele Netzwerkressourcen verbrauchen. Anstatt alle Daten abzurufen und in PHP zu verarbeiten, sollten Sie den Datenbankdienst verwenden, um die Ergebnismenge zu bearbeiten. Verwenden Sie beispielsweise WHERE- und ORDER BY-Klauseln in SQL, um die Ergebnisse einzuschränken, bevor Sie die Daten abrufen und über PHP verarbeiten.
Beispiele
Alle verbleibenden Zeilen in einer Ergebnismenge abrufen
<?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);
?>
Das obige Beispiel gibt Folgendes aus:
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
)
)
Alle Werte einer einzelnen Spalte aus einer Ergebnismenge abrufen
Das folgende Beispiel zeigt, wie alle Werte einer einzelnen Spalte aus einer Ergebnismenge zurückgegeben werden, obwohl die SQL-Anweisung selbst mehrere Spalten pro Zeile zurückgeben kann.
<?php
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();
/* 获取第一列所有值 */
$result = $sth->fetchAll(PDO::FETCH_COLUMN, 0);
var_dump($result);
?>
Das obige Beispiel gibt Folgendes aus:
Array(3)
(
[0] =>
string(5) => apple
[1] =>
string(4) => pear
[2] =>
string(10) => watermelon
)
Alle Werte nach einer einzelnen Spalte gruppieren
Das folgende Beispiel zeigt, wie ein assoziatives Array zurückgegeben wird, das nach den Werten einer angegebenen Spalte in der Ergebnismenge gruppiert ist. Das Array enthält drei Schlüssel: Die zurückgegebenen Arrays apple und pear enthalten zwei verschiedene Farben, während das zurückgegebene Array watermelon nur eine Farbe enthält.
<?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));
?>
Das obige Beispiel gibt Folgendes aus:
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"
}
}
Instanziiert eine Klasse für jede Ergebniszeile
Das folgende Beispiel zeigt das Verhalten des Fetch-Stils 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);
?>
Das obige Beispiel gibt Folgendes aus:
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"
}
}
Ruft eine Funktion für jede Zeile auf
Das folgende Beispiel zeigt das Verhalten des Fetch-Stils 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);
?>
Das obige Beispiel gibt Folgendes aus:
array(3) {
[0]=>
string(12) "apple: green"
[1]=>
string(12) "pear: yellow"
[2]=>
string(16) "watermelon: pink"
}
Andere Erweiterungen
PHP PDO-Referenzhandbuch