pg_transaction_status

    (PHP 5 >= 5.1.0, PHP 7, PHP 8)

    pg_transaction_status — Gibt den aktuellen Transaktionsstatus des Servers zurück

    Beschreibung

    pg_transaction_status(PgSql\Connection$connection): int

    Gibt den aktuellen Transaktionsstatus des Servers zurück.

    Achtung

    Die Funktion pg_transaction_status() gibt ungültige Ergebnisse zurück, wenn sie für einen PostgreSQL-Server der Version 7.3 aufgerufen wird, bei dem der Parameter autocommit auf off gesetzt ist. Die serverseitige Eigenschaft autocommit ist veraltet und existiert in den neueren PostgreSQL-Versionen nicht mehr.

    Parameter-Liste

    connection

    Eine PgSql\Connection-Instanz.

    Rückgabewerte

    Mögliche Stati sind: PGSQL_TRANSACTION_IDLE (zur Zeit untätig), PGSQL_TRANSACTION_ACTIVE (ein Kommando wird abgearbeitet), PGSQL_TRANSACTION_INTRANS (untätig, aber innerhalb eines gültigen Transaktionsblocks) oder PGSQL_TRANSACTION_INERROR (untätig, innerhalb einer fehlgeschlagenen Transaktion). PGSQL_TRANSACTION_UNKNOWN wird zurückgegeben, falls eine Transaktion ungültig ist. PGSQL_TRANSACTION_ACTIVE wird nur dann zurückgegeben, wenn eine Abfrage zum Server gesendet wurde und noch nicht fertig abgearbeitet ist.

    Changelog

    VersionBeschreibung
    8.1.0 Der Parameter connection erwartet nun eine PgSql\Connection-Instanz; vorher wurde eine Ressource erwartet.

    Beispiele

    Beispiel #1 pg_transaction_status()-Beispiel

    <?php
    $dbconn     = pg_connect("dbname=publisher") or die("Konnte nicht verbinden");
    $stat = pg_transaction_status($dbconn);
    if (    $stat === PGSQL_TRANSACTION_UNKNOWN) {
    echo     'Verbindung ist ungültig';
    } else if (    $stat === PGSQL_TRANSACTION_IDLE) {
    echo     'Verbindung ist zur Zeit untätig';
    } else {
    echo     'Verbindung meldet eine Transaktion';
    }
    ?>
    To Top