如何在 Guzzle 异步 Promise 中正确更新对象属性-php教程

本文详解在 guzzle 的 promise 链中安全访问和修改类成员变量（如 `$this->metaresults`）的关键要点，重点解决因作用域丢失导致的变量未更新问题，并提供可直接运行的修复方案。

在使用 Guzzle 的异步 HTTP 客户端（如 getAsync()）配合 Promise 链处理多个 URL 时，一个常见误区是：试图在 then() 回调中通过 $this 或引用外部变量来更新当前对象的属性（例如 $this->metaResults[$url]），却意外发现赋值未生效。根本原因在于——Promise 回调函数运行在独立作用域中，$this 不会自动绑定到原始对象实例，且未显式传入的变量无法被访问。

✅ 正确做法：显式传递 &$that 并避免误用 $this

你需要在每个 then() 回调中 显式 use 捕获 $that（即 $this 的引用副本），并移除回调内对 $this 的调用（它在此处无效）。同时注意：$url 是循环变量，必须按值（use ($url, $that)）而非引用（use (&$url, …)）传入，否则所有回调可能共享最后一次迭代的 $url 值（PHP 闭包变量绑定机制决定）。

以下是修正后的完整代码段：

foreach ($urls as $url) {
    // 初始化对象属性（注意：此处 $url 是当前迭代值，无需索引 $i）
    $this->facebook[$url]   = 0;
    $this->googlePlus[$url] = 0;
    $this->pinterest[$url] = 0;
    $this->twitter[$url]    = 0;
    $this->metaResults[$url] = [
        'url'         => false,
        'title'       => false,
        'desc'        => false,
        'h1'          => false,
        'word_count'  => 0,
        'keyword_count' => 0
    ];

    $that = $this; // 创建对当前对象的引用别名

    $promise = $client->getAsync($url)
        ->then(function (Psr\Http\Message\ResponseInterface $response) {
            return $response->getBody()->getContents();
        })
        ->then(function (string $html) use ($url, $that) {
            // ✅ 正确：使用 $that 访问对象属性，$url 是当前 URL 的副本
            $that->metaResults[$url] = $that->parseMeta($html);
            // ❌ 错误：$this 在此不可用；$url 若为引用则可能错乱
        });

    $promises['meta'][$url] = $promise;
}

// 等待所有 Promise 完成（注意变量名拼写：$promises 而非 $promeses）
$responses = \GuzzleHttp\Promise\Utils::settle($promises)->wait();

⚠️ 关键注意事项

• $that 必须是 $this 的引用：$that = $this; 是浅拷贝对象引用，确保后续修改反映到原对象。
• 禁止在 then() 中使用 $this：Promise 回调由 Guzzle 内部调度执行，其上下文不包含原始类实例。
• $url 应按值传入 use ($url, $that)：若用 &$url，闭包会绑定到循环变量本身，而循环结束后 $url 值已固定，导致所有回调操作同一 URL。
• 确保 parseMeta() 是公开/受保护方法且可被 $that 调用：若为私有方法，请确认调用合法性（通常无问题，因 $that 即本类实例）。
• 错误处理建议：生产环境应添加 otherwise() 处理网络失败，避免 metaResults 对应项保持初始状态：

  ->otherwise(function (\Exception $e) use ($url, $that) {
      $that->metaResults[$url]['error'] = $e->getMessage();
  });

通过以上调整，Promise 完成后 $this->metaResults 将准确更新各 URL 对应的解析结果，彻底解决“赋值不生效”的问题。