トップページ　→関数リファレンス　→データベース関連　→ベンダー固有のモジュール　→MySQL　→MySQL (最初の API)

関数・クラス解説

mysql_ping

version:PHP 4 >= 4.3.0, PHP 5 (公式)

サーバーとの接続状況を調べ、接続されていない場合は再接続する

公式リファレンス

書式

mysql_ping ([ resource $link_identifier = NULL ] ) : bool

説明

サーバーとの接続が有効かどうかを調べます。もし接続が切れていた場合、自動的に再接続が試みられます。この関数は、アイドル期間が長いスクリプトで利用し、サーバーが接続を切断したかどうかを確認するために用いられます。

注意:
MySQL 5.0.3 以降、自動再接続機能は使えなくなりました。

パラメータ

link_identifier: MySQL 接続。指定されない場合、mysql_connect() により直近にオープンされたリンクが指定されたと仮定されます。そのようなリンクがない場合、引数を指定せずにmysql_connect() がコールした時と同様にリンクを確立します。リンクが見付からない、または、確立できない場合、E_WARNING レベルのエラーが生成されます。

返値

MySQL サーバーとの接続が有効な場合に TRUE そうでない場合に FALSE を返します。

注意

警告この拡張モジュールは PHP 5.5.0 で非推奨になり、PHP 7.0.0 で削除されました。MySQLi あるいはPDO_MySQL を使うべきです。詳細な情報はMySQL: API の選択やそれに関連する FAQ を参照ください。この関数の代替として、これらが使えます。

mysqli_ping()

サンプル

例1 mysql_ping() の例 

set_time_limit(0);

$conn = mysql_connect('localhost', 'mysqluser', 'mypass');
$db   = mysql_select_db('mydb');

/* このクエリは非常に時間がかかるものと仮定する */
$result = mysql_query($sql);
if (!$result) {
    echo 'Query #1 failed, exiting.';
    exit;
}

/* 接続が有効かどうかを確かめる。切断されていたら再接続する */
if (!mysql_ping($conn)) {
    echo 'Lost connection, exiting after query #1';
    exit;
}
mysql_free_result($result);

/* 接続が有効であることが確かめられたので、別のクエリを実行する */
$result2 = mysql_query($sql2);