Clock.php

Go to the documentation of this file.

<?php
namespace Wikimedia\Telemetry;
 
use Wikimedia\Assert\Assert;
 
class Clock {
    private static ?int $mockTime = null;
 
    private ?int $referenceTime = null;
 
    public function __construct() {
        Assert::precondition(
            PHP_INT_SIZE >= 8,
            'The Clock class requires 64-bit integers to support nanosecond timing'
        );
    }
 
    public function getCurrentNanoTime(): int {
        $this->referenceTime ??= (int)( 1e9 * microtime( true ) ) - hrtime( true );
        return self::$mockTime ?? ( $this->referenceTime + hrtime( true ) );
    }
 
    public static function setMockTime( ?int $epochNanos ): void {
        Assert::precondition( defined( 'MW_PHPUNIT_TEST' ), 'This method should only be used in tests' );
        self::$mockTime = $epochNanos;
    }
}