OpenSwoole 26.2.0 发布:支持 PHP 8.5、io_uring 后端及协程调试改进

升级方式

通过 PECL 安装:

复制代码
pecl install openswoole-26.2.0

或使用 Docker 镜像:

复制代码
docker pull openswoole/openswoole:26.2-php8.5-alpine

新特性

PHP 8.5 支持

OpenSwoole 26.2.0 完全兼容 PHP 8.5,支持管道操作符、URI 扩展、Clone With 等新特性。

PHP 原生 Fiber 协程上下文

新增基于 PHP 原生 zend_fiber API 的协程上下文后端,替代 Boost ASM 或 ucontext。该实现支持与 Xdebug、性能分析器及 Fiber 感知扩展的正确集成。

运行时启用:

复制代码
Co::set(['use_fiber_context' => true]);

或通过 INI 配置:openswoole.use_fiber_context=On

协程内 Xdebug 断点调试

启用 Fiber 上下文后,Xdebug 断点调试可在协程内正常工作。此前版本中"极其危险"的警告提示已被移除。

运行时选择事件驱动后端

支持在运行时选择事件驱动后端。

复制代码
Co::set(['reactor_type' => OPENSWOOLE_IO_URING]);

新增常量:OPENSWOOLE_EPOLL、OPENSWOOLE_KQUEUE、OPENSWOOLE_POLL、OPENSWOOLE_SELECT、OPENSWOOLE_IO_URING

io_uring 事件驱动后端

新增基于 Linux io_uring 的事件驱动实现,使用 IORING_OP_POLL_ADD 作为 epoll 的替代方案。编译时需启用 --enable-io-uring(依赖 liburing)。内核 5.13+ 支持 multishot poll,旧内核自动回退。

io_uring 异步文件 I/O 引擎

专用 io_uring 环形缓冲区处理异步文件操作(open、read、write、fstat、fsync、unlink、rename、mkdir、rmdir),替代线程池方案。不支持的操作用优雅回退至线程池。

事件循环延迟指标

通过 $server->stats() 实现实时事件循环延迟监控。按工作进程、任务进程(启用协程时)及 Reactor 线程(进程模式)暴露 event_loop_lag_ms、event_loop_lag_max_ms、event_loop_lag_avg_ms 指标。适用于检测阻塞操作导致的事件循环停滞。

协程安全的 exit() 支持

PHP 8.4+ 上,协程内的 exit() 调用会被拦截并抛出 openswoole_exit_exception,防止整个进程终止。

HTTP 解析器迁移至 llhttp

将自定义 openswoole_http_parser 替换为 llhttp 解析器,提升标准兼容性与性能。

Bug 修复

  • 修复反射问题与作用域泄漏(#284):OSW_FUNCTION_ALIAS 导致全局函数在反射中显示为类方法且返回类型损坏,已替换为正确的 PHP_FE/PHP_FALIAS 条目
  • 修复 io_uring 下文件 I/O 挂起:排空与重新武装 single-shot POLL_ADD 之间可能丢失 eventfd 通知的竞态条件
  • 修复文件锁 Bug:非阻塞 flock(LOCK_NB)现会在系统调用前正确检查进程内协程锁状态
  • 修复 CPU 亲和性编译检查:在 sched.h 前添加缺失的 _GNU_SOURCE 定义
  • 修复 futex 编译检查:在 linux/futex.h 前添加缺失的 _GNU_SOURCE 定义

破坏性变更

  • 移除 PHP 8.2 支持(最低要求 PHP 8.3)
  • 移除 PHP < 8.0 兼容代码
  • 命名空间规范化:openswoole_*
相关推荐
JasonChen@6669 小时前
2.Tomcat 安装部署与一键自动化脚本实战
java·tomcat
专注仿真9 小时前
基于 AFSIM 的智能体训练:多智能体强化学习篇 —— QTRAN 算法实战
开发语言·python·算法·php·强化学习·afsim智能体·仿真训练
SimonKing10 小时前
零 OCR 依赖!Firecrawl 这个 Rust 库把 Word / PPT / Excel 全变成 Markdown
java·后端·程序员
Rain的Java大神之路10 小时前
别被 ChatGPT 的打字机效果骗了:一字一字蹦,才是 LLM 自回归的命门(附大厂 Java 流式落地)
java·后端·面试
渣渣盟10 小时前
狂命爆肝99天,共52K字的JAVA学习笔记奉上,JAVA从入门到精通一文搞定,一文在手JAVA无忧
java·笔记·学习
亚那迦基10 小时前
24小时高危漏洞速报,互联网惊天危机来临!PHP、Java、Node.js、NGINX、GitLab无一幸免,看看你家是否中招
nginx·gitlab·php
BingoGo10 小时前
PHP 8.6 正式发布
后端·php
JaguarJack10 小时前
PHP 8.6 正式发布
后端·php·服务端
Funlang11 小时前
RISC-V 上的 Fun:第四套机器码
开发语言·risc-v·龙芯
星落梦生11 小时前
Maven高级(9)
java·maven