Clock 组件是 Symfony 中替代 new DateTime() 或 time() 的标准时间源抽象，必须通过依赖注入引入业务代码以实现可控测试，而非仅在测试中 mock 时间函数。
Clock 组件不是“辅助工具”，而是 Symfony 里替代 new \DateTime() 或 time() 的**标准时间源抽象**。直接在业务代码中依赖它，才能让测试真正可控——光靠测试时 mock 时间函数是治标不治本。
为什么不能只在测试里 mock time() 或 DateTime::createFromFormat？
因为这类 patch 方式（比如用 phpunit/phpunit 的 @runInSeparateProcess 或 set_time_limit() 干扰）只影响当前进程，且无法覆盖所有时间获取路径（如第三方库内部调用、扩展函数 gettimeofday()、或 date_default_timezone_set() 导致的隐式偏移）。更关键的是：它没解决业务代码本身的耦合问题。
- 业务类硬编码
new \DateTime()→ 无法注入、无法替换、无法验证行为 - 测试中用
ini_set('date.timezone', 'UTC')→ 只能统一时区，不能控制“此刻是哪一秒” - 依赖系统时钟 → CI 环境时区/时间不同步时，测试随机失败（比如 Jenkins 上
DateTime::now()返回 1970-01-01）
把 Clock 注入到服务里，而不是 new DateTime()
核心动作是：让业务逻辑通过接口获取时间，而非自己构造。
- 用
Symfony\Component\Clock\ClockInterface替代DateTime实例化 - 在服务构造器中声明依赖：
public function __construct(private ClockInterface $clock) {} - 业务方法中改写：
$now = $this->clock->now();（返回DateTimeImmutable），或$this->clock->sleep(1)模拟等待 - 容器会自动注入
App\Clock\NativeClock（生产环境）或Symfony\Component\Clock\MockClock（测试环境）
示例：
class ExpiryChecker
{
public function __construct(private ClockInterface $clock) {}
public function isExpired(\DateTimeInterface $expiresAt): bool
{
return $this->clock->now() > $expiresAt;
}
}
测试时用 MockClock 控制“现在”和“流逝”
MockClock 不是装饰器，它是一个可进可退的时间游标。你设定一个基准时间，再调用 advance() 或 setNow()，所有通过该实例获取的时间都会随之变化。
- 初始化：
$clock = new MockClock(new \DateTimeImmutable('2026-07-09T10:00:00Z')); - 推进 5 秒：
$clock->advance(5);→ 下次$clock->now()返回2026-07-09T10:00:05Z - 跳到固定时刻：
$clock->setNow(new \DateTimeImmutable('2026-12-25')); - 注入到被测服务：
$checker = new ExpiryChecker($clock);
注意：别在测试中用 ClockMock::register() ——那是旧版 PHPUnit Bridge 的全局钩子，和 ClockInterface 无关，且已被弃用。
容易忽略的兼容性陷阱
真正卡住人的往往不是逻辑，而是版本和注入链。
-
Symfony\Component\Clock\ClockInterface从 Symfony 6.2 起才稳定提供；6.1 是实验性，5.x 完全没有 —— 别在 Symfony 5 项目里强行 requiresymfony/clock - 若服务通过 setter 注入
ClockInterface，确保测试中调用了 setter；若用 autowire，确认services.yaml中未禁用bind或覆盖了ClockInterface的默认实现 -
MockClock返回的DateTimeImmutable和业务中传入的DateTime（可变）比较时，PHP 会自动转换，但语义上建议统一用DateTimeImmutable避免意外修改
最常漏掉的一点：Clock 是单例，但 MockClock 实例必须和被测对象共用同一个实例 —— 如果你在测试里 new 了一个，又在服务里从容器取了一个，那 mock 就完全失效了。
