Symfony Clock组件通过抽象时间获取逻辑解决时间敏感代码测试难题：默认使用真实时间，支持FrozenClock冻结时间、MockClock模拟时间推进，并在Symfony中自动注入，兼容PHP 8.2+。
Symfony 的 Clock 组件让你摆脱 time()、new DateTime() 这类硬编码时间调用，把时间获取逻辑抽象成可替换的服务——测试时直接注入“冻结时间”或“模拟流逝”，彻底解决时间敏感代码难测的问题。
用 Clock 替代裸时间函数
默认情况下，Clock 使用系统真实时间，但它是可替换的。你只需把原本写死的时间操作换成 $clock->now() 或 $clock->sleep(5)，就能为后续测试铺平道路。
- 不推荐：
$now = new DateTime();或$ts = time(); - 推荐：
$now = $clock->now();（返回DateTimeImmutable） - 延时操作也统一：
$clock->sleep(3);（测试中可跳过等待）
在测试中冻结时间
使用 FrozenClock 可让所有时间调用返回同一个固定时刻，确保断言稳定。它特别适合验证缓存过期、令牌有效期、日志时间戳等场景。
- 在 PHPUnit 测试中：
$clock = new FrozenClock('2024-06-15 10:30:00 UTC'); - 注入到被测服务：
$service = new MyService($clock); - 调用
$clock->now()始终返回2024-06-15T10:30:00+00:00，不受测试执行时间影响
模拟时间推进与休眠
真实业务常依赖时间流逝（如重试间隔、轮询超时），MockClock 支持手动推进时间，配合 sleep() 模拟等待效果，无需 usleep() 拖慢测试。
立即学习“PHP免费学习笔记（深入）”；
- 创建并推进：
$clock = new MockClock(); $clock->sleep(10); $clock->advance(new \DateInterval('PT5S')); -
$clock->now()会随每次sleep()或advance()向后移动 - 适合测试“5秒后重试”、“30秒内未响应则超时”这类逻辑
在 Symfony 应用中自动注入
框架已自动注册 Symfony\Component\Clock\Clock 为服务别名 clock，你只需在构造函数或方法参数中类型提示即可获得实例。
- 控制器或服务中：
public function __construct(private Clock $clock) {} - 测试时覆盖服务定义：
services._test.clock: '@Symfony\Component\Clock\MockClock' - PHP 8.5.7 完全兼容，无需额外 polyfill —— Clock 组件自 v6.4 起原生支持 PHP 8.2+
