SHOWCASE.php

<?php

/**
 * Showcase examples for hixbe/time package
 */

require __DIR__ . '/vendor/autoload.php';

use Hixbe\Time\Core\NTPClient;
use Hixbe\Time\Core\NTPClientConfig;

function printHeader(string $title): void
{
    echo str_repeat('=', 70) . "\n";
    echo $title . "\n";
    echo str_repeat('=', 70) . "\n";
}

function example1_basic(): void
{
    printHeader("Example 1: Basic Time Query");
    
    $client = new NTPClient();
    $serverTime = $client->getTime();
    echo "Server time: " . $serverTime->format('Y-m-d H:i:s.v') . "\n";
    echo "ISO format: " . $serverTime->format('c') . "\n";
    echo "\n";
}

function example2_offset(): void
{
    printHeader("Example 2: Time Offset Check");
    
    $client = new NTPClient();
    $offset = $client->getOffset();
    
    $status = $offset > 0 ? "slow" : "fast";
    echo sprintf("System clock is %s by %.2fms\n", $status, abs($offset));
    
    if (abs($offset) > 1000) {
        echo "⚠️  WARNING: Clock drift is significant!\n";
    } else {
        echo "✅ Clock is well synchronized\n";
    }
    echo "\n";
}

function example3_detailed(): void
{
    printHeader("Example 3: Detailed Query Result");
    
    $client = new NTPClient();
    $result = $client->query();
    
    echo "Server: {$result->serverAddress} ({$result->usedServer})\n";
    echo "Stratum: {$result->parsed->header->stratum}\n";
    echo "Version: {$result->parsed->header->versionNumber}\n";
    echo "Precision: 2^{$result->parsed->header->precision} seconds\n";
    echo "Reference ID: {$result->parsed->header->referenceId}\n";
    echo "\nTimestamps:\n";
    echo "  Reference: {$result->parsed->timestamps->reference->iso}\n";
    echo "  Originate: {$result->parsed->timestamps->originate->iso}\n";
    echo "  Receive:   {$result->parsed->timestamps->receive->iso}\n";
    echo "  Transmit:  {$result->parsed->timestamps->transmit->iso}\n";
    echo "\n";
}

function example4_custom_servers(): void
{
    printHeader("Example 4: Query Custom Servers");
    
    $servers = ['time.hixbe.com', 'time.google.com', 'pool.ntp.org'];
    
    foreach ($servers as $server) {
        try {
            $config = new NTPClientConfig(host: $server, timeout: 3.0);
            $client = new NTPClient($config);
            $result = $client->query();
            
            echo "✅ {$server}:\n";
            echo "   Time: {$result->parsed->timestamps->transmit->iso}\n";
            echo "   Stratum: {$result->parsed->header->stratum}\n";
        } catch (Exception $e) {
            echo "❌ {$server}: {$e->getMessage()}\n";
        }
    }
    echo "\n";
}

function example5_continuous(): void
{
    printHeader("Example 5: Continuous Monitoring (5 iterations)");
    
    $client = new NTPClient();
    
    for ($i = 1; $i <= 5; $i++) {
        try {
            $result = $client->query();
            $offset = $client->getOffset();
            $serverTime = $result->parsed->timestamps->transmit->date;
            
            echo sprintf(
                "[%d] %s | Offset: %+.0fms\n",
                $i,
                $serverTime->format('Y-m-d\TH:i:s.v\Z'),
                $offset
            );
        } catch (Exception $e) {
            echo "[{$i}] Error: {$e->getMessage()}\n";
        }
        
        if ($i < 5) {
            sleep(2);
        }
    }
    echo "\n";
}

function example6_json_output(): void
{
    printHeader("Example 6: JSON Output");
    
    $client = new NTPClient();
    $result = $client->query();
    
    $serverTime = $result->parsed->timestamps->transmit->date;
    $offset = $client->getOffset();
    
    $output = [
        'timestamp' => (int)($serverTime->getTimestamp() * 1000),
        'iso' => $serverTime->format('Y-m-d\TH:i:s.v\Z'),
        'server' => [
            'address' => $result->serverAddress,
            'hostname' => $result->usedServer,
            'stratum' => $result->parsed->header->stratum,
            'referenceId' => $result->parsed->header->referenceId,
        ],
        'offset' => round($offset, 2),
        'precision' => $result->parsed->header->precision,
        'version' => $result->parsed->header->versionNumber,
    ];
    
    echo json_encode($output, JSON_PRETTY_PRINT) . "\n\n";
}

function example7_error_handling(): void
{
    printHeader("Example 7: Error Handling with Fallback");
    
    // Try with invalid server first, will fallback automatically
    $config = new NTPClientConfig(
        host: 'invalid.server.example',
        fallbackServers: ['time.hixbe.com', 'time.google.com']
    );
    $client = new NTPClient($config);
    
    try {
        $result = $client->query();
        echo "✅ Successfully connected to: {$result->usedServer}\n";
        echo "   Time: {$result->parsed->timestamps->transmit->iso}\n";
    } catch (Exception $e) {
        echo "❌ All servers failed: {$e->getMessage()}\n";
    }
    echo "\n";
}

// Main execution
echo "\n";
echo "╔" . str_repeat('=', 68) . "╗\n";
echo "║" . str_pad("HIXBE TIME SHOWCASE", 70, " ", STR_PAD_BOTH) . "║\n";
echo "╚" . str_repeat('=', 68) . "╝\n";
echo "\n";

$examples = [
    'example1_basic',
    'example2_offset',
    'example3_detailed',
    'example4_custom_servers',
    'example5_continuous',
    'example6_json_output',
    'example7_error_handling',
];

foreach ($examples as $example) {
    try {
        $example();
    } catch (Exception $e) {
        echo "Example failed: {$e->getMessage()}\n\n";
    }
}

printHeader("All examples completed!");