pg_insert - Заносит данные из массива в таблицу базы данных
Вернуться к: PostgreSQL
pg_insert
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
pg_insert — Заносит данные из массива в таблицу базы данных
Описание
$connection
, string $table_name
, array $assoc_array
[, int $options
= PGSQL_DML_EXEC
] )
pg_insert() вставляет записи из массива
assoc_array
в таблицу table_name
.
Если задан аргумент options
, значения массива
будут преобразованы функцией pg_convert()
соответствии с параметрами из этого аргумента.
Список параметров
-
connection
-
Ресурс соединения с базой данных PostgreSQL.
-
table_name
-
Имя таблицы для вставки данных. Количество колонок в таблице
table_name
должно быть не меньше, чем элементов в массивеassoc_array
. -
assoc_array
-
Ассоциативный массив(array), в котором ключи являются названиями колонок таблицы
table_name
, а значения - записи, которые необходимо вставить в эти колонки. -
options
-
Комбинация констант
PGSQL_CONV_OPTS
,PGSQL_DML_NO_CONV
,PGSQL_DML_ESCAPE
,PGSQL_DML_EXEC
,PGSQL_DML_ASYNC
иPGSQL_DML_STRING
. Если в числе прочих передаетсяPGSQL_DML_STRING
в параметреoptions
, функция вернет строку запроса. Если установленыPGSQL_DML_NO_CONV
илиPGSQL_DML_ESCAPE
, то функция pg_convert() внутренне не вызывается.
Возвращаемые значения
Возвращает TRUE
в случае успешного завершения или FALSE
в случае возникновения ошибки. Возвращает строку(string), если PGSQL_DML_STRING
включена в список параметров аргумента options
.
Примеры
Пример #1 Пример использования pg_insert()
<?php
$dbconn = pg_connect('dbname=foo');
// Это безопасно с тех пор как $_POST преобразуется автоматически
$res = pg_insert($dbconn, 'post_log', $_POST);
if ($res) {
echo "Данные из POST успешно внесены в журнал\n";
} else {
echo "Пользователь прислал неверные данные\n";
}
?>
Список изменений
Версия | Описание |
---|---|
5.6.0 |
Больше не является экспериментальной. Добавлена константа PGSQL_DML_ESCAPE ,
TRUE /FALSE и NULL типы данных теперь поддерживаются.
|
5.5.3/5.4.19 |
Исправлены прямые SQL-инъекции в table_name
и непрямые SQL-инъекции в идентификаторах.
|
Смотрите также
- pg_convert() - Преобразует значения ассоциативного массива в приемлемые для использования в SQL запросах
Вернуться к: PostgreSQL