mysqli::ping
mysqli_ping
(PHP 5, PHP 7)
mysqli::ping -- mysqli_ping — サーバーとの接続をチェックし、もし切断されている場合は再接続を試みる
説明
オブジェクト指向型
public mysqli::ping ( ) : bool
手続き型
mysqli_ping
( mysqli $link
) : bool
サーバーとの接続が動作中かどうかを確かめます。もし切断されており、 グローバルオプション mysqli.reconnect が有効な場合は再接続を試みます。
注意:
mysqlnd ドライバは、
php.ini
設定項目 mysqli.reconnect を無視します。 自動再接続は行われません。
この関数は、長期間アイドル状態にあるクライアントが、 サーバーの状態を確認して必要なら再接続するために使用します。
返り値
成功した場合に true
を、失敗した場合に false
を返します。
例
例1 mysqli::ping() の例
オブジェクト指向型
<?php$mysqli = new mysqli("localhost", "my_user", "my_password", "world");/* 接続状況をチェックします */if ($mysqli->connect_errno) { printf("Connect failed: %s\n", $mysqli->connect_error); exit();}/* サーバーが稼動中かどうかを確認します */if ($mysqli->ping()) { printf ("Our connection is ok!\n");} else { printf ("Error: %s\n", $mysqli->error);}/* 接続を閉じます */$mysqli->close();?>
手続き型
<?php$link = mysqli_connect("localhost", "my_user", "my_password", "world");/* 接続状況をチェックします */if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit();}/* サーバーが稼動中かどうかを確認します */if (mysqli_ping($link)) { printf ("Our connection is ok!\n");} else { printf ("Error: %s\n", mysqli_error($link));}/* 接続を閉じます */mysqli_close($link);?>
上の例の出力は以下となります。
Our connection is ok!