« pg\_preparepg\_query\_params »PHP ManualФункції PostgreSQL

pg_put_line

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

pg_put_line — Передає на PostgreSQL сервер рядок із завершальним нулем

Опис

pg_put_line(PgSql\Connection $connection = ?, string $data): bool

pg_put_line() передає на PostgreSQL сервер рядок із завершальним нулем. Завершення рядка значенням NULL необхідно при його поєднанні з командою PostgreSQL COPY FROM

COPY є високошвидкісним інтерфейсом передачі, підтримуваним PostgreSQL. Дані передаються однією транзакцією та не розбираються парсером.

Як альтернативу можна використовувати функцію pg_copy_from()Она значительно проще в использовании.

Зауваження :

Перед запуском функції pg_end_copy() програма повинна повідомити про сервер про завершення передачі даних, додавши в кінець останнього рядка символи "\.".

Увага

Использованиеpg_put_line() може призвести до відмови операцій з великими об'єктами, що включають функції pg_lo_read() і pg_lo_tell(). Для цього використовуйте функції pg_copy_from() і pg_copy_to()

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

connection

Екземпляр PgSql\Connection. Якщо параметр connection не вказано, буде вибрано стандартне з'єднання. Стандартне з'єднання — це останнє з'єднання, яке встановила функція pg_connect() або pg_pconnect()

Увага

Починаючи з версії PHP 8.1.0, використання стандартного з'єднання застаріло.

data

Текстовий рядок для прямого пересилання на сервер. Завершальний NULL додається автоматично.

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

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

список змін

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

Приклади

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

Loading...

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

  • pg_end_copy() - Синхронізує з бекендом PostgreSQL