<p>应使用 co::readFile 和 co::writeFile 替代已废弃的 swooleasync* 函数，因其是真协程 IO、支持异常捕获、超时控制与并发调度，且与协程生态无缝兼容。</p>
别用 swoole_async_readfile 和 swoole_async_writefile —— 它们在 Swoole 4.4+ 已被标记为 deprecated，新项目强行用会埋下兼容性和维护隐患。
为什么 swoole_async_* 函数现在不推荐用了
这些函数底层依赖线程池模拟异步，实际是“伪异步”：每个调用都扔进一个独立线程执行，主线程不卡但线程开销大、上下文切换重、错误堆栈难追踪。更关键的是，它们只支持本地文件，无法与协程生态（如 Co\Http\Client、Co\MySQL）统一调度。
常见错误现象：swoole_async_readfile 回调里直接 return 或赋值给外部变量，结果主流程早结束了，变量还是空的——这不是 bug，是设计使然，它压根没打算和你“同步等待”。
- 最大读取限制 4MB，超限直接失败，且无分块回调机制
- 不支持超时控制、取消操作、进度反馈等现代 IO 必需能力
- PHP 8.0+ 下部分系统（如 Alpine）线程池初始化失败概率上升
co::readFile 和 co::writeFile 怎么安全替换
协程版文件 IO 是真正的“同步写法 + 异步语义”，调用即阻塞当前协程而非进程，资源复用率高，且能和其它协程客户端无缝混用。
使用场景：日志写入、配置热加载、临时文件解析、上传后预处理等需要“拿到内容再继续”的环节。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
参数差异明显：co::readFile 直接返回字符串或抛出 RuntimeException；co::writeFile 第三个参数是 flag，FILE_APPEND 要显式传，不像 swoole_async_writefile 那样靠第四个参数位置判断。
// 正确用法：带异常捕获
try {
$content = co::readFile('/tmp/data.json');
$data = json_decode($content, true);
} catch (Throwable $e) {
// 文件不存在、权限不足、编码错误都会进这里
Log::error('read fail: ' . $e->getMessage());
}
- 默认超时 5 秒，可通过
Swoole\Coroutine::set(['socket_timeout' => 30])全局调整 - 不支持直接读取 >2GB 的单文件（底层受限于内存映射），大文件请用
co::open+co::read分段 - 路径必须是绝对路径，相对路径行为未定义（尤其在 Worker 进程中 chdir 后容易出错）
并发读多个文件时，为什么还慢？
写十个 co::readFile 不等于并发十路 IO —— 默认是串行执行。协程本身不自动并发，只是提供了并发的“容器”。
性能影响很实际：串行读 10 个 100ms 延迟的文件，总耗时约 1s；并行则接近 100ms。但盲目并发也可能打爆磁盘 IOPS 或触发 Linux aio 限流。
// 正确并发写法：启动 5 个协程并行读
$files = ['/a.txt', '/b.txt', '/c.txt', '/d.txt', '/e.txt'];
$wg = new Swoole\Coroutine\WaitGroup();
$wg->add(count($files));
foreach ($files as $file) {
go(function () use ($file, $wg) {
try {
echo co::readFile($file) . "\n";
} finally {
$wg->done();
}
});
}
$wg->wait(); // 等全部完成
- 别用
go(function () { ... })无节制启协程，建议配合WaitGroup或信号量限流 - Linux 下
aio-max-nr默认常为 65536，大量并发文件 IO 可能撞上限，需检查/proc/sys/fs/aio-max-nr - SSD 和 HDD 对并发 IO 的响应差异极大，压测前务必在目标环境验证
协程文件 IO 容易被忽略的坑
最常被跳过的点：不是所有文件操作都能协程化。比如 fopen+fread 组合，即使包在 go 里，仍是同步阻塞——Swoole 不会 Hook 标准 PHP 文件流函数。
另一个隐形雷区：Worker 进程生命周期内，文件句柄不会自动关闭。反复 co::open 不 co::close，最终触发 “Too many open files” 错误。
-
co::readFile内部已做open/read/close封装，安全；但手动co::open必须配对co::close - 日志类封装中若缓存了
co::open返回的 fd，需确保在onWorkerStop或请求结束时释放 - 协程 Hook 开关状态会影响行为：若忘了调
Swoole\Runtime::enableCoroutine()，co::readFile会退化为同步调用
