PHP: Hypertext Preprocessor (original) (raw)
pg_trace
(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
pg_trace — Enable tracing a PostgreSQL connection
Description
For those who are not, it can still be useful for tracing errors in queries sent to the server, you could do for example grep '^To backend' trace.log and see what queries actually were sent to the PostgreSQL server. For more information, refer to the» PostgreSQL Documentation.
Return Values
Returns [true](reserved.constants.php#constant.true) on success or [false](reserved.constants.php#constant.false) on failure.
Changelog
| Version | Description |
|---|---|
| 8.3.0 | trace_mode has been added. |
| 8.1.0 | The connection parameter expects an PgSql\Connection instance now; previously, a resource was expected. |
| 8.0.0 | connection is now nullable. |
Examples
Example #1 pg_trace() example
`<?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;
}
?>`
See Also
- fopen() - Opens file or URL
- pg_untrace() - Disable tracing of a PostgreSQL connection