协程上下文是每个协程独立的运行时状态,不共享$_server、$globals或静态变量;错误使用全局/静态变量会导致数据串扰,应改用co::getuid()标识或context::set/get隔离存储。

协程上下文不是“全局变量”,而是隔离的执行环境
协程上下文(Coroutine Context)指每个协程独立拥有的运行时状态,包括栈空间、寄存器快照、局部变量、Co::getuid()唯一 ID、以及被 Hook 的 I/O 调用上下文。它不共享 $_SERVER、$GLOBALS 或静态属性——这些仍属进程级,一旦多协程并发写入就会互相污染。
常见错误现象:go(function () { $user = getUser(); $_SESSION['last_user'] = $user; }); go(function () { echo $_SESSION['last_user']; }); 输出不可预期,因为 $_SESSION 是超全局,未做协程隔离。
- 协程内修改
$_GET/$_POST不影响其他协程,但这是 PHP SAPI 层的副本,不是真正的上下文机制 - 真正受协程上下文保护的是 Swoole 内部状态:比如
Co::sleep()挂起时保存的 PC 指针、栈顶地址 - 你无法手动“获取”或“序列化”整个上下文,Swoole 在底层用
ucontext_t或setjmp/longjmp实现切换,对 PHP 层完全透明
Co::getContext() 不存在,别搜这个函数
很多人在文档里找不到 Co::getContext(),是因为它根本没暴露给 PHP 层。Swoole 的协程上下文是 C 层调度器管理的内部结构,PHP 只能通过有限接口感知其存在:
-
Co::getuid()返回当前协程整数 ID,可用于日志打标或调试追踪 -
Co::stats()查看当前协程数、总创建数等统计值,但不反映单个上下文内容 - 协程内调用
Co::sleep(1)后恢复,靠的就是上下文保存/恢复,但你不需要、也不能干预这个过程
试图封装“上下文类”来跨协程传参,本质是走错方向;正确做法是用参数 use() 显式传递,或用 Swoole\Coroutine\Channel 安全通信。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版,它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构,内置 TCP/HTTP/WebSocket 服务器,能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
为什么 static $cache 在协程里会出问题
静态变量属于类定义所在进程,不是协程私有。下面这段代码极容易踩坑:
go(function () {
static $counter = 0;
$counter++;
echo "A: {$counter}\n"; // 可能输出 1、2、3… 不确定
});
go(function () {
static $counter = 0;
$counter++;
echo "B: {$counter}\n";
});
原因:两个协程共享同一个 $counter 存储位置,PHP 解释器不会为每个协程复制 static 变量。这不是 bug,是设计使然——协程不是线程,没有内存隔离能力。
- 替代方案:用
Co::getuid()做键,维护一个SplFixedArray或WeakMap(PHP 8.0+)模拟协程局部存储 - 更推荐:彻底避免 static,把状态作为函数参数传入,或用
Context类(如 EasySwoole 提供的Context::set()) - 注意
WeakMap的 key 必须是对象,不能直接用 int UID,需包装成class UidRef { public $id; }
协程上下文和 HTTP 请求生命周期的关系
在 Swoole\Http\Server 中,每次 onRequest 回调都会自动创建一个新协程,这个协程的上下文天然绑定本次请求——但仅限于“执行期间”。关键点在于:
- 协程结束 ≠ 请求结束:如果你在回调里启动了
go()子协程,父协程返回后,子协程仍可继续运行(只要没被 kill) - 子协程无法访问父协程的局部变量,除非显式
use(),且该变量必须是值类型或可序列化对象 - 像
$request->header这种对象,在协程退出后可能已被释放,子协程中继续使用会触发Segmentation fault或空值
最容易被忽略的是:协程上下文只保证“执行流隔离”,不保证“数据生命周期安全”。你得自己判断哪些数据能跨协程持有,哪些必须立刻拷贝。










