PHP 怎么PHP 上下文传播

本文目录导读：

1. 场景一：在协程/异步编程（如 Swoole, Fiber）中
2. 场景二：在错误处理与异常中（隐藏上下文信息）
3. 场景三：在函数/方法调用链中传播（类似依赖注入）
4. 典型问题的快速诊断

在 PHP 中，“上下文传播”通常指的是在代码执行过程中（特别是在异步编程、协程或错误处理场景下），将某些隐式状态（如日志追踪ID、用户会话、数据库连接等）从一个执行单元传递到另一个执行单元的能力。

根据你提到的“上下文传播”，我推测你可能是在以下几个场景中遇到了问题：

在协程/异步编程（如 Swoole, Fiber）中

这是最典型的上下文传播场景,在传统同步PHP中，一个进程处理一个请求，所有变量都在全局或超全局变量（$_GET、$_SESSION）中，不需要传播。

但在协程中,多个协程共享一个进程，如果你使用全局变量或静态变量，它们会被所有协程修改，导致数据错乱（例如A用户的Session被B用户读取）。

解决方案：使用上下文存储容器 (Context Storage)

大多数现代PHP协程框架都提供了上下文管理机制。

1. Swoole (使用 Co::getContext() 或 Swoole\Coroutine\Context)

   use Swoole\Coroutine;
   go(function () {
       // 设置当前协程的上下文
       $context = Coroutine::getContext();
       $context['trace_id'] = uniqid();
       $context['user_id'] = 123;
       // 在子函数或更深层调用中获取
       $traceId = Coroutine::getContext()['trace_id'];
       echo "Trace ID: " . $traceId; // 输出：Trace ID: [唯一ID]
   });
   go(function () {
       // 另一个协程的上下文是独立的，不会互相影响
       $context = Coroutine::getContext();
       $context['trace_id'] = 'B-user';
       // ...
   });

2. 原生 PHP Fiber (手动管理) PHP 8.1+ 引入了 Fiber，但需要自己实现上下文存储。

   // 手动维护一个 Fiber ID 到数据的映射
   use Fiber;
   class ContextManager {
       private static array $storage = [];
       public static function set(string $key, mixed $value): void {
           $fiberId = spl_object_id(Fiber::getCurrent() ?? new stdClass());
           self::$storage[$fiberId][$key] = $value;
       }
       public static function get(string $key): mixed {
           $fiberId = spl_object_id(Fiber::getCurrent() ?? new stdClass());
           return self::$storage[$fiberId][$key] ?? null;
       }
       public static function destroy(): void {
           $fiberId = spl_object_id(Fiber::getCurrent() ?? new stdClass());
           unset(self::$storage[$fiberId]);
       }
   }
   $fiber = new Fiber(function () {
       ContextManager::set('trace_id', 'abc-123');
       ContextManager::set('user', ['id' => 1]);
       // 打印当前协程的 trace_id
       echo "Trace: " . ContextManager::get('trace_id');
       Fiber::suspend(); // 挂起协程
       echo "After resume: " . ContextManager::get('trace_id');
   });
   $fiber->start();
   echo "Main: " . ContextManager::get('trace_id'); // 主协程中没有设置，输出 null

在错误处理与异常中（隐藏上下文信息）

PHP 的 Error 和 Exception 默认不包含代码执行时的变量环境，当你需要将“当前调用上下文”传递给日志或错误处理器时，可以使用 debug_backtrace() 或手动附加上下文。

解决方案：自定义异常类并携带上下文

class ContextException extends \RuntimeException {
    private array $context;
    public function __construct(string $message, array $context = [], int $code = 0, ?\Throwable $previous = null) {
        parent::__construct($message, $code, $previous);
        $this->context = $context;
    }
    public function getContext(): array {
        return $this->context;
    }
}
// 使用
try {
    $userId = 456;
    $orderId = 'ORD-2024';
    if (/* 一些错误条件 */) {
        throw new ContextException(
            "订单处理失败",
            ['user_id' => $userId, 'order_id' => $orderId, 'file' => __FILE__, 'line' => __LINE__]
        );
    }
} catch (ContextException $e) {
    // 记录日志时包含上下文信息
    error_log("Error: " . $e->getMessage());
    error_log("Context: " . json_encode($e->getContext()));
}

在函数/方法调用链中传播（类似依赖注入）

如果你是指如何将一个对象或变量（如数据库连接、日志记录器）在不使用全局变量的情况下，从上层传递到下层函数。

解决方案：依赖注入 (DI) 或 闭包绑定上下文

class Logger {
    public function log(string $message): void {
        echo "[" . date('Y-m-d H:i:s') . "] " . $message . PHP_EOL;
    }
}
// 1. 显式传递（推荐）
function processOrder(Logger $logger, string $data): void {
    $logger->log("Processing order: " . $data);
    // 传递到更深层
    validateOrder($logger, $data);
}
function validateOrder(Logger $logger, string $data): void {
    $logger->log("Validating: " . $data);
}
// 2. 使用闭包绑定上下文
class Service {
    private \Closure $logFn;
    public function __construct(\Closure $logFn) {
        $this->logFn = $logFn;
    }
    public function doSomething(): void {
        $log = $this->logFn;
        $log("Action started");
        // ...
    }
}
// 使用闭包捕获上下文
$logger = new Logger();
$service = new Service(function (string $message) use ($logger) {
    $logger->log($message);
});
$service->doSomething();

典型问题的快速诊断

如果上面的场景都不符合你的问题，请提供更具体的代码示例或报错信息，我可以给你更精准的答案。