协程中禁用原生同步I/O函数,须改用swoole协程客户端:http/Client、mysql、redis等;https需传true参数;禁用mysqlnd缓存;延时须用co::sleep()而非sleep()。

协程里不能直接用 curl_exec 或 file_get_contents
php 原生的 curl_exec、file_get_contents、mysqli_query 等同步 I/O 函数在 Swoole 协程环境下会阻塞整个协程调度,导致其他协程无法运行。这不是“不支持”,而是它们底层调用的是阻塞式系统调用,协程无法接管。
必须改用 Swoole 提供的协程版客户端:
-
SwooleCoroutineHttpClient替代curl -
SwooleCoroutineMySQL替代mysqli -
SwooleCoroutineredis替代phpredis -
SwooleCoroutineHTTPServer本身是协程服务器,但调用外部服务时仍需用协程客户端
用 SwooleCoroutineHttpClient 发起 HTTP 请求
这是最常见场景:协程内调用 rest api、微服务接口等。注意它不自动处理重定向、cookie 持久化需手动管理,且默认超时很短(1秒)。
典型写法:
立即学习“PHP免费学习笔记(深入)”;
set(['timeout' => 10.0]); $client->setHeaders(['User-Agent' => 'co-client/1.0']); $client->post('/v1/users', ['name' => 'foo']); if ($client->statusCode === 200) { $data = json_decode($client->body, true); var_dump($data); } else { echo "HTTP {$client->statusCode}n"; }
});
关键点:
- HTTPS 必须传
true第三个参数,否则握手失败 -
set()中的timeout单位是秒,建议显式设为 5–30,避免默认 1 秒误判超时 - 不要复用
$client实例跨协程 —— 它不是线程安全的,每个协程应新建
协程 MySQL 查询要关掉 mysqlnd 的缓存
即使用了 SwooleCoroutineMySQL,如果 PHP 启用了 mysqlnd 的查询缓存(如 mysqlnd_qc 扩展),会导致协程间数据污染或连接复用异常。
检查并禁用方式:
- 确认
php.ini中未启用extension=mysqlnd_qc.so - 运行时可加
ini_set('mysqlnd_qc.enable_qc', '0'); - 连接后务必调用
$mysql->setDefer()配合recv()实现真正的异步等待(非必须,但高并发下推荐)
示例中若漏掉 setDefer(),query() 仍是同步阻塞行为 —— 表面用了协程类,实际没发挥协程优势。
别在协程里混用 sleep() 或 usleep()
这些函数会让当前协程彻底挂起,但 Swoole 不会自动唤醒,等同于阻塞调度器。应该用 SwooleCoroutine::sleep()(单位秒)或 SwooleCoroutine::usleep()(单位微秒)。
错误写法:sleep(1) → 整个协程调度卡死 1 秒
正确写法:SwooleCoroutine::sleep(1) → 当前协程让出控制权,其他协程继续跑
同样,while (true) { /* busy loop */ } 在协程里也是灾难,会饿死其他协程 —— 必须用 co::sleep() 或 co::wait() 主动让渡。
真正难的不是写对第一个协程请求,而是确保所有 I/O 调用都走协程封装、所有延时都用协程版、所有资源(如 DB 连接池)都按协程生命周期管理。漏掉任意一个点,就可能把整组协程拖回同步泥潭。