pg_trace

(PHP 4 >= 4.0.1, PHP 5)

pg_trace Active le suivi d'une connexion PostgreSQL

Description

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

pg_trace() active le suivi des communications entre PHP et le serveur PostgreSQL. Cet historique sera enregistr� dans un fichier. Pour comprendre ces lignes, il faut �tre familier avec le protocole de communication interne � PostgreSQL.

Pour ceux qui le ne sont pas, elles peuvent �tre utiles pour suivre les requ�tes et les erreurs : avec la commande grep '^To backend' trace.log, vous pourrez voir les requ�tes r�ellement envoy�es au serveur PostgreSQL. Pour plus d'informations, r�f�rez-vous � la » Documentation PostgreSQL.

Liste de param�tres

pathname

Le chemin complet et le nom du fichier dans lequel le suivi sera enregistr�. Comme fopen().

pathname

Le mode d'acc�s optionnel, comme fopen(). La valeur par d�faut est "w".

connection

La ressource de connexion de la base de donn�es PostgreSQL. Lorsque connection n'est pas pr�sent, la connexion par d�faut est utilis�e. La connexion par d�faut est la derni�re connexion faite par pg_connect() ou pg_pconnect().

Valeurs de retour

Cette fonction retourne TRUE en cas de succ�s, FALSE en cas d'�chec.

Exemples

Exemple #1 Exemple avec 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);
   
// Maintenant /tmp/trace.log contiendra le suivi des communications
} else {
   print 
pg_last_error($pgsql_conn);
   exit;
}
?>

Voir aussi

  • fopen() - Ouvre un fichier ou une URL
  • pg_untrace() - Termine le suivi d'une connexion PostgreSQL