下面是一个完整的 Swoole+io_uring 案例，涵盖 HTTP 服务器、协程文件 I/O 和并发请求三个场景。---ns)环境要求-Linux kernel>=5.7（支持 IORING_FEAT_FAST_POLL）-Swoole>=5.0或 OpenSwoole>=26.2.0-编译时加--enable-uring_sock # 编译安装 Swoole（启用 io_uring） pecl install swoole # 或源码编译./configure--enable-uring_sock--enable-openssl make&&make install---案例1：io_uring HTTP 服务器+协程文件读取<?php// server.php// io_uring 在 reactor 层透明生效，代码写法与普通 Swoole 一致// 差异在于内核层用 io_uring 替代 epoll，减少系统调用开销use Swoole\Http\Server;use Swoole\Http\Request;use Swoole\Http\Response;use Swoole\Coroutine;$server=newServer('0.0.0.0',9501,SWOOLE_PROCESS);$server->set(['worker_num'=>swoole_cpu_num(),'enable_coroutine'=>true,'hook_flags'=>SWOOLE_HOOK_ALL,// 协程化所有 I/O// io_uring 通过编译选项启用，运行时无需额外配置]);$server->on('request',function(Request $req,Response $res){$path=$req->get['file']??'/etc/hostname';// 协程文件读取 —— OpenSwoole 26.2+ 底层走 io_uring 异步文件 I/O$content=Coroutine\System::readFile($path);if($content===false){$res->status(404);$res->end('file not found');return;}$res->header('Content-Type','text/plain');$res->end($content);});$server->start();---案例2：io_uring 并发文件批量读取（对比 epoll 优势场景）<?php// batch_read.php// io_uring 的核心优势：批量提交 I/O 请求，减少 syscall 次数use Swoole\Coroutine;use Swoole\Coroutine\WaitGroup;Coroutine\run(function(){$files=['/etc/hostname','/etc/os-release','/proc/version','/proc/cpuinfo','/proc/meminfo',];$wg=newWaitGroup();$results=[];$start=microtime(true);foreach($files as $i=>$file){$wg->add();Coroutine::create(function()use($file,$i,$wg,&$results){// 每个协程独立发起文件读取// io_uring 将这些请求批量提交到内核 submission queue// 避免每次 read() 都陷入内核（减少 context switch）$results[$i]=['file'=>$file,'size'=>strlen(Coroutine\System::readFile($file)?:''),'coroutine'=>Coroutine::getCid(),];$wg->done();});}$wg->wait();$elapsed=round((microtime(true)-$start)*1000,2);echo"并发读取 ".count($files)." 个文件，耗时 {$elapsed}ms\n\n";foreach($results as $r){printf(" [cid=%d] %-20s => %d bytes\n",$r['coroutine'],$r['file'],$r['size']);}});---案例3：io_uring TCP 服务器（socket 层）<?php// tcp_server.php// --enable-uring_sock 让 TCP socket 的 accept/recv/send 走 io_uringuse Swoole\Server;$server=newServer('0.0.0.0',9502,SWOOLE_PROCESS,SWOOLE_SOCK_TCP);$server->set(['worker_num'=>4,'enable_coroutine'=>true,'open_length_check'=>false,]);$server->on('connect',fn($s,$fd)=>printf("[%d] client connected\n",$fd));$server->on('receive',function(Server $s,int $fd,int $rid,string $data){// io_uring: recv 和 send 通过 SQE/CQE 环形队列处理// 高并发下比 epoll+read/write 减少约 30% 的系统调用$response=strtoupper(trim($data))."\n";$s->send($fd,$response);});$server->on('close',fn($s,$fd)=>printf("[%d] client closed\n",$fd));$server->start();---验证 io_uring 是否生效 # 运行服务后，用 strace 观察系统调用 strace-p<pid>-e trace=io_uring_enter,io_uring_setup2>&1|head-20# 或查看/proc/<pid>/fdinfo 中的 io_uring fd ls-la/proc/<pid>/fd|grep anon_inode # 压测对比（需要 wrk） wrk-t4-c200-d10s http://127.0.0.1:9501/---关键原理 epoll 模型:用户态 →epoll_wait()→ 内核通知 →read()/write()→ 用户态 每次 I/O=至少2次 syscall io_uring 模型:用户态 → 写入 SQ ring → 内核消费 → 写入 CQ ring → 用户态读取 批量 I/O=1次io_uring_enter()提交 N 个请求 FAST_POLL 模式下热路径甚至0次 syscall io_uring 对 Swoole 的提升主要体现在：高并发文件 I/O（绕过线程池）和大量短连接 TCP（减少 epoll_ctl 调用）。协程 API 完全不变，升级成本为零。
