PHP原生不支持异步I/O，真正异步需Swoole等扩展；async/await不可用，Fibers仅为协程基础；Swoole协程须在Server环境启用并全程使用其封装函数，混用同步调用将导致阻塞。
PHP 本身不支持真正的异步 I/O，所谓“异步编程”在 PHP 中必须依赖扩展（如 Swoole）或外部服务（如消息队列 + 进程管理），直接用原生 fsockopen 或 cURL 模拟异步只是伪异步，会阻塞协程或进程。
为什么不能直接用 async/await 或 Promise？
PHP 8.1+ 虽引入了 fibers，但它只是协程调度基础，并不自带异步 I/O 能力；ReactPHP、Amp 等库需配合事件循环，但默认仍受限于 PHP 的单线程模型和同步扩展（如 mysqli、PDO 不支持非阻塞）。真正开箱即用的异步能力，目前只有 Swoole 提供了完整的用户态网络栈和协程封装。
常见错误现象：
– 写了 go(function () { sleep(3); echo 'done'; }); 却发现整个请求卡住
– 用 curl_multi_exec 并发 HTTP 请求，但 CPU 占用高、超时不可控、无法 await 返回值
– 在 Laravel 中直接 dispatch(new Job())->onQueue('redis') 就以为是“异步”，其实只是延后执行，不是 I/O 异步
Swoole\Coroutine 怎么启动并安全使用？
Swoole 协程不是“开启就能用”，它只在特定 Swoole Server 环境中自动启用（如 Swoole\Http\Server、Swoole\WebSocket\Server），且必须确保所有 I/O 操作走 Swoole 封装函数（如 Swoole\Coroutine\Http\Client），否则会退化为同步阻塞。
立即学习“PHP免费学习笔记（深入）”；
- 启动入口必须是 Swoole Server：不能在 CLI 普通脚本里调
go()就期望协程生效；需用php server.php启动一个长期运行的Swoole\Http\Server - 数据库必须换驱动：原生
PDO和mysqli是同步的；要改用Swoole\Coroutine\Mysql或co::mysql()（Swoole 4.8+） - HTTP 客户端不能用
file_get_contents：必须用Swoole\Coroutine\Http\Client或co::httpGet() - 注意协程隔离：每个协程有独立的
$GLOBALS、static变量，但global关键字访问的是进程级全局变量，容易引发数据污染
哪些函数能真正异步？哪些只是“看起来像”？
判断依据只有一个：该函数是否底层调用了 Swoole 的协程调度器（即是否在 Swoole\Coroutine\* 命名空间下，或以 co:: 开头）。
✅ 真正异步（协程挂起不占线程）：
– co::sleep(1)（毫秒级，非 sleep()）
– co::httpGet('https://api.example.com')
– (new Swoole\Coroutine\Http\Client('api.example.com', 443, true))->get('/')
– co::readFile('/tmp/data.txt')（Swoole 4.7+ 支持协程文件 I/O）
❌ 表面异步（实际仍同步阻塞）：
– file_get_contents('https://...')（即使在 go() 里也会阻塞整个协程）
– curl_exec($ch)（cURL 扩展未打 Swoole 补丁）
– Redis::get()（原生 phpredis 不支持协程；需改用 Swoole\Coroutine\Redis）
性能影响很直接：混用同步函数会让一个协程阻塞，导致其他协程无法调度，QPS 断崖式下跌；而全协程链路下，单个 worker 进程可轻松支撑数千并发连接。
上线前最容易被忽略的三个点
很多团队本地跑通 demo 就上线，结果压测崩盘。核心问题不在代码逻辑，而在环境与配置：
-
swoole.enable_coroutine = On必须在php.ini中显式开启（Swoole 4.6+ 默认开启，但某些 Docker 镜像或旧版本仍需手动配） - MySQL 连接池没做：每次
new Swoole\Coroutine\Mysql都新建 TCP 连接，高频请求下很快耗尽连接数；应封装成连接池，复用Swoole\Coroutine\Mysql实例 - 日志写入未协程化：用
error_log()或file_put_contents(..., FILE_APPEND)会阻塞；应改用Swoole\Coroutine\WriteFile或投递到chan由专用协程刷盘
协程不是魔法开关，它是把“等待”从线程切换变成轻量级上下文切换——但前提是整条调用链都适配。漏掉任何一个同步环节，就等于在高速公路上突然修了个收费站。
