mysqli::ping

mysqli_ping

(PHP 5, PHP 7, PHP 8)

mysqli::ping -- mysqli_pingping 一個(gè)連接,或者如果連接處于斷開(kāi)狀態(tài),重新連接

說(shuō)明

面向?qū)ο箫L(fēng)格

mysqli::ping(): bool

過(guò)程化風(fēng)格

mysqli_ping(mysqli $link): bool

檢查到服務(wù)器的連接是否還正常。 在啟用 mysqli.reconnect 選項(xiàng)的前提下, 如果連接已經(jīng)斷開(kāi), ping 操作會(huì)嘗試重新建立連接。

注意: mysqlnd 驅(qū)動(dòng)會(huì)忽略 php.ini 中的 mysqli.reconnect 選項(xiàng), 所以它不會(huì)自動(dòng)重連。

客戶端建立連接之后,長(zhǎng)時(shí)間處于閑置狀態(tài), 可以用此函數(shù)來(lái)檢查服務(wù)器是否關(guān)閉了這個(gè)連接, 如有必要,將會(huì)自動(dòng)重新建立到服務(wù)器的連接。

參數(shù)

mysql

僅以過(guò)程化樣式:由mysqli_connect()mysqli_init() 返回的 mysqli 對(duì)象。

返回值

成功時(shí)返回 true, 或者在失敗時(shí)返回 false。

范例

示例 #1 mysqli::ping() 例程

面向?qū)ο箫L(fēng)格

<?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);
}

/* 關(guān)閉連接 */
$mysqli->close();
?>

過(guò)程化風(fēng)格

<?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));
}

/* 關(guān)閉連接 */
mysqli_close($link);
?>

以上例程會(huì)輸出:

Our connection is ok!