PHP 8.6 的 Io\Poll:给 stream_select 换掉内核后端,但不带 event loop
PHP 8.6 计划于 2026-11-19 GA,新增一套原生 I/O 轮询 API,命名空间为 Io\Poll。它取代的是用户态代码里对 stream_select() 的直接依赖,把多路复用下沉到扩展层,并顺带提供内部 C API 供其他扩展共享同一套后端。
API 组成
Io\Poll\Context:轮询上下文,负责注册 watcher 和等待事件Io\Poll\Watcher:单个被监视对象,可查询触发的事件Io\Poll\Backend枚举:后端类型Io\Poll\Event枚举:可读 / 可写等事件位Io\Poll\Handle接口:被监视句柄的抽象StreamPollHandle:PHP stream 的实现
底层后端按平台选择:Linux 用 epoll,BSD/macOS 用 kqueue,Solaris 用 event ports,Windows 用 WSAPoll,其余平台回落到 poll。同时支持 edge-triggered 与 one-shot 两种模式。
官方示例
use Io\Poll\{Context, Event};
use Time\Duration;
$poll = new Context();
$server = stream_socket_server('tcp://0.0.0.0:8080');
stream_set_blocking($server, false);
// 注册服务端 socket,只关心可读事件;第三个参数是附带的自定义数据
$poll->add(new StreamPollHandle($server), [Event::Read], ['type' => 'server']);
while (true) {
// 超时是 Time\Duration 对象,这里是 1 秒
foreach ($poll->wait(Duration::fromSeconds(1)) as $watcher) {
if ($watcher->hasTriggered(Event::Read)) {
// accept the connection
}
}
}
wait() 的超时参数是 Time\Duration,这是 PHP 8.6 同期引入的纳秒精度时长类型,不再是 stream_select() 那种「秒 + 微秒」两个 int 的写法。
和 stream_select 的差别
stream_select() 有三个结构性限制:
- fd 上限:依赖
fd_set,通常最大 1024,超过就不可用。 - 每次调用重建数组:读、写、异常三个数组要重新构造,兴趣集合无法在内核侧长期驻留。
- O(n) 扫描:返回后要遍历全部 fd 判断谁就绪,即使只有一个活跃连接。
Io\Poll 把兴趣集合交给 epoll / kqueue / WSAPoll 维护,不再受 fd_set 的位图大小限制。在存在这些后端的平台上,规模上去之后性能优于 stream_select()。
edge-triggered 与 one-shot 的取舍
edge-triggered 只在状态发生变化时通知一次,拿到事件后必须把数据读到 EAGAIN,否则剩余数据不会再触发通知——漏读就是挂起。
one-shot 是触发一次后 watcher 自动失效,处理完要显式重新 add。它避免了「忘记读干净」的坑,代价是每次事件都多一次注册开销,高吞吐场景下这笔开销不可忽略。
两者都不是默认帮你兜底的东西,选哪个取决于你的读取循环是否保证读尽。
没有内置 event loop
这一点容易被误读。stitcher.io 的说法是:PHP 8.6 没有引入 async 特性,只是换了一种更容易的方式与已有的异步能力交互。Io\Poll 只提供「等哪些 fd 就绪」这一层,定时器、协程调度、任务队列、Promise 组合这些仍然由用户态库负责。把它当成 event loop 用会缺很多零件。
RFC 里写明的主要动机其实是内部用途:信号处理、FPM 改进。用户态异步框架是次要受众。过去 PHP 只有 stream_select() 一种多路复用方式,这个 API 补的是这一层的空缺。
谁适合用
- 自己手写
stream_select()循环、并且已经碰到 1024 fd 上限的代码 - 需要在一个进程里同时盯大量连接,又不想引入完整异步框架的场景
- 扩展作者:可以通过内部 C API 复用同一套后端,不必各自封装
谁先别动
已经在 ReactPHP / AMPHP / Swoole 上的项目,短期没有更换的必要。这些库的高层抽象、定时器、协程调度都不在 Io\Poll 的覆盖范围内,换掉底层轮询只是把框架的一小块替换掉,收益有限。合理的路径是等框架自己适配新后端,业务代码不动。
同理,单进程只处理几个连接的脚本,stream_select() 依然够用,迁移过来只是多一层对象。