pg_execute

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

pg_execute — Запускає виконання раніше підготовленого параметризованого запиту та чекає на результат

Опис

pg_execute(PgSql\Connection $connection = ?, string $stmtname, array $params): PgSql\Result|false

Запускає виконання раніше підготовленого параметризованого запиту та чекає на результат.

pg_execute() аналог функції pg_query_params(), тільки замість рядка із запитом приймає ім'я попередньо підготовленого SQL-запиту. Це дозволяє багаторазово виконувати один раз створені запити з різними параметрами. Сам запит має бути заздалегідь підготовлений у поточній сесії . pg_execute() підтримується PostgreSQL версії 7.4 та вище. Функція не працюватиме на з'єднаннях із сервером ранніх версій.

Аргументи функції ті ж, що й у pg_query_params(), за винятком імені попередньо складеного запиту, який передається замість рядка із запитом.

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

connection

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

Увага

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

stmtname

Ім'я підготовленого до виконання запиту. Якщо передано порожній рядок "", буде виконано безіменний запит. Ім'я та вміст запиту мають бути підготовлені функцією pg_prepare() pg_send_prepare() або за допомогою SQL-команди PREPARE

params

Масив значень параметрів запиту для заміни псевдозмінних $1, $2 і т.д. у вихідному рядку запиту. Кількість елементів масиву має точно збігатися з кількістю псевдозмінних.

Увага

Елементи масиву будуть перетворені на рядки.

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

Екземпляр PgSql\Result у разі успішного виконання або **false**в случае возникновения ошибки.

список змін

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

Приклади

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

Loading...

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

pg_prepare() - Надсилає запит на створення параметризованого SQL виразу і чекає на його завершення
pg_send_prepare() - Надсилає запит на створення параметризованого SQL-виразу, не чекаючи його завершення
pg_query_params() - Надсилає параметризований запит на сервер, параметри передаються окремо від тексту SQL запиту