PHP 8.4.2 Released!

pg_set_chunked_rows_size

(PHP 8 >= 8.4.0)

pg_set_chunked_rows_sizeУстанавливает для подключения режим, в котором результаты запроса извлекаются частями

Описание

pg_set_chunked_rows_size(PgSql\Connection $connection, int $size): bool

Функция устанавливает для подключения режим извлечения результатов по частям. Результаты запроса, которые возвращаются функцией получения данных, разделяются на части, каждая из которых содержит количество строк, которое указали в аргументе size. Функцию вызывают перед получением результатов функцией pg_get_result(). Функция доступна только с библиотекой libpq версии 17 или выше.

Список параметров

connection

Экземпляр класса PgSql\Connection.

size
Количество строк, которое требуется извлечь в каждой части.

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Ошибки

Функция выбросит ошибку ValueError, если значение аргумента size меньше, чем 1.

Примеры

Пример #1 Пример установки режима частичного извлечения результатов функцией pg_result_memory_size()

<?php

$conn
= pg_connect($conn_str);

for (
$i = 0; $i < 10; $i ++) {
pg_query($conn, "INSERT INTO users DEFAULT VALUES");
}

pg_send_query($conn, "SELECT * FROM users");
pg_set_chunked_rows_size($conn, 1);

$result = pg_get_result($conn);
var_dump(pg_num_rows($result));

// Ни на что не влияет после получения результата
var_dump(pg_set_chunked_rows_size($conn, 10));

?>

Результат выполнения приведённого примера:

int(1)
bool(false)

Смотрите также

  • pg_get_result() - Получает результат асинхронного запроса
  • pg_result_status() - Возвращает статус результата запроса
Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top