mysql_ping

(PHP 4 >= 4.3.0, PHP 5)

mysql_pingBir sunucu bağlantısına ping at, bağlantı yoksa tekrar bağlan

Uyarı

Bu eklentinin kullanımı PHP 5.5.0 itibariyle önerilmemekte olup PHP 7.0.0'da kaldırılmıştır. Bu eklentinin yerine ya mysqli ya da PDO_MySQL eklentisi kullanılmalıdır. MySQL API seçerken MySQL API'ye Bakış belgesi yardımcı olabilir. Bu işlevin yerine kullanılabilecekler:

Açıklama

mysql_ping(resource $bağlantı_belirteci = NULL): bool

Sunucuyla bağlantının çalışıp çalışmadığına bakar. Eğer bağlantı kesilmişse, otomatik olarak yeniden bağlanmaya çalışır. Bu işlev, uzun süre boş kalan betikler tarafından, sunucunun bağlantıyı kapatıp kapatmadığını denetlemek ve eğer kapattıysa tekrar bağlanmak için kullanılabilir.

Bilginize:

MySQL 5.0.13'ten itibaren otomatik olarak yeniden bağlanma özelliği öntanımlı olarak devre dışı bırakılmıştır.

Bağımsız Değişkenler

bağlantı_belirteci

MySQL bağlantısı. Eğer bağlantı belirteci belirtilmemişse mysql_connect() tarafından açılan son bağlantı kullanılmaya çalışılır. Eğer böyle bir bağlantı yoksa mysql_connect() bağımsız değişkensiz olarak çağrılmış gibi bir bağlantı oluşturmaya çalışır. Hiçbir bağlantı yoksa ve yenisi de kurulamazsa E_WARNING seviyesinde bir hata üretilir.

Dönen Değerler

MySQL sunucusuyla bağlantı çalışıyorsa true, çalışmıyorsa false döndürür.

Örnekler

Örnek 1 - mysql_ping() örneği

<?php
set_time_limit
(0);

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

/* Bu sorgunun uzun süre alacağını varsayarak */
$result = mysql_query($sql);
if (!
$result) {
echo
'Sorgu #1 çalışmadı, çıkıyor.';
exit;
}

/* Bağlantının hala canlı olduğundan emin ol, değilse tekrar bağlan */
if (!mysql_ping($conn)) {
echo
'Bağlantı kayboldu, sorgu #1\'den sonra çıkıyor';
exit;
}
mysql_free_result($result);

/* Bağlantı hala canlı olduğuna göre, başka bir sorgu çalıştıralım */
$result2 = mysql_query($sql2);
?>

Ayrıca Bakınız

add a note add a note

User Contributed Notes 7 notes

up
3
cybot2000 at yahoo dot de
19 years ago
It should be noted that mysql_ping() seems to reset the error message on the server.
I used it to check whether the connection was still alive before reading the error message via mysql_error() and it always returned an empty string. Upon removing the connection check everything worked.
up
3
alext at marketdream dot com dot mx
15 years ago
mysql_ping() is really helpful when you have this annoying error:

MYSQL Error 2006 Server has gone away

For CI users:
In 1.7.2 version of codeigniter, there is a function

$this->db->reconnect()

that uses mysql_ping() to reestablish the timed out connection.

This function is specially useful when developing social media sites that uses hundreds of connections to the db such asinserting or selecting.
up
3
dustin hawkins
18 years ago
When using the mysql_ping command under php 5.1.2 and mysql 5.0, I was having problems with the auto-reconnect "feature", mainly that when the connection was severed, a mysql_ping would not automatically re-establish the connection to the database.

The connection to the DB is dropped when the time without a query excedes the wait_timeout value in my.cnf. You can check your wait_timeout by running the query "SHOW VARIABLES;"

If you're having problems auto-reconnecting when the connection is dropped, use this code:

<?php

$conn
= mysql_connect('localhost','user','pass');
mysql_select_db('db',$conn);

if (!
mysql_ping ($conn)) {
  
//here is the major trick, you have to close the connection (even though its not currently working) for it to recreate properly.
  
mysql_close($conn);
  
$conn = mysql_connect('localhost','user','pass');
  
mysql_select_db('db',$conn);
}

//run queries knowing that your connection is alive....

?>
up
2
miro dot dietiker at md-systems dot ch
17 years ago
When checking if a $resource works...
be prepared that mysql_ping returns NULL as long as $resource is no correct mysql resource.
<?php
$resource
=NULL;
var_dump = @mysql_ping($resource);
# showing NULL
?>
This could be used to decide of a current $resource is a mysql or a mysqli connection when nothing else is available to do that...
up
2
Doug
14 years ago
This function *does not* attempt to reconnect at this time.  It only tells you whether or not you currently *are* connected.

To actually reconnect, you will have to implement this yourself in a wrapper class.
up
2
vinicius at teracom dot com dot br
20 years ago
Is important to remember that if your first connection to mysql don't works, mysql_ping will always return true! So, if you want to check if mysql is connected, first of all you must check if mysql_connect do not returns false and then you can begin to check mysql_ping.
up
-3
luky37
15 years ago
If you get 'error 2006: MySQL server has gone away' messages when running (really) long scripts, mysql_ping will help detecting the loss of the db-connection. This can happen, when 'wait timeout' is reached (MySQL default is 8 hours).
To Top