pg_result_error 不适用于预处理语句。
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_result_error — 获取与结果关联的错误信息
pg_result_error() 返回与 result 实例关联的任何错误信息。因此，与 pg_last_error() 相比，用户更有可能获得正确的错误信息。
函数 pg_result_error_field() 可以提供比 pg_result_error() 更详细的结果错误信息。
由于 pg_query() 在查询失败时返回 false，因此您必须使用 pg_send_query() 和 pg_get_result() 来获取结果句柄。
| 版本 | 说明 |
|---|---|
| 8.1.0 | 现在 result 参数需要一个 PgSql\Result 实例；之前需要一个资源(resource)。 |
示例 #1 pg_result_error() 例子
<?php
$dbconn = pg_connect("dbname=publisher") or die("Could not connect");
if (!pg_connection_busy($dbconn)) {
pg_send_query($dbconn, "select * from doesnotexist;");
}
$res1 = pg_get_result($dbconn);
echo pg_result_error($res1);
?>
考虑到 pg_query 和 pg_query_params 在出错时不返回结果，而且这是一个非常有用的功能，我最终编写了自己的函数来封装 pg_send_* 系列函数，使其像前面提到的两个函数那样工作。它们的代码并不多，注释主要是 libPQ 和 PHP 文档的引用，用于解释其行为。
<?php
class PostgresConnectionError extends Exception {
public function __construct($last_error) {
parent::__construct($message);
}
}
function pg_send_query_sync($connection, string $query) {
// 如果该连接已经有任何查询正在运行，则此函数无法工作，因为结果可能会混淆。
assert(pg_get_result($connection) === false);
$dispatch_ok = pg_send_query($connection, $query);
// 唯一无法返回任何内容的情况是连接无法分派初始查询。
if (!$dispatch_ok) throw new PostgresConnectionError(pg_last_error($connection));
// 来自 libPQ 文档：“必须重复调用 PQgetResult，直到它返回一个空指针，表示命令已完成。”
// 在我们尝试模拟的 pg_query/PQExec 的情况下：
// “但请注意，返回的 PGresult 结构仅描述从字符串执行的最后一个命令的结果。”
// “如果其中一个命令失败，则字符串的处理将停止，并且返回的 PGresult 描述错误情况。”
while ($result = pg_get_result($connection)) {
// 清空连接上的所有结果，只返回最后一个。
if ($last_result) pg_free_result($last_result);
$last_result = $result;
}
assert(is_resource($result) && get_resource_type($result) === "pgsql result");
return $last_result;
}
function pg_send_query_params_sync($connection, string $query, array $params) {
// 如果该连接已经有任何查询正在运行，则此函数无法工作，因为结果可能会混淆。
assert(pg_get_result($connection) === false);
$dispatch_ok = pg_send_query_params($connection, $query, $params);
// 唯一无法返回任何内容的情况是连接无法分派初始查询。
if (!$dispatch_ok) throw new PostgresConnectionError(pg_last_error($connection));
// 来自 libPQ 文档：“必须重复调用 PQgetResult，直到它返回一个空指针，表示命令已完成。”
// 在我们尝试模拟的 pg_query_params/PQExecParams 的情况下：
// “与 PQexec 不同，PQexecParams 最多允许在给定字符串中使用一个 SQL 命令。（其中可以有分号，但不能有多个非空命令。）”
while ($result = pg_get_result($connection)) {
// 清空连接上的所有结果，尽管应该只有一个。
if ($last_result) pg_free_result($last_result);
$last_result = $result;
}
assert(is_resource($result) && get_resource_type($result) === "pgsql result");
return $last_result;
}由于 pg_query() 在查询失败时返回 FALSE，因此您必须使用 pg_send_query() 和 pg_get_result() 来获取结果句柄。
PostgreSQL 7.4 引入了一个名为 PQresultErrorField() 的新函数，可用于从查询中获取 SQLSTATE 代码，这比从 pg_result_error() 返回的错误字符串有用得多。
https://postgresql.ac.cn/docs/7.4/static/libpq-exec.html
https://postgresql.ac.cn/docs/7.4/static/errcodes-appendix.html
这是一个将 pg_result_error_field() 函数添加到 PHP 的补丁
http://collapsed.net/patches/php-4.3.5RC3-pg_result_error_field.diff
（要应用补丁，请 cd 进入您的 php-4.3.5RC 目录并键入：patch -p1 </path/to/php-4.3.5RC3-pg_result_error_field.diff）
示例代码
<?php
if(!($db = pg_connect("user=foo password=bar dbname=foobar")))
die("pg_connect");
if(!pg_send_query($db, "SELECT foo FROM bar"))
die("pg_send_query");
if(!($result = pg_get_result($db)))
die("pg_get_result");
echo(pg_result_error($result) . "<br />\n");
/* 仅在您修补了 php 后才可用 */
if(function_exists("pg_result_error_field"))
{
$fieldcode = array(
"PGSQL_DIAG_SEVERITY", "PGSQL_DIAG_SQLSTATE",
"PGSQL_DIAG_MESSAGE_PRIMARY", "PGSQL_DIAG_MESSAGE_DETAIL",
"PGSQL_DIAG_MESSAGE_HINT", "PGSQL_DIAG_STATEMENT_POSITION",
"PGSQL_DIAG_CONTEXT", "PGSQL_DIAG_SOURCE_FILE",
"PGSQL_DIAG_SOURCE_LINE", "PGSQL_DIAG_SOURCE_FUNCTION");
foreach($fieldcode as $fcode)
{
printf("%s: %s<br />\n",
$fcode,
pg_result_error_field($result, constant($fcode)));
}
pg_free_result($result);
}
?>
<?php pg_result_error_field($result, PGSQL_DIAG_SQLSTATE); ?>
返回 SQLSTATE 代码。