pg_cancel_query

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

pg_cancel_query — Löscht eine asynchrone Abfrage

Beschreibung

pg_cancel_query ( resource $connection ) : bool

pg_cancel_query() löscht eine asynchrone Abfrage, die mit pg_send_query(), pg_send_query_params() oder pg_send_execute() an den Datenbankserver gesendet wurde. Eine Abfrage, die mit pg_query() gesendet wurde, kann nicht gelöscht werden.

Parameter-Liste

connection

PostgreSQL Verbindungskennung.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Beispiele

Beispiel #1 pg_cancel_query() Beispiel

<?php
  $dbconn = pg_connect("dbname=publisher") or die("Keine Verbindung möglich");

  if (!pg_connection_busy($dbconn)) {
      pg_send_query($dbconn, "select * from authors; select count(*) from authors;");
  }
  
  $res1 = pg_get_result($dbconn);
  echo "Erster Aufruf von pg_get_result(): $res1\n";
  $rows1 = pg_num_rows($res1);
  echo "$res1 hat $rows1 Zeilen.\n\n";
  
  // Die aktuell ausgeführte Abfrage löschen. Falls die 
  // erste Abfrage abgeschlossen ist, wird die zweite 
  // gelöscht,sofern sie noch nicht beendet ist.
  pg_cancel_query($dbconn);
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Erster Aufruf von pg_get_result(): Resource id #3
Resource id #3 hat 3 Zeilen.

Siehe auch