Guzzle7升级需改异步回调：then()第二个参数不再捕获异常，须用otherwise()；wait()不自动运行事件循环，需手动Utils::queue()->run()；HandlerStack必须显式包装；Pool并发参数移至send()方法。
PHP 7.4 环境下从 Guzzle6 升级到 Guzzle7，异步请求的回调写法必须改——then() 的第二个参数（拒绝回调）不再自动捕获异常，且 wait() 行为更严格；不改会静默失败或抛出未捕获异常。
guzzlehttp/guzzle 6 → 7 的 then() 回调签名变化
Guzzle6 中 then($onFulfilled, $onRejected) 的 $onRejected 会接收所有异常（包括 RequestException、ConnectException、甚至 PHP 错误），Guzzle7 则只传入被显式 reject() 的值，未被捕获的异常会直接冒泡到事件循环或 wait() 调用点。
- 旧写法（Guzzle6 安全，Guzzle7 可能漏错）：
$promise->then(fn($r) => ..., fn($e) => echo $e->getMessage()); - 新写法（Guzzle7 必须）：用
otherwise()或在then()内部手动 try/catch，推荐统一用otherwise() -
otherwise()是 Guzzle7 新增的语法糖，等价于then(null, $onRejected)，但语义更清晰，且确保异常不会逃逸
wait() 不再隐式运行事件循环，需显式处理 Promise 队列
Guzzle6 的 $promise->wait() 会自动触发底层 Utils::queue()->run()；Guzzle7 移除了该副作用，只同步等待当前 promise 完成，若队列中还有待执行的回调（比如嵌套 then()），它们不会被执行，导致逻辑卡住或输出丢失。
- 错误现象：回调函数没打印、
echo不生效、wait()返回了值但后续链式操作没执行 - 正确做法：在
wait()前或后手动调用Utils::queue()->run()，尤其当代码含多个 promise 或自定义Promise实例时 - 注意：Guzzle7 默认仍注册了 shutdown handler，所以脚本结束时队列会清空——但这不能替代主动
run()，因为中间状态不可控
HttpClient 构造和 HandlerStack 兼容性细节
Guzzle7 强制要求 HandlerStack 作为 handler 入口，Guzzle6 允许直接传 CurlHandler 或 StreamHandler。升级后若沿用旧初始化方式，requestAsync() 可能返回非 PromiseInterface 实例，或抛出 InvalidArgumentException。
立即学习“PHP免费学习笔记（深入）”；
- 旧写法（Guzzle6）：
new Client(['handler' => new CurlMultiHandler()]) - 新写法（Guzzle7）：
new Client(['handler' => HandlerStack::create(new CurlMultiHandler())]) - 如果没显式指定 handler，Guzzle7 会自动创建带默认中间件的
HandlerStack，但自定义 handler 场景下必须包装 - 验证是否生效：打印
get_class($client->getConfig('handler'))，应为GuzzleHttp\HandlerStack
Pool 并发控制 API 微调，$concurrency 参数位置变更
使用 Pool 批量发起异步请求时，Guzzle7 把 $concurrency 从构造函数移到了 send() 方法的 options 数组里，旧代码会报 Too few arguments 错误。
- 旧写法（Guzzle6）：
new Pool($client, $requests, ['concurrency' => 5]) - 新写法（Guzzle7）：
new Pool($client, $requests)+$pool->send(['concurrency' => 5]) - 另外，Guzzle7 的
Pool默认不自动wait()，必须显式调用$pool->promise()->wait()或Utils::all($promises)->wait() - 常见坑：忘记
wait()导致脚本退出前 promise 未完成，HTTP 连接未释放
最易被忽略的是 otherwise() 替代 then() 第二个参数——很多人只改了 use 语句和版本号，却让异常处理逻辑彻底失效；加上 PHP 7.4 不支持 throw 表达式，otherwise() 内的错误处理必须写完整语句块。
