pg_update
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_update — Оновлення даних у таблиці
Опис
pg_update( PgSql\Connection $connection, string $table_name, array $values, array $conditions, int $flags = PGSQL_DML_EXEC): string|bool
pg_update() замінює записи у таблиці, що задовольняють умовам conditions даними values
Якщо flagsуказан,pg_convert()применяется кvalues із зазначеними прапорами.
По умолчаниюpg_update() передає необроблені значення. Значення мають бути екрановані або опція PGSQL_DML_ESCAPE має бути вказана . PGSQL_DML_ESCAPE укладає в лапки та екранує параметри/ідентифікатори. Тому імена таблиць/стовпців стають чутливими до регістру.
Зверніть увагу, що ні екранування, ні підготовлений запит не захистять запит LIKE, JSON, масив, регулярні вирази і т.д. слід екранувати/перевіряти значення.
Список параметрів
connection
Екземпляр PgSql\Connection
table_name
Ім'я таблиці, де оновлюються записи.
values
Масив (array), ключі якого відповідають іменам колонок таблиці table_name, а значення замінять дані у цих колонках.
condition
Масив (array), ключі якого відповідають іменам колонок таблиці table_name. Буде оновлено лише рядки, значення полів яких збігатимуться зі значеннями масиву.
flags
Одна из констант**PGSQL_CONV_OPTS** PGSQL_DML_NO_CONV PGSQL_DML_ESCAPE PGSQL_DML_EXEC **PGSQL_DML_ASYNC** або **PGSQL_DML_STRING**або їх комбінація. Якщо flags містить PGSQL_DML_STRING, функція поверне рядок. Якщо встановлено PGSQL_DML_NO_CONV або PGSQL_DML_ESCAPE, то функцияpg_convert() внутрішньо не викликається.
Значення, що повертаються
Повертає true у разі успішного виконання або false у разі виникнення помилки. Функція поверне рядок (string), якщо константа PGSQL_DML_STRING міститься в flags
список змін
| Версия | Опис |
|---|---|
| 8.1.0 | Параметрconnection тепер чекає екземпляр PgSql\Connection; раніше очікувався ресурс (resource |
Приклади
Приклад #1 Приклад використання pg_update()****
Дивіться також
- pg_convert() - Перетворює значення асоціативного масиву на відповідний для SQL-запитів вид