Net_Ping is a PHP wrapper for the ping program and provides a neat way pinging a host or checking if a site is up and running. To install it you just need to have pear installed. Once that is done you can do a search for PEAR Net_Ping by opening a terminal and typing:
> ping search ping
This will return the following:
- Retrieving data...0%.MATCHED PACKAGES, CHANNEL PEAR.PHP.NET:
- PACKAGE STABLE/(LATEST) LOCAL
- Net_Ping 2.4.4 (stable) Execute ping
- Services_Pingback 0.2.2 (alpha) A Pingback User-Agent class.
You can install Net_Ping by running the following:
> pear install Net_Ping
Which should produce the following output.
- downloading Net_Ping-2.4.4.tgz ...
- Starting to download Net_Ping-2.4.4.tgz (9,563 bytes)
- .....done: 9,563 bytes
- install ok: channel://pear.php.net/Net_Ping-2.4.4
You can now use Net_Ping. To use the class in your code you need to include it first, after this you need to get an instance of the Net_Ping object so that you can work with it. The following code will create a Net_Ping object that you can work with.
- require_once "Net/Ping.php";
- $ping = Net_Ping::factory();
To ping a site you just need to run the ping() function. This function takes a single parameter which is the IP address or the name of the server you want to ping. The function returns a Net_Ping_Result object that contains all of the information returned from the ping.
$results = $ping->ping('www.example.com');
Here is a print_r() output of this object.
- Net_Ping_Result Object
- [_icmp_sequence] => Array
-  => 176
-  => 177
- [_target_ip] => 220.127.116.11
- [_bytes_per_request] => 32
- [_bytes_total] => 64
- [_ttl] => 54
- [_raw_data] => Array
-  =>
-  => Pinging www.example.com [18.104.22.168] with 32 bytes of data:
-  =>
-  => Reply from 22.214.171.124: bytes=32 time=176ms TTL=54
-  => Reply from 126.96.36.199: bytes=32 time=177ms TTL=54
-  =>
-  => Ping statistics for 188.8.131.52:
-  => Packets: Sent = 2, Received = 2, Lost = 0 (0% loss),
-  => Approximate round trip times in milli-seconds:
-  => Minimum = 176ms, Maximum = 177ms, Average = 176ms
- [_sysname] => windows
- [_round_trip] => Array
- [min] => 176
- [max] => 177
- [avg] => 176
- [_transmitted] => 2
- [_received] => 2
- [_loss] => 0
You can access the different properties within the Net_Ping_Result to find out what happened with the ping. The percentage of pings lost is also worked out for you in the _loss property.
- echo '<p>Transmitted: '.$results->_transmitted.'</p>';
- echo '<p>Received: '.$results->_received.'</p>';
- echo '<p>% Loss: '.$results->_loss.'%</p>';
The _round_trip parameter contains an array that details the minimum, maximum and average times for the requests.
You might have noticed in my original example that I only sent out 2 pings. This is because the Net_Ping object has a function that allows you to set certain options before you make the request. This function is called setArgs() and takes an associative array as the argument. To set the number of ping requests to be sent out just use the following line of code before you make your ping request.
$ping->setArgs(array('count' => 2));
You should be aware that different operating systems have different options, so for a full list of options please see the Net_Ping::setArgs() page on the PEAR website.
If you just want to check the host to make sure it is still active you can use the checkhost() function. This works in the same way as the ping() function, but will return true on success and false on failure. You can see the output of checkhost() by viewing the var_dump() output.
This function is really a wrapper for the ping() function, but will parse the output to determine if the ping request worked or not.