Timer::add 不返回定时器对象而是全局单例调度器，仅返回整数ID用于Timer::del；所有任务由主进程统一轮询触发，不支持单独生命周期控制、回调中修改执行时间或销毁停止；多进程下每个子进程独立执行，需用分布式锁确保单次运行；最小精度约0.1秒，非毫秒级；禁止阻塞操作和未捕获异常。
Workerman 的 Timer::add 不是「定时器对象」，而是全局单例调度器
很多人以为 Timer::add 会返回一个可管理的定时器实例（比如能 cancel() 或 reset()），实际它只是往 Workerman 内部的静态任务队列里塞一条调度指令，没有句柄、不返回对象。所有定时任务都由 Worker 主进程统一轮询触发，底层靠 pcntl_signal + usleep 驱动，不是基于 event loop 的异步定时器。
这意味着：你无法单独控制某个定时任务的生命周期；不能在回调里直接修改它下次执行时间；也不能靠“销毁对象”来停止——只能用 Timer::del 配合 ID 手动清除。
-
Timer::add返回的是一个整数 ID，仅用于后续Timer::del($id)，别指望它有方法或属性 - 回调函数必须是可调用类型（
function、[$obj, 'method']、fn() => ...），不能是字符串函数名（如'test_func'）——PHP 8.1+ 会报TypeError - 如果 Worker 进程重启（比如 reload），所有未 del 的定时任务自动失效，不会跨进程持久化
定时任务在多进程下执行几次？看 Worker::$processCount
Workerman 默认启动一个主进程 + 多个子 Worker 进程（取决于 Worker::$processCount）。每个子进程都会独立运行自己那一份 Timer::add 注册的任务——也就是说，如果你在 Worker::runAll() 前写了 Timer::add(1, fn() => echo "tick\n")，且 $processCount = 4，那每秒会输出 4 行 "tick"，而不是 1 行。
- 想让任务只执行一次？必须加进程判断：
if (Worker::$pid === Worker::$masterPid)——但注意，$masterPid是主进程 PID，而定时器不能在主进程中运行（主进程不跑事件循环），所以这行其实无效 - 真正可靠的做法：用文件锁、Redis 分布式锁，或把定时逻辑移到单独的「守护型 Worker」中，并设
$processCount = 1 - 误在
onWorkerStart里反复Timer::add，会导致每个子进程都注册一遍，最终任务执行频次翻 N 倍
Timer::add 的间隔参数单位是「秒」，但最小精度约 0.1s
文档写“支持浮点数”，但底层依赖 usleep 和主循环调度频率，实际达不到毫秒级稳定精度。例如 Timer::add(0.01, $cb) 并不会每 10ms 触发，大概率变成每 100~200ms 一次，甚至更不规律——尤其在高负载或大量并发连接时。
- 需要亚秒级调度（如 500ms 心跳），建议用
Timer::add(0.5, $cb)，别写0.499或500e-3，没意义 - 如果业务强依赖精确时间（比如金融对账），别用
Timer，改用系统 cron + HTTP/CLI 调用接口，或引入reactphp/event-loop等更精细的调度器 - 间隔设为
0是非法的，会触发 warning 并跳过注册；设为负数则直接静默失败
回调里不能用阻塞操作，否则整个 Worker 进程卡住
Timer::add 的回调是在 Worker 进程的事件循环中同步执行的。一旦你在里面调用 sleep()、file_get_contents()（无超时）、mysqli_query()（同步）等阻塞操作，当前进程立刻停摆，既无法处理新连接，也无法触发其他定时任务，直到阻塞结束。
- 数据库操作务必用异步客户端（如
workerman/mysql）或丢到Worker::sendToWorkerProcess()子进程里做 - HTTP 请求推荐
Workerman\Http\Client，它内部是非阻塞的；别用curl_exec或file_get_contents - 日志写入也需注意：如果用
file_put_contents(..., FILE_APPEND)且磁盘慢，同样会卡——建议走Monolog+StreamHandler异步刷盘，或先写内存再批量 flush
最常被忽略的一点：Timer 回调里抛出的未捕获异常，不会打印错误日志，也不会终止进程，而是被 Workerman 吞掉——你得手动 try/catch 并写日志，否则定时任务某天突然不跑了，连线索都没有。
