array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => '69fbbd3a2ae68.php', 1 => NULL, 2 => NULL, ), 'up' => array ( 0 => NULL, 1 => NULL, ), 'prev' => array ( 0 => NULL, 1 => NULL, ), 'next' => array ( 0 => NULL, 1 => NULL, ), 'alternatives' => array ( ), 'source' => NULL, 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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(). Il n'est pas possible d'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 resource é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