在现代Web应用开发中，我们经常需要与各种外部服务打交道：调用第三方API获取数据、发送邮件、处理图片、执行复杂的数据库查询……这些操作有一个共同的特点：它们是“I/O密集型”的，意味着程序大部分时间都在等待数据传输完成，而不是进行CPU计算。
想象一下，你的电商网站需要在用户下单后：
- 调用支付网关API处理支付。
- 调用库存服务扣减库存。
- 调用物流服务创建订单。
- 发送订单确认邮件。
如果这些操作是同步执行的，那么用户必须等待所有步骤逐一完成，才能看到“订单成功”的页面。如果其中一个服务响应缓慢，整个流程就会被卡住，用户体验直线下降。传统的PHP脚本默认是同步执行的，这意味着一个请求必须完全处理完毕，下一个请求才能开始。为了提高效率，我们可能会尝试使用curl_multi等低级函数来并行处理HTTP请求，但这往往导致代码复杂、难以维护，甚至陷入“回调地狱”。
拥抱Composer，引入Guzzle Promises
面对这样的困境，我们需要一种更优雅、更现代的方式来管理PHP中的异步操作。幸运的是，开源社区为我们提供了强大的解决方案——guzzlehttp/promises。它是一个基于Promises/A+规范的PHP库，能帮助我们以更结构化、可读性更高的方式处理异步任务。
立即学习“PHP免费学习笔记（深入）”；
使用Composer安装guzzlehttp/promises非常简单：
composer require guzzlehttp/promises
这条命令会将库及其所有依赖项安装到你的项目中，让你即刻拥有处理异步操作的能力。
Guzzle Promises：异步操作的魔法
那么，guzzlehttp/promises是如何解决我们问题的呢？核心概念在于“Promise”（承诺）。
什么是Promise？ 一个Promise代表了一个异步操作的最终结果。它是一个占位符，可能在未来某个时间点被“兑现”（fulfilled，即操作成功并返回一个值）或被“拒绝”（rejected，即操作失败并返回一个错误原因）。
核心用法：then()方法
与Promise交互的主要方式是通过其then()方法。你可以向then()方法注册两个回调函数：一个用于处理操作成功时的值（$onFulfilled），另一个用于处理操作失败时的原因（$onRejected）。
use GuzzleHttp\Promise\Promise;
$promise = new Promise();
$promise->then(
// $onFulfilled：操作成功时执行
function ($value) {
echo 'Promise 已兑现，值为: ' . $value . PHP_EOL;
},
// $onRejected：操作失败时执行
function ($reason) {
echo 'Promise 已拒绝，原因: ' . $reason . PHP_EOL;
}
);
// 模拟异步操作完成，兑现Promise
$promise->resolve('订单处理成功！'); // 输出：Promise 已兑现，值为: 订单处理成功！
// 如果操作失败
// $promise->reject('支付失败，请重试。'); // 输出：Promise 已拒绝，原因: 支付失败，请重试。链式调用与Promise转发
Promise最强大的特性之一是链式调用。每个then()方法都会返回一个新的Promise，允许你将一系列异步操作串联起来，形成一个清晰的流程。上一个Promise的返回值会作为参数传递给下一个then()的回调函数。
更厉害的是，如果你在then()回调中返回另一个Promise，那么整个链条会暂停，直到你返回的那个“内部”Promise解决后，其结果才会传递给后续的then()。这极大地简化了复杂的异步逻辑。
use GuzzleHttp\Promise\Promise;
$promise = new Promise();
$nextPromise = new Promise();
$promise
->then(function ($value) use ($nextPromise) {
echo "第一步：接收到值 '" . $value . "'" . PHP_EOL;
// 返回另一个Promise，后续链条将等待它解决
return $nextPromise;
})
->then(function ($value) {
echo "第二步：接收到值 '" . $value . "'" . PHP_EOL;
});
// 触发第一个回调
$promise->resolve('开始任务'); // 输出：第一步：接收到值 '开始任务'
// 此时，第二个 then 还没有执行，因为它在等待 $nextPromise 解决
// 触发第二个回调
$nextPromise->resolve('中间步骤完成'); // 输出：第二步：接收到值 '中间步骤完成'错误处理：reject()与拒绝转发
异步操作中，错误处理同样重要。当Promise被拒绝时，$onRejected回调会被调用，并接收到拒绝的原因。如果在$onRejected回调中抛出异常，或者返回一个RejectedPromise，那么这个拒绝会沿着Promise链条向下传递，直到被某个$onRejected回调捕获。
use GuzzleHttp\Promise\Promise;
use GuzzleHttp\Promise\RejectedPromise;
$promise = new Promise();
$promise
->then(null, function ($reason) {
echo "捕获到错误1: " . $reason . PHP_EOL;
// 抛出异常，错误会继续向下传递
throw new \Exception("处理错误时又出错了: " . $reason);
})
->then(null, function ($reason) {
echo "捕获到错误2: " . $reason->getMessage() . PHP_EOL;
// 返回一个正常值，后续链条会转为成功状态
return "错误已处理并恢复";
})
->then(function ($value) {
echo "链条恢复正常: " . $value . PHP_EOL;
});
$promise->reject('原始错误：数据库连接失败');
// 输出：
// 捕获到错误1: 原始错误：数据库连接失败
// 捕获到错误2: 处理错误时又出错了: 原始错误：数据库连接失败
// 链条恢复正常: 错误已处理并恢复同步等待：wait()方法
尽管Promise旨在处理异步，但在某些场景下，你可能需要在某个时刻同步地获取异步操作的结果。wait()方法就是为此而生。它会阻塞当前进程，直到Promise被兑现或拒绝，然后返回其值或抛出异常。
use GuzzleHttp\Promise\Promise;
$promise = new Promise(function () use (&$promise) {
// 模拟一个耗时操作后解决Promise
sleep(1);
$promise->resolve('异步操作完成！');
});
echo "等待异步操作..." . PHP_EOL;
$result = $promise->wait(); // 此时会阻塞1秒
echo "结果: " . $result . PHP_EOL; // 输出：结果: 异步操作完成！
// 如果Promise被拒绝，wait()会抛出异常
$rejectedPromise = new Promise();
$rejectedPromise->reject('操作失败！');
try {
$rejectedPromise->wait();
} catch (\GuzzleHttp\Promise\RejectionException $e) {
echo "捕获到拒绝异常: " . $e->getMessage() . PHP_EOL;
}wait(false)可以强制解决Promise但不解包其状态，即不抛出异常，也不返回最终值，仅确保Promise已完成。
取消机制：cancel()
如果一个异步操作不再需要，你可以尝试调用Promise的cancel()方法来取消它。这对于节省资源或响应用户操作（如取消上传）非常有用。
Guzzle Promises带来的变革与实践
guzzlehttp/promises不仅仅是一个库，它更是一种编程范式，为PHP带来了显著的优势：
- 性能提升： 通过允许并发执行多个I/O操作，显著缩短了应用的响应时间，提升了用户体验。
- 代码整洁： 告别了深层嵌套的回调函数，以更线性和声明式的方式组织异步逻辑，大大提高了代码的可读性和可维护性。
- 健壮性： 统一的错误处理机制使得异步操作中的错误捕获和传递变得更加简单可靠。
-
“无限”链式调用：
guzzlehttp/promises的迭代处理机制确保了即使进行非常长的Promise链式调用，也不会导致堆栈溢出。 -
与Guzzle HTTP客户端无缝集成：
guzzlehttp/promises是Guzzle HTTP客户端的核心组件之一。当你使用Guzzle发送异步HTTP请求时，它返回的就是一个Promise对象，你可以直接对其进行链式操作和结果处理。这使得并发HTTP请求变得异常简单和高效。
在实际应用中，你可以利用guzzlehttp/promises来：
- 并行调用多个微服务或第三方API，聚合数据。
- 优化批量数据处理任务，如并行上传文件、转换图片。
- 在后台执行耗时任务，同时不阻塞用户界面响应。
- 构建响应式、高吞吐量的PHP应用。
结语
guzzlehttp/promises为PHP开发者提供了一把处理异步操作的利器。它将复杂的并发编程抽象为简洁、易懂的Promise模式，帮助我们编写出更高性能、更易维护的代码。如果你还在为PHP应用中的I/O瓶颈而烦恼，那么现在就是时候拥抱Guzzle Promises，让你的PHP应用焕发新的生机了！
