检查与服务器的连接是否正常。如果连接已断开且启用了自动重新连接，则会尝试重新连接。如果连接已断开且禁用了自动重新连接，mysql_ping() 将返回错误。

默认情况下，自动重新连接处于禁用状态。要启用它，请使用 MYSQL_OPT_RECONNECT 选项（已弃用）调用 mysql_options()。有关详细信息，请参阅第 5.4.54 节 “mysql_options()”。

长时间处于空闲状态的客户端可以使用 mysql_ping() 检查服务器是否已关闭连接，并在必要时重新连接。

如果 mysql_ping() 确实导致重新连接，则不会明确指示。要确定是否发生重新连接，请在调用 mysql_ping() 之前调用 mysql_thread_id() 获取原始连接标识符，然后再次调用 mysql_thread_id() 以查看标识符是否已更改。

如果发生重新连接，则连接的某些特征将被重置。有关这些特征的详细信息，请参阅第 3.6.8 节 “自动重新连接控制”。

如果与服务器的连接处于活动状态，则为零。如果发生错误，则为非零值。非零返回值并不表示 MySQL 服务器本身已关闭；连接可能由于其他原因（例如网络问题）而断开。