Composer在线学习地址：
学习地址
我最近在为项目编写测试时，就遇到了一个让人头疼的问题：如何可靠地测试那些依赖于“当前时间”的业务逻辑？
想象一下这样的场景：你的系统需要根据用户注册时间计算
会员
等级，或者一个优惠券在特定日期后过期，再或者你需要测试一个每日报告的生成功能。在编写这些功能的测试时，你是否也曾遇到过这样的困境？
测试运行缓慢：
为了模拟时间流逝，你可能会在测试代码中加入
函数。这无疑会大大拖慢你的测试套件运行速度，对于大型项目来说，简直是噩梦。
测试结果不稳定（Flaky Tests）：
如果你的测试直接依赖于系统当前时间，那么在不同的时间点运行测试，可能会得到不同的结果。例如，一个在午夜运行的测试可能通过，但在下午运行就失败了，因为日期已经改变。这种不确定性让调试变得异常困难。
手动模拟的繁琐：
你可能尝试过手动设置
来模拟时间。这确实有效，但每次测试结束都需要记得重置时间，否则会影响后续测试。代码中充斥着大量的
和
，既不优雅也容易出错。
这些问题不仅降低了开发效率，还让测试的可靠性大打折扣。我一直在寻找一种更优雅、更高效的方式来解决这个问题。最终，我发现了
这个 Pest 插件，它彻底改变了我的测试体验。
Composer：PHP 包管理的基石
在介绍
之前，我们不得不提 Composer。Composer 是 PHP 的一个依赖管理工具，它允许你声明项目所依赖的库，并管理它们的安装和更新。正是因为有了 Composer，我们才能如此方便地集成像
这样的优秀开源库。
安装
非常简单，因为它是一个仅用于开发环境的工具，我们使用
命令：
这个命令会下载并安装该插件及其所有依赖（包括 Carbon，因为这个插件是基于 Carbon 的
功能实现的），并将其添加到你的
文件的
部分。
掌控时间流逝：
的魔力
是一个为 Pest 测试框架设计的插件，它提供了一个简洁的
函数，让你可以在测试中轻松地冻结、前进或倒退时间。它完美地封装了 Carbon 的时间操作，让你的测试代码变得异常清晰。
1. 冻结时间
最常用的功能就是冻结时间。一旦冻结，即使你的代码中调用
，它也会返回你冻结时的那个时间点，而不会随着真实时间的流逝而改变。
你也可以在特定的时间点冻结时间：
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
2. 操纵时间
除了冻结，
还允许你像操作 Carbon 实例一样，对时间进行“快进”或“倒退”：
这对于测试跨越特定时间边界（如午夜、月末）的逻辑非常有用。
3. 自定义 Carbon 断言
这个插件还提供了一个方便的自定义 Pest 断言
，用于轻松检查 Carbon 实例的值：
这让你的测试断言更加简洁和富有表现力。
优势与实际应用效果
使用
带来的好处是显而易见的：
测试稳定性大幅提升：
你的测试不再受真实系统时间的影响，无论何时运行，结果都将一致，彻底告别“Flaky Tests”。
测试速度显著加快：
无需再使用
，你的测试套件可以以最快的速度运行。
代码简洁易读：
告别繁琐的手动
，通过简单的
函数即可完成时间控制，测试代码更加清晰、易于理解和维护。
轻松测试边缘情况：
以前难以测试的跨日、跨月、跨年逻辑，现在只需一行代码即可将时间调整到特定边界进行测试。
与 Carbon 无缝集成：
由于底层基于 Carbon，如果你已经在项目中使用 Carbon，那么这个插件的学习成本几乎为零。
在我的项目中，通过引入
，那些原本难以捉摸的时间相关测试变得异常简单和可靠。开发效率得到了显著提升，并且我对测试结果的信心也大大增加。
总结
时间敏感的业务逻辑在现代应用中无处不在，而为其编写高质量的测试是确保应用健壮性的关键。
这个 Pest 插件为我们提供了一个强大而优雅的解决方案，它利用 Composer 的便利性，将复杂的测试时间控制变得触手可及。如果你也正在为 PHP 应用编写 Pest 测试，并且遇到了时间相关的测试难题，那么我强烈推荐你尝试一下这个插件，它一定会让你的测试之旅更加顺畅！
sleep()Carbon::setTestNow()setTestNow()setTestNow(null)spatie/pest-plugin-test-timespatie/pest-plugin-test-timespatie/pest-plugin-test-timespatie/pest-plugin-test-timerequire --devcomposer require spatie/pest-plugin-test-time --devsetTestNow()composer.jsonrequire-devspatie/pest-plugin-test-timespatie/pest-plugin-test-timetestTime()Carbon::now()use Carbon\Carbon;
use function Spatie\PestPluginTestTime\testTime;
test('时间应该被冻结', function () {
testTime()->freeze(); // 冻结当前时间
$firstCall = Carbon::now();
sleep(2); // 即使等待2秒
$secondCall = Carbon::now();
expect($firstCall->toDateTimeString())->toBe($secondCall->toDateTimeString());
});use Carbon\Carbon;
use function Spatie\PestPluginTestTime\testTime;
test('可以在特定时间点冻结', function () {
testTime()->freeze('2023-01-01 12:00:00');
expect(Carbon::now()->toDateTimeString())->toBe('2023-01-01 12:00:00');
});testTime()use Carbon\Carbon;
use function Spatie\PestPluginTestTime\testTime;
test('可以前进或倒退时间', function () {
testTime()->freeze('2023-01-01 12:00:00');
testTime()->addHour(); // 时间变为 2023-01-01 13:00:00
expect(Carbon::now()->toDateTimeString())->toBe('2023-01-01 13:00:00');
testTime()->subMinute()->addSeconds(30); // 链式操作
expect(Carbon::now()->toDateTimeString())->toBe('2023-01-01 12:59:30');
});toBeCarbonuse Carbon\Carbon;
use function Spatie\PestPluginTestTime\testTime;
test('可以断言 Carbon 实例的值', function () {
$carbon = Carbon::createFromFormat('Y-m-d H:i:s', '2022-05-31 01:02:03');
// 断言完整的日期和时间
expect($carbon)->toBeCarbon('2022-05-31 01:02:03');
// 只断言日期部分
expect($carbon)->toBeCarbon('2022-05-31');
// 显式指定格式进行断言
expect($carbon)->toBeCarbon('2022', 'Y');
});spatie/pest-plugin-test-timesleep()Carbon::setTestNow()testTime()spatie/pest-plugin-test-timespatie/pest-plugin-test-time