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