Swoole 4 文件异步读写需配置运行时环境、选择合适API并适配模式：启用协程Hook可使标准PHP文件函数自动协程化；显式异步API适用于中小文件一次性读写；分段读取适合大文件；AIO模式可通过swoole_async_set调优。
Swoole 4 的文件异步读写不是简单替换函数就能生效的，关键在于运行时环境配置、API 选择与模式适配。直接调用 fopen 等函数在协程启用后会自动协程化，但若需更高并发或精细控制，仍应区分使用原生 AIO 或线程池模拟模式。
启用协程化文件 IO（推荐入门方式）
从 Swoole 4.2.0 起，只需开启全局协程 Hook，所有标准 PHP 文件函数（fopen、fread、fwrite、file_get_contents、file_put_contents 等）即可自动转为非阻塞协程行为：
- 调用
Swoole\Runtime::enableCoroutine(true)必须在协程启动前执行，通常放在服务初始化最开始 - 后续所有协程内使用的文件操作都会被底层 AIO 线程池接管，无需改写逻辑
- 注意：协程内不能混用同步阻塞调用（如未 Hook 的 cURL），否则会拖垮整个协程调度
显式异步 API：swoole_async_readfile / swoole_async_writefile
适用于一次性读写中小文件（默认上限 4MB），回调驱动，不依赖协程环境：
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
-
swoole_async_readfile($path, $callback)读完即触发回调，适合配置加载、日志快照等场景 -
swoole_async_writefile($path, $content, $callback, $flags = 0)支持FILE_APPEND追加写入 - 失败时回调不会被调用，需检查函数返回值（
false表示投递失败，如路径不可写、磁盘满等）
分段异步读取大文件：swoole_async_read
处理 GB 级日志或导出文件时避免内存溢出，按块读取并可控续读：
- 每次只读指定字节数（
$size），支持从任意偏移（$offset）开始 - 回调函数接收
$filename和$content，若$content为空说明已读完 - 回调中 return
true继续下一段，returnfalse或不返回则终止读取 - 注意：该函数不支持写操作，仅用于读
选择 AIO 模式与调优参数
通过 swoole_async_set() 可切换底层实现，影响性能边界和使用限制：
-
SWOOLE_AIO_LINUX：Linux 原生 AIO，真正无栈异步，但强制 DirectIO（绕过 PageCache），要求 offset/size 对齐 512 字节，适合 SSD 随机写密集型场景 -
SWOOLE_AIO_BASE（默认）：线程池模拟，可利用系统缓存，热数据读极快；通过thread_num控制并发能力（建议设为 CPU 核数 1–2 倍） - 设置示例：
swoole_async_set(['aio_mode' => SWOOLE_AIO_BASE, 'thread_num' => 8])
