« pg\_send\_query\_paramspg\_set\_client\_encoding »PHP ManualФункції PostgreSQL

pg_send_query

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_send_query — Надсилає асинхронний запит

Опис

pg_send_query(PgSql\Connection $connection, string $query): int|bool

pg_send_query() відправляє виконання асинхронний запит. На відміну від pg_query() запит може містити кілька SQL-виражень, розділених крапкою з комою. Для отримання результату запиту скористайтеся функцією pg_get_result()

Виконання запиту не перериває роботу скрипта. Для визначення зайнятості з'єднання (коли запит ще виконується) використовуйте функцію pg_connection_busy(). Виконання запиту можна перервати функцією pg_cancel_query()

Незважаючи на те, що можна надіслати кілька запитів за раз, їх не можна надсилати, поки з'єднання зайняте. В іншому випадку, надісланий запит дочекається завершення попереднього, зітре його результат і запуститься сам. Таким чином, ви втратите дані результату попереднього запиту.

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

connection

Екземпляр PgSql\Connection

query

Один або кілька SQL-виражень, розділених крапкою з комою.

Спецсимволи у рядку запиту мають бути екрановані

Значення, що повертаються

Повертає true у разі успішного виконання, **false**или в случае возникновения ошибки. Для получения результата запроса используйте функциюpg_get_result()

список змін

ВерсияОпис
8.1.0Параметрconnection тепер чекає екземпляр PgSql\Connection; раніше очікувався ресурс (resource

Приклади

Приклад #1 Приклад використання pg_send_query()****

Loading...

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

Первый вызов pg_get_result(): Resource id #3
Resource id #3 содержит 3 записей

Второй вызов pg_get_result(): Resource id #4
Resource id #4 содержит 1 записей

Дивіться також

  • pg_query() - Виконує запит
  • pg_cancel_query() - Зупинення асинхронного запиту.
  • pg_get_result() - Отримання результату асинхронного запиту
  • pg_connection_busy() - Перевіряє, чи зайнято з'єднання на даний момент.