pg_fetch_all_columns
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.
pg_fetch_all
(PHP 4 >= 4.3.0, PHP 5)
pg_fetch_all — 取得されたすべての行を配列として取得する
説明
array pg_fetch_all
( resource $result
)
pg_fetch_all()は、結果リソースのすべての行 （レコード）を保持する配列を返します。
注意: この関数は、 NULL フィールドに PHPの NULL 値を設定します。
返り値
結果のすべての行を含む配列を返します。それぞれの行は、フィールド名を 添字とするフィールド値の配列です。
結果の行数が 0 だった場合、あるいはその他のエラーが発生した場合に FALSE を返します。
例
例1 PostgreSQL fetch all
<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "An error occured.\n";
exit;
}
$result = pg_query($conn, "SELECT * FROM authors");
if (!$result) {
echo "An error occured.\n";
exit;
}
$arr = pg_fetch_all($result);
print_r($arr);
?>
上の例の出力は、 たとえば以下のようになります。
Array
(
[0] => Array
(
[id] => 1
[name] => Fred
)
[1] => Array
(
[id] => 2
[name] => Bob
)
)
参考
- pg_fetch_row() - 数値添字の配列として行を得る
- pg_fetch_array() - 行を配列として取得する
- pg_fetch_object() - 行をオブジェクトとして得る
- pg_fetch_result() - 結果リソースから値を返す
add a note
User Contributed Notes
pg_fetch_all
strata_ranger at hotmail dot com
11-Jun-2009 05:00
prefer_not_to at say dot com
02-Jun-2009 07:09
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.
viniciusweb at gmail dot com
21-Mar-2005 03:20
This function returns NULL if the parameter is false.
frig1 at gmx dot at
03-Feb-2005 05:15
I'm using PHP 5.0.1 and pg_fetch_all and here pg_fetch_all is also not recognized as function
10-Jun-2003 02:36
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.
php dot net at mechintosh dot com
16-May-2003 08:42
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;
}
}
tasmanian at devil dot com
27-Mar-2003 07:42
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.
jcomeau at whatisthewww dot com
19-Feb-2003 09:02
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.