ne0bot/ping

A PHP class to ping hosts.

, _(*1)

Ping

, _(*2)

A PHP class to ping hosts., _(*3)

There are a ton of different methods of pinging a server using PHP, and I've found most to be poorly documented or downright dangerous in their implementation., _(*4)

Therefore, I've created this simple class, which incorporates the three most popular ping methods (exec() with the system's ping utility, fsockopen(), and socket_create()). Each method has it's benefits and drawbacks, and may work better or worse on a particular system., _(*5)

Ping was created by Jeff Geerling of Midwestern Mac, LLC in 2012., _(*6)

Usage

This is a very simple class. Just create an instance, and run ping()., _(*7)

$host = 'www.example.com';
$ping = new Ping($host);
$latency = $ping->ping();
if ($latency !== -1) {
  print 'Latency is ' . $latency . ' ms';
}
else {
  print 'Host could not be reached.';
}

You can also specify the ttl (maximum hops) and timeout when creating the instance:, _(*8)

$ttl = 128;
$timeout = 5;
$ping = new Ping($host, $ttl, $timeout);

...or using the setTtl() or setTimeout() methods:, _(*9)

$ping = new Ping($host);
$ping->setTtl(128);
$ping->setTimeout(5);

You can change the host using the setHost() method:, _(*10)

$ping = new Ping($host);
...
$ping->setHost('www.anotherexample.com');

License

Ping is licensed under the MIT (Expat) license. See included LICENSE.md., _(*11)