How to Run and Parse Ping Results in PHP: A Complete Guide

In web development and system administration, the Ping command is a common network diagnostic tool used to test connectivity between hosts. PHP, a popular server‑side scripting language, can easily execute system commands and output the results in a structured way. This article explains how to run Ping via PHP and format the output.

Basic Ping command execution

PHP provides several functions for executing system commands, the most common being exec(), shell_exec() and system(). The following is a basic example using shell_exec() to run a Ping command:

<code><?php
$host = 'example.com';
$pingResult = shell_exec("ping -c 4 {$host}");
echo "<pre>{$pingResult}

"; ?>

This code sends four Ping packets to example.com and outputs the raw result to the browser.

Structured Ping output

To make the Ping result easier to read and analyze, we can process the output into a structured format:

<code><?php
function structuredPing($host, $count = 4)
{
    $command = "ping -c {$count} {$host}";
    $output = shell_exec($command);

    if (empty($output)) {
        return ['error' => 'Ping command failed or host is unreachable'];
    }

    // Parse output
    $lines = explode("
", $output);
    $result = [
        'host' => $host,
        'packets_transmitted' => 0,
        'packets_received' => 0,
        'packet_loss' => 0,
        'round_trip' => [],
        'details' => []
    ];

    foreach ($lines as $line) {
        // Parse statistics line
        if (preg_match('/(\d+) packets transmitted, (\d+) received, (\d+)% packet loss/', $line, $matches)) {
            $result['packets_transmitted'] = $matches[1];
            $result['packets_received'] = $matches[2];
            $result['packet_loss'] = $matches[3];
        }

        // Parse round‑trip time
        if (preg_match('/rtt min\/avg\/max\/mdev = ([\d.]+)\/([\d.]+)\/([\d.]+)\/([\d.]+) ms/', $line, $matches)) {
            $result['round_trip'] = [
                'min'  => $matches[1],
                'avg'  => $matches[2],
                'max'  => $matches[3],
                'mdev' => $matches[4]
            ];
        }

        // Parse each ping packet detail
        if (preg_match('/icmp_seq=(\d+) ttl=(\d+) time=([\d.]+) ms/', $line, $matches)) {
            $result['details'][] = [
                'sequence' => $matches[1],
                'ttl'      => $matches[2],
                'time'     => $matches[3]
            ];
        }
    }

    return $result;
}

// Usage example
$pingData = structuredPing('google.com');
echo '<pre>' . print_r($pingData, true) . '

'; ?>

Cross‑platform compatibility handling

Different operating systems use different Ping parameters: Windows uses -n for the count, while Linux/Unix uses -c. The following function detects the OS and builds the appropriate command:

<code><?php
function osAwarePing($host, $count = 4)
{
    if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
        $command = "ping -n {$count} {$host}";
    } else {
        $command = "ping -c {$count} {$host}";
    }
    return $command;
}

// Usage example
$command = osAwarePing('example.com');
$output = shell_exec($command);
echo "<pre>{$output}

"; ?>

Security considerations

When executing system commands, security is critical. Important points include:

Input validation: always validate user‑provided input.

Escape parameters: use escapeshellarg() to escape arguments.

Permission restriction: run the script with the minimum necessary privileges.

Improved secure version:

<?php
function safePing($host, $count = 4)
{
    // Validate input
    if (!is_numeric($count) || $count < 1 || $count > 10) {
        return ['error' => 'Invalid ping count'];
    }

    // Validate hostname or IP address
    if (!preg_match('/^[a-zA-Z0-9\-\.]+$/', $host)) {
        return ['error' => 'Invalid hostname or IP address'];
    }

    $host = escapeshellarg($host);
    $count = (int)$count;

    $command = osAwarePing($host, $count);
    return shell_exec($command);
}
?>

Visualization output

To improve user experience, the Ping result can be presented in a friendly HTML format:

<?php
function displayPingResult($pingData)
{
    if (isset($pingData['error'])) {
        echo "<div class='error'>{$pingData['error']}</div>";
        return;
    }

    echo "<div class='ping-result'>";
    echo "<h2>Ping Results for {$pingData['host']}</h2>";
    echo "<p>Packets: {$pingData['packets_transmitted']} sent, {$pingData['packets_received']} received, {$pingData['packet_loss']}% loss</p>";

    if (!empty($pingData['round_trip'])) {
        echo "<p>Round Trip Times (ms):</p><ul>";
        echo "<li>Min: {$pingData['round_trip']['min']}</li>";
        echo "<li>Avg: {$pingData['round_trip']['avg']}</li>";
        echo "<li>Max: {$pingData['round_trip']['max']}</li>";
        echo "<li>Mdev: {$pingData['round_trip']['mdev']}</li>";
        echo "</ul></p>";
    }

    if (!empty($pingData['details'])) {
        echo "<table border='1'><tr><th>Sequence</th><th>TTL</th><th>Time (ms)</th></tr>";
        foreach ($pingData['details'] as $detail) {
            echo "<tr>";
            echo "<td>{$detail['sequence']}</td>";
            echo "<td>{$detail['ttl']}</td>";
            echo "<td>{$detail['time']}</td>";
            echo "</tr>";
        }
        echo "</table>";
    }

    echo "</div>";
}

// Usage example
$pingData = structuredPing('google.com');
displayPingResult($pingData);
?>

By executing the Ping command with PHP and structuring its output, developers can build powerful network diagnostic tools. The article covered everything from basic execution to advanced parsing, cross‑platform handling, and security considerations, providing a solid foundation for extending to other system commands and creating comprehensive monitoring solutions.