Swoole异步文件读写通过事件循环与协程协同实现非阻塞IO：底层用epoll/kqueue注册非阻塞文件描述符，内核就绪后触发回调；协程层暂停/恢复执行栈，使异步操作看似同步；支持线程池或io_uring两种路径，2GB以上文件需手动分块处理。
要理解Swoole异步文件读写机制如何运作，必须看清它绕开了PHP原生阻塞式IO的底层路径，转而依赖操作系统级事件驱动模型与用户态协程调度的协同——这不是简单的“加个async关键字”，而是整个执行流被重定向到内核事件通知通道。
底层依赖：从阻塞系统调用到事件循环接管
传统PHP用fopen/fread时，进程会陷入内核态等待磁盘DMA完成，期间完全挂起；Swoole则在初始化阶段通过epoll（Linux）或kqueue（macOS）注册文件描述符，并将read/write操作转为非阻塞模式（O_NONBLOCK）。这意味着每次调用swoole_async_readfile时，内核立即返回EAGAIN错误，Swoole把该任务丢进事件循环队列，继续执行后续代码。
当磁盘IO真正就绪（比如页缓存命中或DMA传输结束），内核通过epoll_wait通知Swoole事件循环，循环体立刻唤起对应回调函数——整个过程不消耗CPU轮询，也不阻塞任何协程。
协程层：让异步行为看起来像同步
当你写co::readFile('/tmp/a.txt')，实际发生的是：
① 协程引擎检测到这是异步IO操作 → 暂停当前协程执行栈，保存上下文；
② 将读取任务提交给底层异步线程池（默认4个线程）或直接走内核异步IO（io_uring，需Linux 5.1+且编译开启）；
③ 主协程让出控制权，事件循环调度其他就绪协程；
④ IO完成时，协程引擎自动恢复原协程栈，把结果注入变量。【关键点：协程切换开销仅数百纳秒，远低于系统调用】
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
两种实现路径：线程池 vs 内核异步IO
方法一：默认线程池模式（兼容性最强）
所有异步文件操作由独立的worker线程执行，主线程只负责分发和回调派发。适用于所有Linux发行版，但存在线程间内存拷贝开销。
方法二：启用io_uring（需Swoole 5.0+ & 内核支持）
绕过线程池，直接向内核提交SQE（Submission Queue Entry），由内核在ring buffer中完成读写。避免了上下文切换和数据拷贝，吞吐量提升30%以上。启用方式：swoole_set_option(['use_io_uring' => true])。
【注意：io_uring模式下，超大文件（>2GB）仍受限于单次submit限制，需手动分块】
内存安全边界：为什么2GB是硬门槛
Swoole协程版co::readFile默认使用mmap加载文件，而Linux mmap对单个映射区有VM_MAX_MAP_AREA约束（通常2GB）；超过此值会触发ENOMEM而非分块处理。这不是Swoole的设计缺陷，而是内核虚拟内存管理的固有限制。
解决方案只能是主动分块：co::open($file, 'r')获取句柄 → co::read($fp, $chunk_size)循环读取 → 每次读完立即处理或写入临时缓冲区。这个过程必须手动控制偏移量，否则会重复读或跳字节。
