(PHP 5 >= 5.1.0, PHP 7, PHP 8)
pg_set_error_verbosity — 決定 pg_last_error() 和 pg_result_error() 所返回訊息的詳細程度
決定 pg_last_error() 和 pg_result_error() 返回訊息的詳細程度。
pg_set_error_verbosity() 設定詳細程度模式,並返回連線先前的設定。在 PGSQL_ERRORS_TERSE
模式下,返回的訊息僅包含嚴重性、主要訊息文字和位置;這通常會在一行內顯示。預設模式 (PGSQL_ERRORS_DEFAULT
) 產生的訊息包含上述內容以及任何詳細資訊、提示或上下文欄位(這些欄位可能跨越多行)。PGSQL_ERRORS_VERBOSE
模式包含所有可用的欄位。更改詳細程度不會影響已存在的結果物件可用的訊息,僅影響後續建立的物件。
connection
一個 PgSql\Connection 實例。當未指定 connection
時,將使用預設連線。預設連線是 pg_connect() 或 pg_pconnect() 建立的最後一個連線。
從 PHP 8.1.0 開始,不建議使用預設連線。
verbosity
所需的詳細程度:PGSQL_ERRORS_TERSE
、PGSQL_ERRORS_DEFAULT
或 PGSQL_ERRORS_VERBOSE
。
先前的詳細程度:PGSQL_ERRORS_TERSE
、PGSQL_ERRORS_DEFAULT
或 PGSQL_ERRORS_VERBOSE
。
版本 | 說明 |
---|---|
8.1.0 | connection 參數現在需要一個 PgSql\Connection 實例;以前需要一個 資源。 |
範例 #1 pg_set_error_verbosity() 範例
<?php
$dbconn = pg_connect("dbname=publisher") or die("無法連線");
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);
?>