根本原因是事件循环未启动——必须显式调用 $loop->run()，否则 addTimer() 注册的定时器不会触发；重复执行应使用 addPeriodicTimer() 而非反复 addTimer()；回调需 try/catch 防异常静默失败；定时器精度不保证，不适合毫秒级精确调度。
ReactPHP 的 loop->addTimer() 为什么没触发？
根本原因通常是事件循环没真正跑起来——你调用了 addTimer()，但忘了调用 $loop->run()。ReactPHP 不是“注册即执行”，它依赖显式启动的事件循环来驱动所有定时器、I/O 等异步操作。
常见错误现象：addTimer() 返回了 TimerInterface 对象，控制台没报错，但回调函数从不执行；或者只执行一次就退出进程。
- 必须在添加所有定时器后，显式调用
$loop->run()（否则事件循环不启动） - 如果用了
$loop->stop()或异常中断了循环，后续定时器不会恢复，需重新run() - 不要在定时器回调里直接
exit()或抛未捕获异常，会终止整个循环
示例：
$loop = React\EventLoop\Factory::create();
$loop->addTimer(1.0, function () {
echo "Hello after 1 second\n";
});
$loop->run(); // ← 这一行不能少
重复执行用 addPeriodicTimer()，不是反复 addTimer()
想实现“每 500ms 检查一次 Redis 连接”，别写循环里不断 addTimer()——这会堆积大量待执行定时器，内存泄漏且逻辑失控。ReactPHP 提供专用的周期性定时器接口。
立即学习“PHP免费学习笔记（深入）”；
使用场景：心跳检测、轮询状态、定期刷新缓存、后台任务调度。
-
addPeriodicTimer($interval, $callback)自动按固定间隔重复触发，返回的是TimerInterface，可随时$timer->cancel() - 注意
$interval是秒为单位的浮点数（如0.5表示 500ms），不是毫秒 - 回调中若发生阻塞（如同步 cURL、sleep），会拖慢整个事件循环，务必用异步替代
示例：
$timer = $loop->addPeriodicTimer(0.5, function () use ($redisClient) {
$redisClient->ping(function ($result) {
if ($result !== 'PONG') {
// 触发重连逻辑
}
});
});
定时器回调里的异常会被吞掉，必须手动处理
ReactPHP 默认不会把定时器回调中的异常冒泡到顶层，而是静默失败——你看到“定时器没执行”，实际可能是内部 throw new Exception 被吞了。
性能影响：未捕获异常会导致该次回调中断，但定时器本身仍存活（PeriodicTimer 会继续下一轮），容易误判为“逻辑没生效”。
- 所有定时器回调都建议包一层
try/catch，至少记录日志 - 避免在回调中 throw 非 RuntimeException（ReactPHP 不保证所有异常类型都被捕获）
- 如果需要中断整个循环，用
$loop->stop()，而不是靠异常传播
示例：
$loop->addPeriodicTimer(2.0, function () {
try {
$data = file_get_contents('https://api.example.com/health');
json_decode($data, true) or throw new InvalidArgumentException('Invalid JSON');
} catch (Exception $e) {
error_log('Health check failed: ' . $e->getMessage());
}
});
多个定时器共存时，精度和顺序不保证
ReactPHP 基于 libevent / ext-event / stream_select 实现，底层没有高精度时钟支持。当系统负载高或存在大量 I/O 时，addTimer(0.1) 实际可能延迟 100–300ms 才触发，且多个定时器之间无执行优先级约定。
兼容性影响：在 Windows 上默认用 StreamSelectLoop，精度最差；Linux 推荐启用 ext-event 扩展提升稳定性。
- 别依赖“精确到毫秒”的执行时机，适合做“软实时”任务（如超时兜底、降级开关）
- 不要假设两个
addTimer(0.1)一定按注册顺序执行——它们可能被合并进同一次事件循环 tick - 高频定时器（
真正需要高精度调度的场景，应交由外部服务（如 Redis ZSET + Lua 轮询）或系统 cron 驱动，而非 ReactPHP 定时器。
复杂点在于：定时器只是事件循环的消费者之一，它的表现直接受制于整个应用的异步健康度——比如一个阻塞的数据库查询，会让后面所有定时器集体迟到。这点很容易被忽略。
