Swoole协程里怎么安全地使用全局变量-Swoole-PHP中文网

Swoole协程里怎么安全地使用全局变量

裘德小鎮的故事

发布： 2025-09-25 14:15:01

原创

351人浏览过

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

swoole协程里怎么安全地使用全局变量

在 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
});

登录后复制