swoole异步操作笔记按网络/io/数据库/系统调用四类归集纯异步回调api，每项标注极简签名、必填参数及不可逆前提（如【必须启用异步扩展】【文件路径必须绝对】），附真实errno映射（重点标eagain=11需重试），并明确回调执行边界与变量作用域限制。
你需要把零散的 Swoole 异步操作要点（比如异步文件读写、异步 DNS、异步 MySQL、协程切换时机）变成可快速查阅、不翻源码就能复用的笔记，避免每次写异步逻辑都重新查文档或试错。
按异步类型归类核心 API
先建立一级分类：网络类、IO 类、数据库类、系统调用类。每类只收真正支持 纯异步回调模式 的接口，排除协程封装层（如 Swoole\Coroutine\sleep 不放这里，它本质是协程调度，不是异步回调）。
例如「网络类」下只列：swoole_async_dns_lookup、swoole_async_set（设置 DNS 服务器）、swoole_event_add（配合自定义 socket）；而 Swoole\Coroutine\DNS\lookup 属于协程范畴，放入另一张协程笔记表。
每个 API 后紧跟一行极简签名和必填参数说明，不写返回值类型——因为异步回调里根本拿不到同步返回值。
标注每个异步操作的“不可逆前提”
在笔记对应条目旁加粗标记关键限制条件，不满足则直接失败且无提示：
【必须启用异步扩展】：swoole_async_writefile 要求编译 Swoole 时开启 --enable-async-redis？错。实际只需 --enable-async，但 PHP 必须加载 ev 或 libevent 扩展，否则调用后静默失败。
【文件路径必须绝对】：用 swoole_async_readfile("config.ini") 会报错“File not found”，因为异步 IO 不走 PHP 的 include_path，必须写成 __DIR__ . '/config.ini'。
这类坑不标清楚，三天后你自己都会忘。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
记录真实失败场景与 errno 映射
方法一：直接抄官方 errno 表，但删掉你永远遇不到的（如 ENOTCONN 在异步写文件里根本不会触发）。
方法二：运行实测并截图错误日志，把 errno=2 对应到 “No such file or directory”，errno=13 对应到 “Permission denied”，然后在笔记里用表格呈现。重点标出 errno=11（EAGAIN）——它表示缓冲区满，不是错误，要重试，但很多人误判为失败直接退出。
这一步不做，调试时只能靠 var_dump($result) 猜。
画出异步回调的执行边界
第一步：用纸笔画一个时间轴，横轴是代码执行流，纵轴是事件循环。
第二步：在轴上标出 swoole_async_writefile 调用点，再标出回调函数入口点，中间画虚线并注明：“此处 CPU 可能已执行其他任务，变量作用域已销毁”。
第三步：在回调函数入口点右侧写一句警告：【闭包外的局部变量不可访问】。例如你在回调里试图 echo $filename，但 $filename 是外层函数的参数，没 use 进去就为空——这不是 bug，是异步模型的天然约束。
第四步：在回调函数内部，用不同颜色笔圈出可安全使用的资源：全局变量、静态变量、传入的引用参数、对象属性（前提是该对象生命周期覆盖整个事件循环）。
