PHP Doku:: Holt eine Zeile als Array -

Verlauf / Chronik / History: (1) anzeigen

Sie sind hier:
Doku-StartseitePHP-HandbuchFunktionsreferenzDatenbankerweiterungenAnbieterspezifische DatenbankerweiterungenPostgreSQLPostgreSQL-Funktionenpg_fetch_array

Ein Service von Reinhard Neidl - Webprogrammierung.





(PHP 4, PHP 5)

pg_fetch_arrayHolt eine Zeile als Array


array pg_fetch_array ( resource $result [, int $row [, int $result_type ]] )

pg_fetch_array() gibt ein Array zurück, das die gelesene Zeile (Tupel, Datensatz) enthält.

pg_fetch_array() ist eine erweiterte Version von pg_fetch_row(). Zusätzlich zur Speicherung der Daten in einem numerischen Array (mit den Feldindizes) speichert diese Funktion die Daten auch in einem assoziativen Array, mit den Feldnamen als Indizes. In der Standardeinstellung wird ein Array mit beiden Indextypen zurückgegeben.

Hinweis: Diese Funktion setzt NULL-Felder auf den PHP Wert-NULL.

pg_fetch_array() ist NICHT wesentlich langsamer als pg_fetch_row() oder pg_fetch_assoc(), ist aber viel einfacher zu benutzen.



PostgreSQL Verbindungskennung, die (unter anderem) von den Funktionen pg_query(), pg_query_params() oder pg_execute() zurückgegeben wurde.


Die Nummer der Zeile des Abfrageergebnisses, die geholt werden soll. Die Nummerierung beginnt bei 0. Fehlt dieser Parameter, so wird jeweils die nächste Zeile geholt.


Ein optionaler Parameter, mit dem bestimmt werden kann, wie das array indiziert sein soll. result_type ist eine Konstante, die die Werte PGSQL_ASSOC, PGSQL_NUM oder PGSQL_BOTH annehmen kann. Mit der Konstanten PGSQL_NUM gibt pg_fetch_array() ein numerisch indiziertes Array zurück, mit der Konstanten PGSQL_ASSOC ein assoziatives Array. Die Standardeinstellung ist PGSQL_BOTH, mit der ein Array sowohl mit numerischen als auch assoziativen Indizes zurückgegeben wird.


Ein array, das entweder numerisch (bei 0 beginnend) oder assoziativ indiziert ist, oder beides. Jeder Wert im array wird als string repräsentiert. Nullwerte der Datenbank (NULL) werden als NULL zurückgegeben.

Bei einem Fehler oder wenn der Parameter row größer als die Anzahl der Zeilen im Abfrageergebnis ist, oder wenn kein Datensatz mehr gelesen werden kann, wird FALSE zurückgegeben.


Version Beschreibung
4.1.0 Der Parameter row wurde optional.
4.0.0 Der Parameter result_type wurde hinzugefügt.


Beispiel #1 pg_fetch_array() Beispiel


