pg_send_query

(PHP 4 >= 4.2.0)

pg_send_query -- Exécute une requête PostGreSQL asynchrone

Description

bool pg_send_query ( resource connection, string query)

bool pg_send_query ( string query)

pg_send_query() exécute la requête query sur la connexion connection, de manière asynchrone. Contrairement à pg_query(), cette fonction permet d'envoyer plusieurs requêtes à un serveur PostgreSQL et de lire les résultats un par un, avec la fonction pg_get_result(). L'exécution du script n'est pas bloquée durant l'exécution de la requête. Utilisez pg_connection_busy() pour vérifier si la connexion est encore occupée. Les requêtes peuvent être annulées avec pg_cancel_query().

Bien que l'on puiss envoyer plusieurs requêtes en même temps, il n'est pas possible d'envoyer plusieurs requêtes sur une connexion occupée. Si une requête est envoyée alors que la connexion est occupée, elle attendra que la requête précédente soit finie.

Exemple 1. Exécute une requête PostGreSQL asynchrone

<?php
    $dbconn
= pg_connect("dbname=publisher") or die("Impossible de se connecter");

    if (!
pg_connection_busy($dbconn)) {
        
pg_send_query($dbconn,"select * from authors; select count(*) from authors;");
    }
    
    
$res1 = pg_get_result($dbconn);
    echo
"Premier appel &agrave; pg_get_result() : $res1\n";
    
$rows1 = pg_num_rows($res1);
    echo
"$res1 has $rows1 records\n\n";
    
    
$res2 = pg_get_result($dbconn);
    echo
"Second appel &agrave; pg_get_result() : $res2\n";
    
$rows2 = pg_num_rows($res2);
    echo
"$res2 has $rows2 records\n";
?>

L'exemple ci-dessus pourrait afficher :

Premier appel &agrave; pg_get_result() : Resource id #3
Resource id #3 has 3 records

Second appel &agrave; pg_get_result() : Resource id #4
Resource id #4 has 1 records

Voir aussi pg_query(), pg_cancel_query(), pg_get_result() et pg_connection_busy().