函式名稱:pg_set_error_context_visibility()
函式描述:該函式用於設定錯誤上下文的可見性,即決定錯誤上下文是否會在錯誤訊息中顯示。
適用版本:PHP 7.4.0 及以上版本
語法:bool pg_set_error_context_visibility(resource $connection, bool $show_context)
引數:
- $connection:PostgreSQL 連線資源,透過 pg_connect() 或 pg_pconnect() 函式獲取。
- $show_context:一個布林值,用於設定錯誤上下文的可見性。如果為 true,錯誤上下文會顯示在錯誤訊息中;如果為 false,錯誤上下文會被隱藏。
返回值:如果成功設定了錯誤上下文的可見性,則返回 true,否則返回 false。
示例:
在上面的示例中,首先使用 pg_connect() 函式建立與 PostgreSQL 資料庫的連線。然後,使用 pg_set_error_context_visibility() 函式將錯誤上下文的可見性設定為 true,即在錯誤訊息中顯示錯誤上下文。
接下來,執行一條錯誤的 SQL 查詢(SELECT * FROM non_existent_table),這將導致出現一個錯誤。使用 pg_last_error() 函式獲取最後一次錯誤的詳細資訊,並使用 echo 語句將錯誤訊息列印出來。
最後,使用 pg_close() 函式關閉資料庫連線。
注意:pg_set_error_context_visibility() 函式只能在與 PostgreSQL 資料庫的連線資源上呼叫,因此在呼叫該函式之前,需要先建立資料庫連線。