Please note that a very old bug (#76548) has been fixed in 7.2.8.
Previously, pg_fetch_result did not fetch the next row if $row was omitted.
It is now well the case, so bad use of the function can now cause some bugs in your codes.
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
pg_fetch_result — Pobiera dane z wyniku
pg_fetch_result() zwraca wartość określonego wiersza i pola (kolumny) w identyfikatorze wyniku PostgreSQL.
Informacja:
Funkcja ta nazywana była wcześniej pg_result().
wynik
Identyfikator wyniku zapytania, zwrócony przez pg_query(), pg_query_params() lub pg_execute() (między innymi).
wiersz
Numer wiersza wyniku do zwrócenia. Wiersze są numerowane od zera w górę. Jeśli nie podano, zwracany jest kolejny wiersz.
kolumna
Łańcuch (ang. string) reprezentujący nazwę pola (kolumny) do pobrania, w innym wypadku, kolumnę do pobrania reprezentuje jej numer (int). Pola są numerowane od zera w górę.
Typ boolean jest zwracany jako "t" lub "f" (true lub false z j. ang.). Wszystkie
inne typy, włączając tablice są zwracane jako łańcuchy sformatowane
domyślnie, do takiego samego typu PostgreSQL, jaki powinieneś zobaczyć w programie
psql. Wartości NULL z bazy danych
są zwracane jako NULL
.
FALSE
jest zwracane jeśli wiersz
przekracza liczbę
wszystkich dostępnych wierszy, lub w przypadku każdego innego błędu.
Przykład #1 pg_fetch_result() - przykład
<?php
$baza_danych = pg_connect("dbname=uzytkownicy uzytkownik=ja") || die();
$id = pg_query($baza_danych, "SELECT 1 UNION ALL SELECT 2");
$war = pg_fetch_result($id, 1, 0);
echo "Pierwsze pole w drugim wierszu to: ", $war, "\n";
?>
Powyższy przykład wyświetli:
Pierwsze pole w drugim wierszu to: 2
Please note that a very old bug (#76548) has been fixed in 7.2.8.
Previously, pg_fetch_result did not fetch the next row if $row was omitted.
It is now well the case, so bad use of the function can now cause some bugs in your codes.
Comment on boolean fields:
If you retrieve a boolean value from the PostgreSQL database, be aware that the value returned will be either the character 't' or the character 'f', not an integer. So, the statement
if (pg_fetch_result($rsRecords,0,'blnTrueFalseField')) {
echo "TRUE";
} else {
echo "FALSE";
}
will echo "TRUE" in either case (True or False stored in the field). In order to work as expected, do this instead:
if (pg_fetch_result($rsRecords,0,'blnTrueFalseField') == 't') {
echo "TRUE";
} else {
echo "FALSE";
}
See bug #33809 http://bugs.php.net/bug.php?id=33809
Whether this really is a bug or a feature is not clear.
However, it is probably best to always put your column names in extra quotes.
$res = pg_query(...);
$colname = pg_field_name($res, $j);
pg_fetch_result($res, $i, "\"$colname\"");
In order to use upper case in pg_fetch_result column names, it is apparently necessary to include explicit quotation marks.
Thus when I do this sort of thing:
$res = pg_query(...);
$ncols = pg_num_fields($res);
for ($j = 0; $j < $ncols; ++$j) {
$colname[$j] = pg_field_name($res, $j);
$name = htmlspecialchars($colname[$j]);
print("Column $j name = \"$name\"\n");
$value = htmlspecialchars(pg_fetch_result($res, 0, $colname[$j]));
print("Column \"{$colname[$j]}\" value = \"$value\"\n");
}
I get this sort of thing:
[....]
Warning: pg_fetch_result() [function.pg-fetch-result]: Bad column offset specified in /.../view.php on line 247
Column 8 name = "VEC index"
Column "VEC index" value = ""
But if I change the $value line to this:
$value = htmlspecialchars(pg_fetch_result($res, 0, "\"$colname[$j]\""));
I get this:
[...]
Column 8 name = "VEC index"
Column "VEC index" value[0] = "47"
In my opinion, pg_fetch_result(...) should use the quotes already. In other words, this may be a bug in the PHP postgres library. It does not seem to be a documented feature of pg_fetch_result() although the postgresql manual documents it under "SQL syntax", "Lexical structure".
PHP version 5.1.4.
psql version 8.1.4.
Use can use pg_fetch_result when getting a value (like a smallint as in this example) returned by your stored procedure
<?php
$pgConnection = pg_connect("dbname=users user=me");
$userNameToCheckFor = "metal";
$result = pg_query($pgConnection, "SELECT howManyUsersHaveThisName('$userNameToCheckFor')");
$count = pg_fetch_result($result, 0, 'howManyUsersHaveThisName');
?>