pg_host

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

pg_host — Liefert den Namen des Host, zu dem verbunden wurde

Beschreibung

pg_host(?PgSql\Connection $connection = null): string

pg_host() gibt den Namen des Hosts zurück, zu dem mit der angegebenen PostgreSQL connection-Instanz verbunden wurde.

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

Ein string, der den Namen des Hosts enthält, zu dem die connection besteht oder ein leerer String, falls ein Fehler auftrat.

Changelog

Version	Beschreibung
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_host()-Beispiel

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

if ($pgsql_conn) {
   print "Sie sind verbunden mit: " . pg_host($pgsql_conn) . "<br/>\n";
} else {
   print pg_last_error($pgsql_conn);
   exit;
}
?>

Siehe auch

pg_connect() - Öffnet eine PostgreSQL-Verbindung
pg_pconnect() - Öffnet eine persistente PostgreSQL-Verbindung

add a note

User Contributed Notes 1 note

down

mark at redbrick dot dcu dot ie ¶

21 years ago


This is a simple example of this function, which returns the name of which PostreSQL Database you are currently connected to.

<?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;
    }
?>

This function is extremely useful for sites which connect to multiple Postgresql services.

Regards,  --mark

add a note