(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_fetch_all — Liefert alle Zeilen eines Abfrageergebnisses als Array
pg_fetch_all() gibt ein Array zurück, das alle Zeilen einer PgSql\Result-Instanz enthält.
Hinweis: Diese Funktion setzt NULL-Felder auf den PHP-Wert
null.
resultEine PgSql\Result-Instanz, die von pg_query(), pg_query_params() oder pg_execute() (unter anderen) zurückgegeben wurde.
mode
Ein optionaler Parameter, der bestimmt, wie das zurückgegebene Array indiziert werden soll.
mode ist eine Konstante, die einen der folgenden Werte annehmen kann:
PGSQL_ASSOC, PGSQL_NUM und PGSQL_BOTH.
Wenn die Funktion mit PGSQL_NUM aufgerufen wird, wird ein Array mit numerischen Indizes zurückgegeben,
mit PGSQL_ASSOC wird ein Array mit assoziatives Indizes zurückgegeben
und mit PGSQL_BOTH ein Array mit beiden Indizes.
Ein Array mit allen Zeilen des Abfrageergebnisses. Jede Zeile ist ein assoziatives Array mit den Spaltennamen als Indizes und den Werten der Tabellenspalte als Werte.
| Version | Beschreibung |
|---|---|
| 8.1.0 |
Der Parameter result erwartet nun eine PgSql\Result-Instanz;
vorher wurde eine Ressource erwartet.
|
| 8.0.0 |
pg_fetch_all() gibt bei Ergebnismengen mit null
Zeilen nun ein leeres Array statt false zurück.
|
| 7.1.0 |
Der Parameter mode wurde hinzugefügt.
|
Beispiel #1 pg_fetch_all()-Beispiel
<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "Konnte keine Verbindung aufbauen.\n";
exit;
}
$result = pg_query($conn, "SELECT * FROM authors");
if (!$result) {
echo "Ein Fehler ist aufgetreten.\n";
exit;
}
$arr = pg_fetch_all($result);
print_r($arr);
?>Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Array
(
[0] => Array
(
[id] => 1
[name] => Fred
)
[1] => Array
(
[id] => 2
[name] => Bob
)
)
Also for those who are trying to move off oracle, pg_fetch_all returns an array with rows and columns inverted in the sense of ocifetchall. You would need to transpose this result array before your code takes the first index a column name and the second index a row index.PG functions retrieve data as strings. If you want automatic casting you need to use PDO.pg_fetch_all, despite the app note, accepts only one argument, the resultset. It does exactly what is expected, returning a two-dimensional array of the resultset. I suspect the app note given was just copied from pg_fetch_array, which is what you want to use for a single row.It seems like pg_fetch_all() only works on version 4.3.x. I tried it with 4.2.2 and it does not recognize the function, so I assume it won't work on 4 => 4.2.x.For those wondering, this function returns a two-dimentional array, the first dimension being a 0-based indexed array, the second dimension an associative. So you might access the first authors surname using $authors[0]["surname"].
Certainly this is the case in PHP 5.2.9, I can't vouch for other versions though.Be aware that pg_fetch_all() is subject to the same limitations as pg_fetch_assoc(), in that if your query returns multiple columns with the same name (or alias) then only the rightmost one will be returned in the associative array, other ones will not.
A simple example:
<?php
$res = pg_query(
"SELECT a.*, b.* -- Fetch all columns from both tables
FROM table1 AS a
LEFT OUTER JOIN table2 as b
USING (column)"
);
$rows = pg_fetch_all($res);
?>
In this example, since we're selecting columns via *, if any columns from table2 share the same names as those in table1, they will be the ones returned despite that table2 (as the optional side of an outer join) may return NULL values.
This is not a bug, just a limitation of associative arrays in general, and is easy enough to avoid by structuring your queries carefully and using column aliases to avoid confusion.If you configure in your pg_hba.conf file a connection by the md5 method and you didn't setup a password for that user, you must define a password by the "alter role" PostgreSQL command:
alter role user_name encrypted password 'user_password';
Also, if you is connecting by type TCP/IP (host) and your IP address is another than (localhost), as example (127.0.1.1) you must uncomment the following line at postgresql.conf file, adding your IP address:
listen_addresses = 'localhost,127.0.1.1'
After save the new configuration, you must restart your PostgreSQL service.For versions of PHP that don't yet support the new names or newer functions I wrote a couple functions like this one
if (! function_exists("pg_fetch_all")) {
function pg_fetch_all($res, $kind="assoc") {
$i = 0; // this is needed for the row integer in the looped pg_fetch_array
if ($kind == "assoc") {
while ($row = pg_fetch_array($res, $i, PGSQL_ASSOC)) {
$array_out[] = $row;
$i++;
}else{
while ($row = pg_fetch_array($res)) {
$array_out[] = $row;
}
}
return $array_out;
}
}