Manual do PHP
Anterior |  | Próxima

# mysqli_ping

(PHP 5 CVS only)

mysqli_ping

(no version information, might be only in CVS)

mysqli->ping -- Pings a server connection, or tries to reconnect if the connection has gone down.

## Description

Procedural style:

bool mysqli_ping ( object link)

Object oriented style (method):

class mysqli {
bool ping ( void )
}

Checks whether the connection to the server is working. If it has gone down, and global option `mysqli.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.

## Return values

Retorna `TRUE` em caso de sucesso ou `FALSE` em falhas.

## Example

Exemplo 1. Object oriented style

`<?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } /* check if server is alive */ if ($mysqli->ping()) { printf ("Our connection is ok!\n"); } else { printf ("Error: %s\n", $mysqli->error); } /* close connection */ $mysqli->close(); ?>`

Exemplo 2. Procedural style

`<?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } /* check if server is alive */ if (mysqli_ping($link)) { printf ("Our connection is ok!\n"); } else { printf ("Error: %s\n", mysqli_error($link)); } /* close connection */ mysqli_close($link); ?>`

The above examples would produce the following output:

    Our connection is ok!

Anterior | Principal | Próxima
mysqli_param_count | Acima | mysqli_prepare