pg_insert
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
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()
使用指定 flag 应用于 values。
默认情况下 pg_insert() 传递原始值。值必须转义或必须在 flags
中指定 PGSQL_DML_ESCAPE flag。PGSQL_DML_ESCAPE
引用并转义参数/标识符。因此，表/列名称变得区分大小写。
注意转义和预处理查询都不能保护 LIKE 查询、JSON、Array、Regex 等，这些参数要根据上下文来处理。即转义/验证值。
参数
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。如果通过 flags 传递 PGSQL_DML_STRING，成功时返回 string。
更新日志
| 版本 | 说明 |
|---|---|
| 8.3.0 |
当指定的表无效时，现在会抛出 ValueError 错误；之前触发 E_WARNING。
|
| 8.3.0 |
当字段的值或类型不能正确匹配 PostgreSQL 的类型时，现在会抛出 ValueError 或
TypeError 错误；之前触发 E_WARNING。
|
| 8.1.0 | 现在返回 PgSql\Result 实例，之前返回 resource |
| 8.1.0 |
现在 connection 参数接受 PgSql\Connection
实例，之前接受 resource。
|
示例
示例 #1 pg_insert() 示例
<?php
$dbconn = pg_connect('dbname=foo');
// 在某种程度上安全，因为所有值都转义了。
// 然而 PostgreSQL 支持 JSON/Array。无论是
// 转义还是预处理都不安全。
$res = pg_insert($dbconn, 'post_log', $_POST, PGSQL_DML_ESCAPE);
if ($res) {
echo "POST data is successfully logged\n";
} else {
echo "User must have sent wrong inputs\n";
}
?>