pg_host

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

pg_host — 返回和某连接关联的主机名

说明

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

pg_host() 返回指定的 PostgreSQL connection 实例所连接到的主机名称。

参数

connection

An PgSql\Connection instance. When connection is null, the default connection is used. The default connection is the last connection made by pg_connect() or pg_pconnect().

警告

As of PHP 8.1.0, using the default connection is deprecated.

返回值

string, 包含 connection 的主机名，或错误时为空字符串。

更新日志

版本	说明
8.1.0	现在 `connection` 参数接受 PgSql\Connection 实例，之前接受 resource。
8.0.0	`connection` 现在可为 null。

示例

示例 #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;
}
?>

参见

pg_connect() - 打开 PostgreSQL 连接
pg_pconnect() - 打开一个持久的 PostgreSQL 连接

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 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