在线文档教程
PHP

pg_trace

pg_trace

(PHP 4 >= 4.0.1, PHP 5, PHP 7)

pg_trace — 启用跟踪PostgreSQL连接

描述

bool pg_trace ( string $pathname [, string $mode = "w" [, resource $connection ]] )

pg_trace()启用将PostgreSQL前端/后端通信跟踪到文件。为了充分理解结果,需要熟悉PostgreSQL通信协议的内部。

对于那些不支持的人来说,它仍然可以用于跟踪发送到服务器的查询中的错误,例如,您可以执行grep'^后端'trace.log并查看实际发送到PostgreSQL服务器的查询。有关更多信息,请参阅»PostgreSQL文档。

参数

pathname

在其中写入跟踪日志的文件的完整路径和文件名。和fopen()一样。

mode

可选的文件访问模式,与fopen()相同。

connection

PostgreSQL数据库连接资源。如果connection不存在,则使用默认连接。默认连接是pg_connect()或pg_pconnect()所做的最后一个连接。

返回值

成功时返回TRUE或失败时返回FALSE

例子

示例#1 pg_trace()示例

<?php $pgsql_conn = pg_connect("dbname=mark host=localhost" if ($pgsql_conn) {    pg_trace('/tmp/trace.log', 'w', $pgsql_conn    pg_query("SELECT 1"    pg_untrace($pgsql_conn    // Now /tmp/trace.log will contain backend communication } else {    print pg_last_error($pgsql_conn    exit; } ?>