PHP 5.4.32 Released

pg_fetch_all

(PHP 4 >= 4.3.0, PHP 5)

pg_fetch_all Lit toutes les lignes d'un résultat

Description

array pg_fetch_all ( resource $result )

pg_fetch_all() retourne un tableau qui contient toutes les lignes du résultat result.

Note: Cette fonction définit les champs NULL à la valeur PHP NULL.

Liste de paramètres

result

Ressource résultat de requête PostgreSQL, retourné par pg_query(), pg_query_params() ou pg_execute() (entre autres).

Valeurs de retour

Un tableau array de toutes les lignes dans le jeu de résultats. Chaque ligne est un tableau de valeurs des champs indexée par le nom des champs.

FALSE est retournée s'il n'y a pas de lignes dans le jeu de résultats ou si une erreur survient.

Exemples

Exemple #1 Exemple avec pg_fetch_all()

<?php 
$conn 
pg_pconnect("dbname=publisher");
if (!
$conn) {
  echo 
"Une erreur est survenue.\n";
  exit;
}

$result pg_query($conn"SELECT * FROM auteurs");
if (!
$result) {
  echo 
"Une erreur est survenue.\n";
  exit;
}

$arr pg_fetch_all($result);

print_r($arr);

?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

Array
(
    [0] => Array
        (
            [id] => 1
            [name] => Fred
        )

    [1] => Array
        (
            [id] => 2
            [name] => Bob
        )

)

Voir aussi

add a note add a note

User Contributed Notes 7 notes

up
0
strata_ranger at hotmail dot com
5 years ago
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.
up
0
prefer_not_to at say dot com
5 years ago
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.
up
0
Anonymous
11 years ago
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.
up
0
php dot net at mechintosh dot com
11 years ago
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;
  }
}
up
0
tasmanian at devil dot com
11 years ago
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.
up
0
jcomeau at whatisthewww dot com
11 years ago
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.
up
-1
viniciusweb at gmail dot com
9 years ago
This function returns NULL if the parameter is false.
To Top