PHP hrtime 怎样测量短代码的单调耗时

如果只是想知道一段 PHP 代码“花了多久”，优先使用 hrtime()：它提供单调的高精度计时，适合拿结束值减开始值。不要把这个值保存成订单时间或展示给用户，因为它从任意起点开始，不是 Unix 时间戳。业务发生时间仍应使用日期时间接口，性能耗时则使用 hrtime()。

官方资料：https://www.php.net/manual/en/function.hrtime.php

先分清“现在几点”和“经过多久”

性能计时最怕把两个概念混在一起。业务时间需要能对应现实世界，例如订单创建时间；性能计时只需要比较同一段程序前后的差值。系统时钟可能被校准或调整，而 hrtime() 的设计目标就是提供单调的经过时间。

microtime(true) 返回当前 Unix 时间的浮点表示，适合记录当前时间；PHP 手册也明确建议性能测量优先使用 hrtime()。所以，日志中的“发生时间”和“代码耗时”最好使用不同字段、不同单位。

hrtime() 的两种返回形态怎么选

不传参数时，hrtime() 返回形如 [秒, 纳秒] 的数组；传入 true 时，返回一个以纳秒表示的数值。短代码计时通常直接选择整数形态，差值表达式更短；需要拆开查看秒和纳秒字段时，再选择数组形态。

这里的数值是计时刻度，不代表从 1970 年开始的时间。不要把 $ticks 直接写进 created_at，也不要与 time() 或日期对象相加。

用结束值减开始值计算短代码耗时

最小可用写法是：代码段前调用一次 hrtime(true)，代码段后再调用一次，然后用结束值减开始值。差值默认是纳秒，换算时只改变展示单位，不改变原始测量值。

如果要比较多次运行，不要只记录一次结果。可以重复采样并保存每次差值，再观察中位数或高分位；单次耗时容易受到缓存、调度和输入内容影响。

数组形态的差值为什么要单独处理

数组形态把秒和纳秒拆成两个整数，不能简单地只减第二个元素。跨过整秒时，纳秒部分可能出现负数，因此应先把两端都换算成统一的纳秒数，或者使用“秒差乘十亿再加纳秒差”的公式。

在常见 64 位 PHP 环境里，这种换算适合短时间段统计；如果你的运行环境可能返回失败值，应先判断返回结果，再进入数组下标访问。

失败值、浮点数和采样边界

手册定义 hrtime() 失败时可能返回 false。生产代码不要直接假定结果一定是数组或整数，尤其是封装成通用性能工具时，要先判断失败，再决定是否记录本次样本。

上面的 calculateSomething() 和 recordMetric() 是业务占位函数，接入项目时替换成真实实现。若使用 32 位平台，hrtime(true) 可能返回浮点值；需要严格整数统计时，应结合运行平台和数值范围设计存储方式，不能只凭变量名假设类型。

把 hrtime 放在正确的性能采样层

在高并发服务中，计时器本身只是观测边界。应把开始点放在目标操作之前，把结束点放在目标操作之后，并明确是否包含序列化、网络等待、日志和重试。不同边界得到的是不同指标，不能把它们放进同一条曲线比较。

这也是“规模化”场景里最容易被忽略的取舍：计时精度越高，不代表指标就越有意义。先固定采样边界，再决定是否需要纳秒级存储；否则得到的只是精确但无法比较的数字。

常见问题

hrtime() 能不能拿来生成时间戳？

不能。它从任意起点计时，适合比较经过时间，不适合表达现实世界的日期和时间。

hrtime(true) 返回的数字单位是什么？

语义上是纳秒计数。用结束值减开始值后，除以 1_000_000 可换算为毫秒，除以 1_000 可换算为微秒。

什么时候还应该使用 microtime()？

需要当前 Unix 时间、请求到达时间或可与业务日期对应的时间时使用 microtime()；只测代码经过时间时优先使用 hrtime()。

小结

PHP 测量短代码耗时的核心只有三点：用 hrtime() 获得单调计时，用结束值减开始值，用明确单位保存和展示。数组形态适合拆分字段，true 形态适合直接计算；失败值和 32 位浮点边界则应在通用封装中显式处理。最后固定采样范围，才能让不同请求、不同版本的耗时数据真正可比较。