如何在單元測試中模擬time_nanosleep 的延遲

gitbox 2025-05-26

在進行PHP 單元測試時，涉及到時間延遲（如time_nanosleep ）的代碼往往會導致測試變慢，並增加CI/CD 流程的執行時間。而且測試本身也會依賴真實時間，降低測試的可預測性和穩定性。為了提高效率和保持測試的純粹性，我們通常需要“模擬”（mock）這類延遲函數。

本文將介紹如何在PHP 的單元測試中模擬time_nanosleep函數的行為，而不真正引入延遲。

背景代碼示例

設想我們有一個服務類，該類中的方法會使用time_nanosleep來執行短暫的延遲操作：

 class TaskRunner
{
    public function runWithDelay(): string
    {
        time_nanosleep(0, 500000000); // 延遲 0.5 秒
        return 'done';
    }
}

如果我們直接測試該方法，測試會暫停半秒，這在大量測試場景中是不可接受的。我們需要找到一種方式來“替代”或“重定義” time_nanosleep 。

使用命名空間函數重寫技巧

PHP 沒有內建的函數mock 功能，但我們可以利用PHP 的函數查找機制：在某個命名空間中，如果我們定義了一個與全局函數同名的函數，那麼優先調用的是命名空間內的函數。

步驟一：將代碼封裝進命名空間

我們將業務代碼封裝進一個命名空間，例如Gitbox\Runtime ：

 namespace Gitbox\Runtime;

function time_nanosleep(int $seconds, int $nanoseconds)
{
    // 原始行為：調用全局函數
    return \time_nanosleep($seconds, $nanoseconds);
}

class TaskRunner
{
    public function runWithDelay(): string
    {
        time_nanosleep(0, 500000000);
        return 'done';
    }
}

現在， TaskRunner使用的是Gitbox\Runtime\time_nanosleep ，我們可以在測試中對其進行覆蓋。

步驟二：在測試中重寫函數行為

在測試文件中，我們在相同命名空間下定義一個模擬的time_nanosleep函數：

 namespace Gitbox\Runtime;

function time_nanosleep(int $seconds, int $nanoseconds)
{
    // 模拟延遲：什麼也不做
    return true;
}

然後我們可以像平常一樣測試：

 use Gitbox\Runtime\TaskRunner;
use PHPUnit\Framework\TestCase;

class TaskRunnerTest extends TestCase
{
    public function testRunWithDelay()
    {
        $runner = new TaskRunner();
        $result = $runner->runWithDelay();

        $this->assertEquals('done', $result);
    }
}

由於我們在測試環境中重寫了time_nanosleep ，因此測試不會有任何真實延遲。

使用依賴注入（可選增強方式）

另一個更面向對象的方式是將延遲操作封裝進一個類，通過依賴注入傳入任務執行器，這樣我們可以更靈活地模擬各種行為，例如引發異常、模擬長時間阻塞等。

 interface SleeperInterface
{
    public function sleep(): void;
}

class RealSleeper implements SleeperInterface
{
    public function sleep(): void
    {
        time_nanosleep(0, 500000000);
    }
}

class TaskRunner
{
    private SleeperInterface $sleeper;

    public function __construct(SleeperInterface $sleeper)
    {
        $this->sleeper = $sleeper;
    }

    public function runWithDelay(): string
    {
        $this->sleeper->sleep();
        return 'done';
    }
}

測試中我們可以使用模擬類：

 class FakeSleeper implements SleeperInterface
{
    public function sleep(): void
    {
        // 不執行任何操作
    }
}

使用方法：

 $sleeper = new FakeSleeper();
$runner = new \Gitbox\Runtime\TaskRunner($sleeper);
$this->assertEquals('done', $runner->runWithDelay());

總結

在PHP 中，測試時間相關函數最有效的方式通常是通過命名空間重定義函數或者使用依賴注入。對於像time_nanosleep這樣的全局函數，我們推薦使用命名空間重寫技巧，並將測試邏輯控制在項目可控的邊界內。

此外，使用接口和依賴注入能讓你的代碼更加靈活、可測試，適用於更複雜的場景。

通過這些方法，你可以在測試中完全模擬時間延遲而不引入真實的時間成本，大大提升測試效率和穩定性。

如需更多相關實戰示例，請訪問https://gitbox.net 。

time_nanosleep