使用Coroutine\Local实现协程隔离,避免全局变量数据混乱,推荐通过Context传递上下文,共享状态则用Channel或Atomic保证安全。

在 Swoole 协程环境中,多个协程共享同一个进程的内存空间,但协程是并发执行的。直接使用 PHP 的全局变量(如 $GLOBALS、static 变量或 global 声明)会导致数据混乱,因为不同协程会互相覆盖值。要安全地使用“全局”状态,必须采用协程隔离的方案。
使用 Coroutine\Local 存储协程本地变量
推荐使用 Swoole\Coroutine\Local 类,它为每个协程提供独立的变量副本,类似线程局部存储(TLS)。
示例:
class Context {
public $userId;
public $traceId;
}
$context = new \Swoole\Coroutine\Local();
// 在协程中设置
go(function () use ($context) {
$context->data = new Context();
$context->data->userId = 123;
echo "协程1: {$context->data->userId}\n";
});
go(function () use ($context) {
$context->data = new Context();
$context->data->userId = 456;
echo "协程2: {$context->data->userId}\n";
});
每个协程读写的是自己的副本,互不干扰。
避免使用普通全局变量和 static
以下做法是不安全的:
- 使用 global $var 或 $GLOBALS['var']
- 使用类的 static 属性存储状态
- 使用函数内的 static 变量保存上下文
这些在协程切换时可能被其他协程修改,导致逻辑错误或数据泄露。
使用 Context 传递上下文数据
对于请求级别的上下文(如用户ID、请求头),建议通过参数显式传递,或使用 Context 容器管理。
Swoole 提供了 Swoole\Context(v4.8+)用于安全地封装回调中的上下文:
use Swoole\Context;
$data = Context::get('key');
Context::put('key', 'value'); // 当前协程有效
// 在 defer 中也能正确访问上下文
Context::defer(function () {
echo Context::get('key'); // 输出 value
});
需要共享状态时使用 Channel 或 Atomic
如果多个协程需要共享数据(如计数器、缓存),应使用线程安全的机制:
- Swoole\Coroutine\Channel:用于协程间通信
- Swoole\Atomic:用于整数的原子操作
- 协程安全的容器类:自己封装加锁逻辑(如使用 chan 模拟互斥)
基本上就这些。关键是要区分“全局”是想做“每个协程独立”还是“多协程共享”。前者用 Coroutine\Local,后者用同步机制保护。不要依赖传统 PHP 的全局变量思维。










