pg_cancel_query
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_cancel_query — Löscht eine asynchrone Abfrage
Beschreibung
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.
Rückgabewerte
Gibt bei Erfolg true
zurück. Bei einem Fehler wird false
zurückgegeben.
Changelog
Version | Beschreibung |
---|---|
8.1.0 |
Der Parameter connection erwartet nun eine PgSql\Connection-Instanz;
vorher wurde eine Ressource erwartet.
|
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
- pg_send_query() - Sendet eine asynchrone Abfrage
- pg_connection_busy() - Gibt den Status der Verbindung zurück (busy/not busy)