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 实例；以前，期望一个 资源。 |
示例 #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_* 函数，使其像上述两个函数一样工作 <em>应该</em>。它们并没有很多代码，注释主要是来自 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
(要应用补丁，请进入您的 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 代码。