# pg_ping

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

pg_ping — Ping 数据库连接

### 说明

pg_ping(?PgSql\Connection `$connection` = `null`): bool

pg_ping() ping 数据库连接，如果中断则尝试重新连接。

### 参数

`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.

### 返回值

成功时返回 `true`， 或者在失败时返回 `false`。

### 更新日志

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

### 示例

示例 #1 pg_ping() 示例

`<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "An error occurred.\n";
exit;
}
if (!pg_ping($conn))
die("Connection is broken\n");
?>`

### 参见

- pg_connection_status() - 获取连接状态
- pg_connection_reset() - 重置连接（再次连接）

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