php协程需依赖swoole，php 8.1+的fibers仅为底层原语，不支持自动io挂起；业务级高并发协程唯一可靠方案是swoole，其已协程化curl、mysql、redis等常用扩展，并默认启用。
协程不是 PHP 原生特性，得靠 Swoole
PHP 8.1+ 虽然加了 fibers，但它是底层调度原语，不带 IO 自动挂起、不内置协程化扩展，没法直接写 co::sleep() 或自动切换。真正在业务里跑高并发协程，目前唯一靠谱路径是 Swoole —— 它把 curl、mysql、redis、http 等常用操作全协程化了，且默认启用。
常见错误现象：Fatal error: Uncaught Swoole\Error: must be called in the coroutine，说明你在非协程环境（比如 cli 普通脚本或 Apache/FPM 下）调用了 Swoole\Coroutine 相关函数。
- 必须用
swoole_server、swoole_http_server或Swoole\Coroutine\run()启动协程上下文 - 别在 Laravel/ThinkPHP 的传统 FPM 请求里直接写
go(function () { ... })，会报错 -
Swoole\Coroutine\run()是最轻量的入口，适合 CLI 场景；Web 服务必须用Swoole\Http\Server
go() + defer() 是最常用的协程组合
go() 启动一个协程，defer() 在协程退出前执行清理逻辑，类似 Go 的 defer，但作用域仅限当前协程。它不是全局钩子，也不会跨协程生效。
使用场景：并发请求多个 HTTP 接口、批量查 Redis、发消息后统一记录日志。
Swoole\Coroutine\run(function () {
$urls = ['https://api.a.com', 'https://api.b.com', 'https://api.c.com'];
$results = [];
foreach ($urls as $url) {
go(function () use ($url, &$results) {
defer(function () use ($url) {
echo "done: {$url}\n";
});
$client = new Swoole\Coroutine\Http\Client('api.a.com', 443, true);
$client->set(['timeout' => 5]);
$client->get('/status');
$results[] = $client->body;
});
}
// 等所有协程结束
\Swoole\Coroutine::wait();
});
-
go()返回协程 ID，但一般不用存；别试图用kill()终止它——Swoole 不支持强制取消 -
defer()只在当前协程 exit 时触发，如果协程 panic 或被超时 kill（如max_exec_time），defer不一定执行 - 变量传入协程要用
use显式捕获，引用传参（&$results）才真正共享数据
协程 MySQL 和 Redis 必须用 Swoole 提供的客户端
你不能继续用 PDO 或 mysqli，它们是阻塞的，一调用就卡死整个协程调度器。Swoole 提供了 Swoole\Coroutine\MySQL 和 Swoole\Coroutine\Redis，底层自动 yield。
参数差异明显：Swoole\Coroutine\MySQL 不支持长连接复用（每次 new 都是新连接），但连接池得自己实现或用 co-pool 库；而 Redis 客户端支持 connect() 复用连接，但要注意并发读写同一实例时可能乱序。
- MySQL 查询返回数组，不是
PDOStatement；不支持预处理语法糖，得手拼 SQL 或用 ORM 封装层（如 Hyperf 的 Db） - Redis 的
set()默认不带过期时间，set($key, $val, $expire)才等价于SETEX，漏写第三参数是常见坑 - 所有协程客户端方法都返回布尔或结果，**没有异常抛出**；要用
$client->errCode和$client->errMsg判断失败
协程上下文隔离，$_SERVER/$_GET 这类超全局变量不可靠
协程间共享进程内存，但 Swoole 会为每个协程维护独立的上下文（context），包括 $_SERVER、$_GET、$_POST、甚至 ini_set() 设置。你在协程 A 里改了 date.timezone，协程 B 看不到。
容易踩的坑：有人在中间件里用 $_SERVER['REQUEST_URI'] 记录日志，结果发现日志里混了其他请求的 URI —— 因为没意识到这是协程安全的，但如果你在协程外（比如 onStart 回调）读它，就读到的是启动时的值，不是当前请求。
- HTTP 请求的原始数据，必须从
$request->server、$request->get等Swoole\Http\Request属性取 - 想存协程级变量？用
Swoole\Coroutine::getContext()或Co::getUid()做 key 存到全局数组里 -
error_reporting()、set_error_handler()在协程内设置，只影响当前协程，别指望它全局生效
协程的“轻量”背后是精细的上下文管理，不是所有 PHP 习惯都能平移。漏掉 context 隔离这点，调试时会发现变量像幽灵一样飘来飘去。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
