トップページ　→関数リファレンス　→データベース関連　→ベンダー固有のモジュール　→PostgreSQL　→PostgreSQL 関数

関数・クラス解説

pg_set_error_verbosity

version:PHP 5 >= 5.1.0, PHP 7 (公式)

pg_last_error() および pg_result_error() が返すメッセージの詳細度を指定する

公式リファレンス

書式

pg_set_error_verbosity ([ resource $connection ], int $verbosity ) : int

説明

pg_last_error() および pg_result_error() が返すメッセージの詳細度を指定します。

pg_set_error_verbosity() は詳細度を設定し、その接続のこれまでの設定を返します。PGSQL_ERRORS_TERSE モードでは、返されるメッセージは深刻度・概要および発生位置のみです。これはたいていの場合 1 行に収まります。デフォルトのモード（PGSQL_ERRORS_DEFAULT）では、それに加えて何らかの詳細情報・ヒントあるいは状況フィールドを含みます（これらは複数行にまたがる可能性があります）。PGSQL_ERRORS_VERBOSE モードは、有効なフィールドをすべて含みます。詳細度の設定変更内容はそれ以降に新しく作成した結果オブジェクトにのみ反映され、既存の結果オブジェクトには影響を与えません。

パラメータ

connection: PostgreSQL データベース接続リソース。connection が指定されていない場合はデフォルトの接続が使用されます。デフォルトの接続は、直近の pg_connect() あるいは pg_pconnect() によって作成されたものです。
verbosity: 指定する詳細度。PGSQL_ERRORS_TERSE、 PGSQL_ERRORS_DEFAULT あるいは PGSQL_ERRORS_VERBOSE 。

返値

変更前の詳細度レベル。PGSQL_ERRORS_TERSE、 PGSQL_ERRORS_DEFAULT あるいは PGSQL_ERRORS_VERBOSE のいずれかを返します。

サンプル

例1 pg_set_error_verbosity() の例 

  $dbconn = pg_connect("dbname=publisher") or die("Could not connect");

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