pg_trace

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

pg_trace — Включає трасування підключення PostgreSQL

Опис

pg_trace(    string $filename,    string $mode = "w",    ?PgSql\Connection $connection = null,    int $trace_mode = 0): bool

pg_trace() включає трасування з'єднання з PostgreSQL сервером у зовнішній файл. Щоб розуміти вміст таких файлів, необхідно добре розумітися на внутрішньому пристрої клієнт-серверної взаємодії.

Для тих, хто не володіє подібними навичками, трасування все ж таки може виявитися корисним для пошуку помилок при відправці запитів на сервер. Наприклад, можна виконати команду grep '^To backend' trace.log та подивитися, які запити реально надіслані на сервер. Додаткову інформацію можна отримати з » документації PostgreSQL

Список параметрів

filename

Повний шлях та ім'я файлу для запису журналу трасування. Аналогічно fopen()

mode

Необов'язковий аргумент. Режим доступу до файлу. Аналогічно fopen()

connection

Екземпляр PgSql\Connection. Якщо параметр connectionуказан как**null**, вибирається стандартне з'єднання. Стандартне з'єднання — це останнє з'єднання, яке встановила функція pg_connect() або pg_pconnect()

Увага

Починаючи з версії PHP 8.1.0, використання стандартного з'єднання застаріло.

trace_mode

Необов'язковий режим трасування з наступними константами: PGSQL_TRACE_SUPPRESS_TIMESTAMPS і PGSQL_TRACE_REGRESS_MODE

Значення, що повертаються

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

список змін

Версия	Опис
8.3.0	Добавлен параметрtrace_mode
8.1.0	Параметрconnection тепер чекає екземпляр PgSql\Connection; раніше очікувався ресурс (resource
8.0.0	connection тепер допускає значення null.

Приклади

Приклад #1 Приклад використання pg_trace()****

Loading...
▶

Дивіться також

• fopen() - Відкриває файл або URL
• pg_untrace() - Вимикає трасування з'єднання з PostgreSQL