PHP mysqli: ping() function

Last update on August 19 2022 21:50:40 (UTC/GMT +8 hours)

mysqli_ping() function / mysqli::ping

The mysqli_ping() function / mysqli::ping pings a server connection, or tries to reconnect if the connection has gone down.

Syntax:

Object oriented style

bool mysqli::ping ( void )

Procedural style

bool mysqli_ping ( mysqli $link )

Parameter:

Name	Description	Required/Optional
link	A link identifier returned by mysqli_connect() or mysqli_init()	Required for procedural style only and Optional for Object oriented style

Usage: Procedural style

mysqli_ping(connection);

Parameter:

Name	Description	Required/Optional
connection	Specifies the MySQL connection to use	Required

Return value:

Returns TRUE on success or FALSE on failure.

Version: PHP 5, PHP 7

Example of object oriented style:

<?php
$mysqli = new mysqli("localhost", "user1", "datasoft123", "hr");

/* 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();
?>

Output:

Our connection is ok!

Example of procedural style:

<?php
$link = mysqli_connect("localhost", "user1", "datasoft123", "hr");

/* 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);
?>

Output:

Our connection is ok!

Example:

<?php
$con=mysqli_connect("localhost","user1","datasoft123","hr");

// Check connection
if (mysqli_connect_errno())
  {
  echo "Failed to connect to MySQL: " . mysqli_connect_error();
  }

// Check if server is alive
if (mysqli_ping($con))
  {
  echo "Connection is ok!";
  }
else
  {
  echo "Error: ". mysqli_error($con);
  }

mysqli_close($con);

?>

Output:

Connection is ok!

See also

PHP Function Reference

Previous: options
Next: poll