异步IO本质是事件驱动非阻塞，靠epoll/kqueue实现“不等结果就继续执行”，区别于多线程；Swoole 4.4+已弃用swoole_async_*，推荐协程方式（如co::readFile），其以同步写法实现异步调度，需全链路协程化。
异步IO不是“多线程”，而是“不等结果就继续跑”
很多人一看到“异步”就下意识想成开了多个线程或进程，其实 Swoole 的异步 IO（比如 swoole_async_readfile、swoole_client->connect 带回调的用法）根本没启动新线程——它靠的是 Linux 的 epoll / kqueue 这类事件机制，在等待磁盘读、网络响应时，把 CPU 让给其他任务，等内核通知“数据到了”，再触发你写的回调函数。
所以关键区别在于：同步调用会卡住当前协程/进程，异步调用只是注册一个监听+回调，立刻返回，后续逻辑照常执行。
- 常见错误现象：
swoole_async_readfile里直接 return 或 echo 某个变量，发现啥也没输出——因为回调还没触发，主流程早跑完了 - 使用场景：适合高并发下处理大量慢速 IO（如读日志、调外部 HTTP、写文件），但不适合需要立刻拿到结果的逻辑（比如用户登录校验密码）
- 注意：
swoole_async_*系列函数在 Swoole 4.4+ 已被标记为 deprecated，新项目优先用协程方式（co::readFile）
协程里的“异步”其实是同步写法 + 异步调度
现在主流写法是用协程：co::readFile、Co\Http\Client、Co\MySQL。它们看起来像同步代码（没有回调函数嵌套），但底层仍是非阻塞 IO，靠协程让出和恢复来实现“不卡主线程”。
比如 co::readFile('/tmp/data.txt') 这行代码，执行时如果文件还没读完，协程就主动挂起，引擎去跑别的协程；等 IO 完成，再唤醒它继续往下走——对你来说是“一行写完就得到内容”，对系统来说是“没浪费 CPU 等着”。
- 参数差异：
co::readFile返回字符串或抛异常；swoole_async_readfile必须传回调函数，且只支持本地文件 - 性能影响：协程方式更轻量（无回调地狱、内存开销小），但要求整个调用链都协程化；混用同步阻塞函数（比如
file_get_contents）会直接拖垮整个进程 - 兼容性：Swoole 4.4+ 默认启用协程 Hook，但像
cURL、pdo_mysql这类扩展需显式开启Swoole\Runtime::enableCoroutine()才能异步化
“异步”不等于“并行”，并发数得自己控
写十个 co::readFile 调用，并不意味着同时发起十个磁盘读——默认是串行的。真要并发，得用 go 启动多个协程，或者用 Swoole\Coroutine\WaitGroup 管理。
否则容易误判性能：以为加了协程就自动提速，结果 IO 还是一个一个排队，吞吐量没变，只是延迟毛刺少了。
- 常见错误现象：循环里直接写
co::readFile，接口耗时跟同步一样长 - 正确做法：用
go(function () { co::readFile(...); });把每个 IO 包进独立协程，再用WaitGroup等全部完成 - 坑点：协程数量不是越多越好，Linux 文件描述符、磁盘 IOPS、内存都会成为瓶颈；建议结合
setrlimit和压测调优
回调函数里不能用 $this？那是没搞清运行上下文
在 swoole_async_readfile($path, function ($filename, $content) { ... }) 这种老式回调里，匿名函数默认不绑定对象上下文，$this 是 null。这不是 Bug，是 PHP 闭包的天然行为。
如果你非要访问类成员，得显式 use：function ($filename, $content) use ($this) { ... }；但更推荐的做法是彻底放弃这种回调风格，改用协程——所有变量作用域自然延续，$this、use、global 全都不用操心。
- 错误示范：
function () { var_dump($this->config); }→ Fatal error: Using $this when not in object context - 临时解法：用
use ($this)或提前把需要的属性 extract 出来（use ($config, $logger)） - 根本解法：协程函数里直接写
$this->doSomething()，只要确保调用栈全是协程安全的即可
真正难的不是理解“异步”这个词，而是意识到：Swoole 的异步能力必须整条链路配合——从启动方式（Server vs Coroutine\Run）、IO 调用（协程函数）、到错误处理（try/catch 在协程里才有效）——漏掉任何一环，就退回阻塞世界。
