(PHP 4, PHP 5, PHP 7, PHP 8)
pg_fetch_object — Выбирает строку результата запроса и возвращает данные в виде объекта
$result
,$row
= null
,$class
= "stdClass",$constructor_args
= []pg_fetch_object() возвращает объект, свойства которого соответствуют именам полей выборки. Также функция может создать экземпляр конкретного класса и передать параметры его конструктору.
Замечание: Эта функция устанавливает NULL-поля в значение
null
PHP.
По скорости функция идентична pg_fetch_array() и немного медленней pg_fetch_row() (разница незначительна).
result
Экземпляр PgSql\Result, возвращаемый функциями pg_query(), pg_query_params() или pg_execute() (среди прочего).
row
Номер выбираемой из результата запроса строки. Нумерация начинается
с нуля. Если аргумент опущен или равен null
, берётся следующая по
очереди строка.
class
Имя класса создаваемого и возвращаемого объекта. Если не задано, функция создаст экземпляр класса stdClass.
constructor_args
Необязательный аргумент. Массив (array) параметров для передачи в конструктор
создаваемого объекта (class
).
Объект (object), имена и значения свойств которого соответствуют
именам и значениям полей результата запроса. Значения NULL
базы данных преобразуются в PHP null
.
false
, когда row
превышает число строк в
результате запроса, когда строк в результате не осталось, и при
прочих ошибках.
Версия | Описание |
---|---|
8.1.0 |
Параметр result теперь ожидает экземпляр PgSql\Result; ранее ожидался ресурс (resource).
|
Пример #1 Пример использования pg_fetch_object()
<?php
$database = "store";
$db_conn = pg_connect("host=localhost port=5432 dbname=$database");
if (!$db_conn) {
echo "Невозможно соединиться с базой postgres $database\n";
exit;
}
$qu = pg_query($db_conn, "SELECT * FROM books ORDER BY author");
while ($data = pg_fetch_object($qu)) {
echo $data->author . " (";
echo $data->year . "): ";
echo $data->title . "<br />";
}
pg_free_result($qu);
pg_close($db_conn);
?>