.jpg)
composer在線學(xué)習(xí)地址：學(xué)習(xí)地址
我最近在為項(xiàng)目編寫測(cè)試時(shí)，就遇到了一個(gè)讓人頭疼的問題：如何可靠地測(cè)試那些依賴于“當(dāng)前時(shí)間”的業(yè)務(wù)邏輯？
想象一下這樣的場(chǎng)景：你的系統(tǒng)需要根據(jù)用戶注冊(cè)時(shí)間計(jì)算會(huì)員等級(jí)，或者一個(gè)優(yōu)惠券在特定日期后過期，再或者你需要測(cè)試一個(gè)每日?qǐng)?bào)告的生成功能。在編寫這些功能的測(cè)試時(shí)，你是否也曾遇到過這樣的困境？
- 測(cè)試運(yùn)行緩慢： 為了模擬時(shí)間流逝，你可能會(huì)在測(cè)試代碼中加入 sleep() 函數(shù)。這無疑會(huì)大大拖慢你的測(cè)試套件運(yùn)行速度，對(duì)于大型項(xiàng)目來說，簡(jiǎn)直是噩夢(mèng)。
- 測(cè)試結(jié)果不穩(wěn)定（Flaky Tests）： 如果你的測(cè)試直接依賴于系統(tǒng)當(dāng)前時(shí)間，那么在不同的時(shí)間點(diǎn)運(yùn)行測(cè)試，可能會(huì)得到不同的結(jié)果。例如，一個(gè)在午夜運(yùn)行的測(cè)試可能通過，但在下午運(yùn)行就失敗了，因?yàn)槿掌谝呀?jīng)改變。這種不確定性讓調(diào)試變得異常困難。
- 手動(dòng)模擬的繁瑣： 你可能嘗試過手動(dòng)設(shè)置 carbon::setTestNow() 來模擬時(shí)間。這確實(shí)有效，但每次測(cè)試結(jié)束都需要記得重置時(shí)間，否則會(huì)影響后續(xù)測(cè)試。代碼中充斥著大量的 setTestNow() 和 setTestNow(NULL)，既不優(yōu)雅也容易出錯(cuò)。
這些問題不僅降低了開發(fā)效率，還讓測(cè)試的可靠性大打折扣。我一直在尋找一種更優(yōu)雅、更高效的方式來解決這個(gè)問題。最終，我發(fā)現(xiàn)了 spatie/pest-plugin-test-time 這個(gè) Pest 插件，它徹底改變了我的測(cè)試體驗(yàn)。
Composer：php 包管理的基石
在介紹 spatie/pest-plugin-test-time 之前，我們不得不提 Composer。Composer 是 PHP 的一個(gè)依賴管理工具，它允許你聲明項(xiàng)目所依賴的庫，并管理它們的安裝和更新。正是因?yàn)橛辛?Composer，我們才能如此方便地集成像 spatie/pest-plugin-test-time 這樣的優(yōu)秀開源庫。
安裝 spatie/pest-plugin-test-time 非常簡(jiǎn)單，因?yàn)樗且粋€(gè)僅用于開發(fā)環(huán)境的工具，我們使用 require –dev 命令：
composer require spatie/pest-plugin-test-time --dev
這個(gè)命令會(huì)下載并安裝該插件及其所有依賴（包括 Carbon，因?yàn)檫@個(gè)插件是基于 Carbon 的 setTestNow() 功能實(shí)現(xiàn)的），并將其添加到你的 composer.json 文件的 require-dev 部分。
掌控時(shí)間流逝：spatie/pest-plugin-test-time 的魔力
spatie/pest-plugin-test-time 是一個(gè)為 Pest 測(cè)試框架設(shè)計(jì)的插件，它提供了一個(gè)簡(jiǎn)潔的 testTime() 函數(shù)，讓你可以在測(cè)試中輕松地凍結(jié)、前進(jìn)或倒退時(shí)間。它完美地封裝了 Carbon 的時(shí)間操作，讓你的測(cè)試代碼變得異常清晰。
1. 凍結(jié)時(shí)間
最常用的功能就是凍結(jié)時(shí)間。一旦凍結(jié)，即使你的代碼中調(diào)用 Carbon::now()，它也會(huì)返回你凍結(jié)時(shí)的那個(gè)時(shí)間點(diǎn)，而不會(huì)隨著真實(shí)時(shí)間的流逝而改變。
use CarbonCarbon; use function SpatiePestPluginTestTimetestTime; test('時(shí)間應(yīng)該被凍結(jié)', function () { testTime()->freeze(); // 凍結(jié)當(dāng)前時(shí)間 $firstCall = Carbon::now(); sleep(2); // 即使等待2秒 $secondCall = Carbon::now(); expect($firstCall->toDateTimeString())->toBe($secondCall->toDateTimeString()); });
你也可以在特定的時(shí)間點(diǎn)凍結(jié)時(shí)間：
use CarbonCarbon; use function SpatiePestPluginTestTimetestTime; test('可以在特定時(shí)間點(diǎn)凍結(jié)', function () { testTime()->freeze('2023-01-01 12:00:00'); expect(Carbon::now()->toDateTimeString())->toBe('2023-01-01 12:00:00'); });
2. 操縱時(shí)間
除了凍結(jié)，testTime() 還允許你像操作 Carbon 實(shí)例一樣，對(duì)時(shí)間進(jìn)行“快進(jìn)”或“倒退”：
use CarbonCarbon; use function SpatiePestPluginTestTimetestTime; test('可以前進(jìn)或倒退時(shí)間', function () { testTime()->freeze('2023-01-01 12:00:00'); testTime()->addHour(); // 時(shí)間變?yōu)?2023-01-01 13:00:00 expect(Carbon::now()->toDateTimeString())->toBe('2023-01-01 13:00:00'); testTime()->subMinute()->addSeconds(30); // 鏈?zhǔn)讲僮? expect(Carbon::now()->toDateTimeString())->toBe('2023-01-01 12:59:30'); });
這對(duì)于測(cè)試跨越特定時(shí)間邊界（如午夜、月末）的邏輯非常有用。
3. 自定義 Carbon 斷言
這個(gè)插件還提供了一個(gè)方便的自定義 Pest 斷言 toBeCarbon，用于輕松檢查 Carbon 實(shí)例的值：
use CarbonCarbon; use function SpatiePestPluginTestTimetestTime; test('可以斷言 Carbon 實(shí)例的值', function () { $carbon = Carbon::createFromFormat('Y-m-d H:i:s', '2022-05-31 01:02:03'); // 斷言完整的日期和時(shí)間 expect($carbon)->toBeCarbon('2022-05-31 01:02:03'); // 只斷言日期部分 expect($carbon)->toBeCarbon('2022-05-31'); // 顯式指定格式進(jìn)行斷言 expect($carbon)->toBeCarbon('2022', 'Y'); });
這讓你的測(cè)試斷言更加簡(jiǎn)潔和富有表現(xiàn)力。
優(yōu)勢(shì)與實(shí)際應(yīng)用效果
使用 spatie/pest-plugin-test-time 帶來的好處是顯而易見的：
- 測(cè)試穩(wěn)定性大幅提升： 你的測(cè)試不再受真實(shí)系統(tǒng)時(shí)間的影響，無論何時(shí)運(yùn)行，結(jié)果都將一致，徹底告別“Flaky Tests”。
- 測(cè)試速度顯著加快： 無需再使用 sleep()，你的測(cè)試套件可以以最快的速度運(yùn)行。
- 代碼簡(jiǎn)潔易讀： 告別繁瑣的手動(dòng) Carbon::setTestNow()，通過簡(jiǎn)單的 testTime() 函數(shù)即可完成時(shí)間控制，測(cè)試代碼更加清晰、易于理解和維護(hù)。
- 輕松測(cè)試邊緣情況： 以前難以測(cè)試的跨日、跨月、跨年邏輯，現(xiàn)在只需一行代碼即可將時(shí)間調(diào)整到特定邊界進(jìn)行測(cè)試。
- 與 Carbon 無縫集成： 由于底層基于 Carbon，如果你已經(jīng)在項(xiàng)目中使用 Carbon，那么這個(gè)插件的學(xué)習(xí)成本幾乎為零。
在我的項(xiàng)目中，通過引入 spatie/pest-plugin-test-time，那些原本難以捉摸的時(shí)間相關(guān)測(cè)試變得異常簡(jiǎn)單和可靠。開發(fā)效率得到了顯著提升，并且我對(duì)測(cè)試結(jié)果的信心也大大增加。
總結(jié)
時(shí)間敏感的業(yè)務(wù)邏輯在現(xiàn)代應(yīng)用中無處不在，而為其編寫高質(zhì)量的測(cè)試是確保應(yīng)用健壯性的關(guān)鍵。spatie/pest-plugin-test-time 這個(gè) Pest 插件為我們提供了一個(gè)強(qiáng)大而優(yōu)雅的解決方案，它利用 Composer 的便利性，將復(fù)雜的測(cè)試時(shí)間控制變得觸手可及。如果你也正在為 PHP 應(yīng)用編寫 Pest 測(cè)試，并且遇到了時(shí)間相關(guān)的測(cè)試難題，那么我強(qiáng)烈推薦你嘗試一下這個(gè)插件，它一定會(huì)讓你的測(cè)試之旅更加順暢！
.png)
