pg_trace
(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
pg_trace — 啟動一個 PostgreSQL 連線的追蹤功能
說明
pg_trace(string
$pathname
, string $mode
= ?, resource $connection
= ?): bool
pg_trace() 啟動 PostgreSQL 前端/後端通訊的追蹤並記錄到 pathname
指定的檔案中。要完全理解結果,使用者需要熟悉 PostgreSQL 通訊協議的本質。對不熟悉的使用者來說,追蹤發送到伺服器的查詢錯誤依然有用,例如可以用 grep '^To backend' trace.log 來檢視哪些查詢實際上被髮送到了 PostgreSQL 伺服器。更多資訊參考 PostgreSQL 手冊。
參數 pathname
和 mode
和 fopen()(mode
預設為 'w') 中的一樣。connection
指定了要追蹤的連線,預設為上一個打開的連線。
如果 pathname
可以作為日誌檔案打開,則
pg_trace() 返回 true
,否則返回 false
。
參見 fopen() 和 pg_untrace()。