if (!
$conn) {
"Konnte keine Verbindung aufbauen.\n";

$result pg_query($conn"SELECT author, email FROM authors");
if (!
$result) {
"Ein Fehler ist aufgetreten.\n";

$arr pg_fetch_array($result0PGSQL_NUM);
$arr[0] . " <- Zeile 1 Autor\n";
$arr[1] . " <- Zeile 1 E-mail\n";

// Seit PHP 4.1.0 ist der Parameter row optional. Stattdessen kann
// NULL übergeben werden. Aufeinanderfolgende Aufrufe von 
// pg_fetch_array liefern jeweils den nächsten Datensatz.
$arr pg_fetch_array($resultNULLPGSQL_ASSOC);
$arr["author"] . " <- Zeile 2 Autor\n";
$arr["email"] . " <- Zeile 2 E-mail\n";

$arr pg_fetch_array($result);
$arr["author"] . " <- Zeile 3 Autor\n";
$arr[1] . " <- Zeile 3 E-mail\n";


Siehe auch

12 BenutzerBeiträge:
- Beiträge aktualisieren...
strata_ranger at hotmail dot com
23.08.2009 22:53
Note that when using PGSQL_BOTH, numerically and associatively indexed fields are separate variables and treated as such:

= pg_query("Select 'foo' as bar");

$data = pg_fetch_array($res, 0, PGSQL_BOTH);

// Array(2)
// {
//   [0] => string(3) "foo"
//   ["bar"] => string(3) "foo"
// }

// This won't affect $data['bar']
$data[0] = 'bar';

// Array(2)
// {
//   [0] => string(3) "bar"
//   ["bar"] => string(3) "foo"
// }

If you want to have reference binding between your numeric and associative indexes, you'll have to establish that yourself:


= pg_query("Select 'foo' as bar");

$data = pg_fetch_row($result);

// Establish references between column name/number
$from = $data;
$from as $cx => $value)
$key = pg_field_name($result, $cx);
    if (
is_string($key)) $data[$key] =& $data[$cx];

// Array(2)
// {
//   [0] => &string(3) "foo"
//   ["bar"] => &string(3) "foo"
// }
// Note the reference binding between $data[0] and $data['bar']

$data[0] = 'baz';

// Array(2)
// {
//   [0] => &string(3) "baz"
//   ["bar"] => &string(3) "baz"
// }

13.05.2005 23:21
Hopefully most people realize this on their own, but the examples below where people tried to get creative with getting numerical or associative (not both) keys in the result are rather pointless. See the pg_fetch_assoc() and pg_fetch_row() for the built in functions that do this automatically. It's generally a better idea to use one of these other functions unless you *need* to access fields by both collumn name *and* index.
Dave O
22.02.2005 18:52
I found this out through help from the mailing lists.  If you need to reset the internal counter, use the pg_result_seek, similar to:

pg_result_seek($result, 0)

...plagiarized from the comment on the function's doc page.
2.02.2005 22:59
In response to eth0's comment below about SELECT'ing from two tables where the tables have columns with the same names, you can get around this problem like this:

"SELECT AS foo1, AS foo2 FROM table1, table2"

In the associative array returned, the keys will be "foo1" and "foo2".
enyo at
15.09.2003 3:55
Just because it is not really clear how to specify the result type, I poste this message.

I wrote a wrapper function which looks like this:

function db_fetch_array ($result, $row = NULL, $result_type = PGSQL_ASSOC)
$return = @pg_fetch_array ($result, $row, $result_type);

I think this way it is quite comfortable to get the arrays you want.
akm at e-nterart dot pl
17.06.2003 18:45
(Timesaver) Be aware of the fact that keys in array returned by this function are (well, at least as of 4.2.3) of the same case as SQL column names (e.g. if your column name is ID then key name is also ID, not id or Id), and the keys in associative array are CASE SENSITIVE!!! So don't be surprised if you get unexpected results. Double check SQL column names and the key names.
jesse at sokieserv dot dhs dot org
13.12.2001 13:38
As of PHP 4.1.0, you can now use code such as the following to iterate through a result set:

$conn = pg_connect("host=localhost dbname=whatever");
$result = pg_exec($conn, "select * from table");
while ($row = pg_fetch_array($result))
     echo "data: ".$row["data"];

Can be a nice little time saver, PHP with MySQL has supported this for a while but I'm glad to see it extended to PostgreSQL...
eth0 at fins
28.09.2001 20:15
Please remember that if you have for example a table Customers with "cust_ID", "name" and "address" and another table Users with "u_ID","name" and "other" and then you SELECT WHERE cust_ID=u_ID then you'll get in the result array ONLY ONE "name" field, precisely the last one resulted from the select!!!
elliot at nospam dot rightnowtech dot com
23.07.2001 6:50
Just remember when you 'or die' to close your table(s) or you may get a confused look from non-internet explorer users.
mkb at ele dot uri dot edu
28.03.2001 2:52
The column names if you use PGSQL_ASSOC or PGSQL_BOTH are always in lowercase, no matter what the name is in the database or in the query.
gherson at snet dot net
6.03.2001 19:30
In addition to returning "false if there are no more rows", pg_fetch_array will also trigger an E_WARNING.  You can temporarily turn that error reporting level off and suck out all your data like so:

= error_reporting();
error_reporting($errRptLvl & ~(E_WARNING));
while (
$selection[$i++] = $this->fetchArray($j++)); // (fetchArray is a pg_fetch_array wrapper.)
error_reporting($errRptLvl); // Restore error reporting level.
unset($selection[$i-1]); // Delete the last, empty row.
return $selection;
gherson at snet dot net
3.01.2001 6:14
PGSQL_BOTH is the default, meaning your array size will be doubled. 
If you specify this field (result type), include no quotes around it or you won't get any data, not even an error. 
Here's my wrapper function:
function SQL_fetch_array($result_ndx, $row, $result_type=PGSQL_ASSOC) {
   return pg_fetch_array($result_ndx, $row, $result_type);

PHP Powered Diese Seite bei
The PHP manual text and comments are covered by the Creative Commons Attribution 3.0 License © the PHP Documentation Group - Impressum - mail("TO:Reinhard Neidl",...)