# 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 连接

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open