PostgreSQL 関数
PHP マニュアル

pg_result_error

結果に関連するエラーメッセージを取得する

説明

stringfalse pg_result_error(PgSql\Result $result)

pg_result_error は、結果インスタンス (result)に関連したエラーメッセージを返します。 このため、ユーザーが pg_last_error よりも適切な エラーメッセージを得る可能性があります。

pg_result_error_field は、 pg_result_error よりもさらに詳細なエラー情報を 返します。

pg_query はクエリが失敗した場合に false を返すので、 結果ハンドルを取得するには pg_send_query および pg_get_result を使用する必要があります。

パラメータ

result

pg_query、pg_query_params や (様々な関数がありますが、特に) pg_execute が返した PgSql\Result クラスのインスタンス。

戻り値

文字列を返します。エラーがない場合は空文字列を返します。 result パラメータに関連付けられたエラーがある場合は それを文字列で返します。それ以外の場合は false を返します。

変更履歴

バージョン 説明
8.1.0 result は、PgSql\Result クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、リソース を期待していました。

例

例1 pg_result_error の例

<?php
  $dbconn = pg_connect("dbname=publisher") or die("接続できませんでした");

  if (!pg_connection_busy($dbconn)) {
      pg_send_query($dbconn, "select * from doesnotexist;");
  }
  
  $res1 = pg_get_result($dbconn);
  echo pg_result_error($res1);
?>

参考

  • pg_result_error_field
  • pg_query
  • pg_send_query
  • pg_get_result
  • pg_last_error
  • pg_last_notice