# maxdb_ping

# maxdb::ping

(PECL maxdb >= 1.0)

maxdb_ping -- maxdb::ping — Pings a server connection, or tries to reconnect if the connection has gone down

### 说明

过程化风格

maxdb_ping ( resource `$link` ) : bool

面向对象风格

maxdb::ping ( void ) : bool

Checks whether the connection to the server is working. If it has gone down, and global option maxdb.reconnect is enabled an automatic reconnection is attempted.

This function can be used by clients that remain idle for a long while, to check whether the server has closed the connection and reconnect if necessary.

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 范例

Example #1 面向对象风格

    <?php
    $maxdb = new maxdb("localhost", "MONA", "RED", "DEMODB");

    /* check connection */
    if (maxdb_connect_errno()) {
       printf("Connect failed: %s\n", maxdb_connect_error());
       exit();
    }

    /* check if server is alive */
    if ($maxdb->ping()) {
       printf ("Our connection is ok!\n");
    } else {
       printf ("Error: %s\n", $maxdb->error);
    }

    /* close connection */
    $maxdb->close();
    ?>

Example #2 过程化风格

    <?php
    $link = maxdb_connect("localhost", "MONA", "RED", "DEMODB");

    /* check connection */
    if (maxdb_connect_errno()) {
       printf("Connect failed: %s\n", maxdb_connect_error());
       exit();
    }

    /* check if server is alive */
    if (maxdb_ping($link)) {
       printf ("Our connection is ok!\n");
    } else {
       printf ("Error: %s\n", maxdb_error($link));
    }

    /* close connection */
    maxdb_close($link);
    ?>

以上例程的输出类似于：

    Our connection is ok!