ping
تابع ping در MySQLi وضعیت اتصال را چک می کند. «پینگ (Ping)» یعنی بپرسیم سرور زنده است یا نه. همچنین اگر اتصال قطع شده باشد، تلاش برای وصل شدن دوباره می کند. این کار برای برنامه های طولانی خیلی کاربردی است.
تابع ping چه کاری انجام می دهد؟
با ping() می فهمی اتصال سالم است یا نه. اگر سالم باشد، TRUE برمی گردد. در غیر این صورت FALSE می دهد و می توانی خطا را بخوانی.
نمونه شیءگرا (Object Oriented)
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "my_db");
if ($mysqli->connect_errno) {
echo "Failed to connect to MySQL: " . $mysqli->connect_error;
exit();
}
if ($mysqli->ping()) {
echo "Connection is ok!";
} else {
echo "Error: " . $mysqli->error;
}
$mysqli->close();
?>
نمونه رویه ای (Procedural)
<?php
$con = mysqli_connect("localhost", "my_user", "my_password", "my_db");
if (mysqli_connect_errno()) {
echo "Failed to connect to MySQL: " . mysqli_connect_error();
exit();
}
if (mysqli_ping($con)) {
echo "Connection is ok!";
} else {
echo "Error: " . mysqli_error($con);
}
mysqli_close($con);
?>
گام های عملی بررسی اتصال
- به دیتابیس وصل شو.
- تابع ping() را اجرا کن.
- بر اساس نتیجه، پیام مناسب نمایش بده.
نکته ها و هشدارها
نکته: پس از پایان کار، اتصال را ببند؛ از close() استفاده کن.
هشدار: همیشه خطا را چاپ نکن؛ در برنامه واقعی لاگ بگیر.
مطالب مرتبط: تابع ping، real_connect، و close.
جمع بندی سریع
- ping() اتصال را زنده بودن چک می کند.
- در صورت قطع، تلاش برای اتصال دوباره می شود.
- موفق باشد، TRUE برمی گردد.
- در پایان، اتصال را ببند.