pg_close

    (PHP 4, PHP 5, PHP 7, PHP 8)

    pg_close — Schließt eine PostgreSQL-Verbindung

    Beschreibung

    pg_close(?PgSql\Connection $connection = null): true

    pg_close() schließt die nicht-persistente Verbindung, die durch die connection-Instanz bezeichnet wird.

    Hinweis:

    Die Verwendung von pg_close() ist normalerweise nicht notwendig, da geöffnete, nicht-persistente Verbindungen automatisch geschlossen werden, wenn das Skript beendet wird.

    Falls es auf dieser Verbindung geöffnete PgSql\Lob-Instanzen gibt, sollten alle PgSql\Lob-Instanzen geschlossen werden, bevor die Verbindung geschlossen wird.

    Parameter-Liste

    connection

    Eine PgSql\Connection-Instanz. Falls connection null ist, wird die Standardverbindung benutzt. Das ist die zuletzt mit pg_connect() oder pg_pconnect() aufgebaute Verbindung.

    Warnung

    Seit PHP 8.1.0 ist die Verwendung der Standardverbindung veraltet.

    Rückgabewerte

    Gibt immer true zurück.

    Changelog

    Version Beschreibung
    8.2.0 Der Rückgabewert ist nun true vorher war es bool.
    8.1.0 Der Parameter connection erwartet nun eine PgSql\Connection-Instanz; vorher wurde eine Ressource erwartet.
    8.0.0 connection ist jetzt nullbar.

    Beispiele

    Beispiel #1 pg_close()-Beispiel

    <?php
    $dbconn     = pg_connect("host=localhost port=5432 dbname=mary")
    or die(    "Keine Verbindung möglich");
    echo     "Verbindung hergestellt";
    pg_close($dbconn);
    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    Verbindung hergestellt

    Siehe auch

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    6
    amays
    19 years ago
    pg_close(...) will not technically close a persistent connection but instead returns it back to the connection pool thus giving you the desired effect of having the connection closed within your script.

    http://www.sitepoint.com/article/accessing-postgresql-php/3

    best wishes to all.
    up
    2
    mark at redbrick dot dcu dot ie
    21 years ago
    This function closes the current database connection specified by a handle returned from a pg_connect() call.

    <?php
    $pgsql_conn     = pg_connect("dbname=mark host=localhost");

    if (    $pgsql_conn) {
    print     "Successfully connected to: " . pg_host($pgsql_conn) . "<br/>\n";
    } else {
    print     pg_last_error($pgsql_conn);
    exit;
    }

    // Do database stuff here.

    if(!pg_close($pgsql_conn)) {
    print     "Failed to close connection to " . pg_host($pgsql_conn) . ": " .
    pg_last_error($pgsql_conn) . "<br/>\n";
    } else {
    print     "Successfully disconnected from database";
    }
    ?>

    Of course you normally wouldn't print a message.

    Regards, --mark
    ＋add a note
    To Top