pg_host
(PHP 4, PHP 5, PHP 7, PHP 8)
pg_host — 接続に関連するホスト名を返す
説明
pg_host() は、指定した
connection
インスタンスが接続しているホストの
名前を返します。
パラメータ
connection
-
PgSql\Connection クラスのインスタンス。
connection
がnull
, の場合、デフォルトの接続を使います。 デフォルトの接続とは、pg_connect() または pg_pconnect() によって確立された直近の接続です。警告PHP 8.1.0 以降では、デフォルトの接続を使うことは推奨されなくなりました。
戻り値
connection
が接続しているホストの名前を
文字列で返します。エラー時には空の文字列を返します。
変更履歴
バージョン | 説明 |
---|---|
8.1.0 |
connection は、PgSql\Connection クラスのインスタンスを期待するようになりました。
これより前のバージョンでは、リソース を期待していました。
|
8.0.0 |
connection は、nullable になりました。
|
例
例1 pg_host() の例
<?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;
}
?>
+add a note
User Contributed Notes 1 note
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