pg_cancel_query

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

pg_cancel_query Annule une requête asynchrone

Description

pg_cancel_query(PgSql\Connection $connection): bool

pg_cancel_query() annule la requête asynchrone, démarrée avec pg_send_query(), pg_send_query_params() ou pg_send_execute(). Vous ne pouvez pas annuler une requête démarrée avec pg_query().

Liste de paramètres

connection

Une instance PgSql\Connection.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Historique

Version Description
8.1.0 Le paramètre connection attend désormais une instance de PgSql\Connection ; auparavant, une ressource était attendu.

Exemples

Exemple #1 Exemple avec pg_cancel_query()

<?php
  $dbconn 
pg_connect("dbname=publisher") or die("Connexion impossible");

  if (!
pg_connection_busy($dbconn)) {
      
pg_send_query($dbconn"select * from auteurs; select count(*) from auteurs;");
  }
  
  
$res1 pg_get_result($dbconn);
  echo 
"Premier appel de pg_get_result() : $res1\n";
  
$rows1 pg_num_rows($res1);
  echo 
"$res1 a $rows1 enregistrements\n\n";
  
  
// Annule la requête en cours de fonctionnement. Ce sera la deuxième requête
  // elle fonctionne encore.
  
pg_cancel_query($dbconn);
?>

L'exemple ci-dessus va afficher :

Premier appel de pg_get_result() : Resource id #3
Resource id #3 a 3 enregistrements

Voir aussi