php 8.6 的标准库投资仍在继续。基金会 11 月 3 日文章(作者 tim düsterhus)介绍了两个已确认进入 8.6 的标准库新增:sortdirection 枚举只有 ascending / descending 两个成员;time\duration 类以纳秒精度表示从 1 纳秒到百年以上的时长,配套的新轮询 api 是第一个接受它的接口。

▲ 事件来源页面实时截图:PHP Foundation Blog
方法论看点
文章同时说明 Time\Instant 与 Time\Clock RFC 正在讨论中,标准库 API 采用「小步 RFC、用命名空间逐步替换既有 API」的路径。自维护库的公共 API 可以借鉴这种兼容策略——用联合类型提前兼容新标准库类型。来源:thephp.foundation/blog/2026/11/03/stdlib-investment/
SortDirection 与 Time\Duration 是什么
8.6 的标准库新增两个小而有用的 API:SortDirection 用枚举替代「传 1 或 -1 表示升降序」的魔法值,让排序参数自解释;Time\Duration 提供时长值对象,用于表达与计算时间间隔,避免把秒数散落在代码各处。
升级时的适配
这两个 API 属于新增,不破坏既有代码。可以在 8.6 上逐步替换内部约定:把自定义的排序常量换成枚举,把散落的时长计算收敛到 Duration;同时留意序列化与类型声明(枚举不能隐式转字符串)。
小 API 的长期价值
枚举替代魔法值能显著降低接口误用;Duration 把「秒/毫秒」的单位歧义收敛到一个类型里。两者都属渐进式改进:新代码优先用,旧代码按模块替换。
立即学习“PHP免费学习笔记(深入)”;

▲ 官方公告页配图
关键信息
| 项目 | 内容 |
|---|---|
| 类目 | RFC 与需求 |
| 级别 | 中 |
| 日期 | 2026-11-03 |
| 关联编号 | SortDirection / Time\Duration / Time\Instant RFC |
| 影响范围 | PHP 8.6 标准库 / 生态库公共 API |
| 核验状态 | 已官方确认 |
来源:https://thephp.foundation/blog/2026/11/03/stdlib-investment/



















