可以通过一下地址学习
composer
：
学习地址
告别漫长等待：PHP 异步编程的救星 GuzzleHttp/Promises
你是否遇到过这样的场景：你的php应用需要从多个外部服务获取数据，或者需要同时处理几项独立的耗时任务？传统的做法是逐个发起请求，一个接一个地等待响应。想象一下，如果每个请求都需要几秒钟，那么整个过程可能需要十几秒甚至更久，用户只能对着一个空白页面或加载动画干瞪眼。这不仅极大损害了用户体验，也浪费了宝贵的服务器资源。
这就是典型的“阻塞式I/O”问题。PHP在执行到这些操作时，会暂停当前脚本的执行，直到操作完成并返回结果。在追求高性能和高并发的今天，这种模式显然已经无法满足需求。我们渴望一种方式，能够让PHP在等待一个耗时操作完成的同时，继续处理其他任务，或者同时发起多个耗时操作，待它们各自完成后再统一处理结果。
Composer：你的项目依赖管家
要解决上述问题，我们需要引入专业的异步编程库。而引入这些库最简单、最优雅的方式，莫过于使用
Composer
。Composer 是 PHP 的一个依赖管理工具，它允许你声明项目所依赖的库，并为你安装、更新和管理它们。它就像一个智能的“搬运工”，能把你需要的所有“工具”自动搬到你的项目里，让你专注于业务逻辑，而不是繁琐的依赖管理。
GuzzleHttp/Promises：PHP 异步编程的利器
当我们谈论PHP中的异步操作，尤其是涉及HTTP请求时，GuzzleHttp 往往是首选。而
则是 Guzzle 家族中专门用于处理异步操作“未来结果”的强大组件。它提供了一个符合 Promises/A+ 规范的实现，让你能够以一种结构化、非阻塞的方式管理异步任务的最终结果。
那么，什么是 Promise（承诺）呢？
简单来说，一个 Promise 代表了一个异步操作的“最终结果”。这个结果可能已经成功（ fulfilled），也可能失败（ rejected），或者还在进行中（ pending）。你不需要立即知道结果，但你可以“承诺”在结果可用时，或者操作失败时，执行特定的回调函数。
库的核心思想就是让你能够：
立即学习
“
PHP免费学习笔记（深入）
”；
发起一个异步操作
（例如，一个网络请求，尽管这个库本身不发起请求，它管理的是其他组件发起的异步操作所返回的 Promise）。
立即获得一个 Promise 对象
，而不是等待结果。
通过方法注册回调函数
，在 Promise 成功或失败时被调用。
将多个异步操作串联起来
，形成一个清晰的流程。
如何使用 GuzzleHttp/Promises 解决问题？
首先，使用 Composer 安装
：
安装完成后，你就可以在项目中使用它了。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
让我们通过一个简单的例子来理解它的工作原理。假设我们有两个耗时的“任务”，我们希望它们能“同时”进行，而不是一个接一个。
代码解释：
构造函数:
我们创建了两个
对象
和
。它们的构造函数中包含了一个匿名函数，这个函数会在
被“等待”时执行。在真实异步场景中，这个匿名函数通常用于启动一个非阻塞的I/O操作（例如，通过 Guzzle HTTP 客户端发起一个异步请求），并在操作完成后调用
或
。
模拟耗时:
为了演示阻塞，我们在这里使用了
。但在实际的异步框架（如基于事件循环的 ReactPHP 或 Amp）中，这些操作会是非阻塞的，即
不会暂停整个脚本，而是将控制权交还给事件循环，待时间到后再继续处理。
:
这是
中一个非常实用的工具函数。它接收一个 Promise 数组，并返回一个新的 Promise。只有当数组中的所有 Promise 都成功完成时，这个新的 Promise 才会成功完成，并将其所有结果作为一个数组返回。如果其中任何一个 Promise 失败，则整个
Promise 也会失败。
:
这是关键一步。
方法会强制当前 Promise 完成。在我们的例子中，它会等待
和
都完成后，才继续执行后续代码。虽然
看起来是阻塞的，但它阻塞的是所有并发操作的
完成
，而不是单个操作的
启动
。因此，总耗时是其中最长那个操作的时间，而不是所有操作时间之和（在这个例子中是2秒，而不是2+1=3秒）。
运行结果（简化）：
你会发现，尽管两个任务分别耗时2秒和1秒，但总的执行时间大约是2秒，而不是3秒。这就是异步编程带来的效率提升！
GuzzleHttp/Promises 的核心优势
非阻塞式编程模型:
允许你在等待耗时操作完成的同时，执行其他任务，极大提升应用程序的响应速度和并发能力。
清晰的异步流程控制:
通过
方法，你可以清晰地定义异步操作成功或失败后的处理逻辑，以及如何将多个异步操作串联起来。
迭代式链式调用:
库的内部实现确保了 Promise 链的迭代式处理，这意味着你可以进行“无限”的
链式调用而不会导致堆栈溢出，这对于复杂的异步工作流非常重要。
强大的错误处理:
的第二个参数用于处理拒绝（失败）的情况，使得错误处理更加集中和可控。
同步等待机制 ():
尽管核心是异步，但
方法提供了在必要时强制同步获取结果的能力，方便与现有同步代码集成。
互操作性:
遵循 Promises/A+ 规范，这意味着它可以与其他遵循相同规范的 Promise 库（如 ReactPHP Promises）无缝协作。
与事件循环集成:
通过
，可以方便地将 Promise 任务队列集成到外部事件循环中，实现真正的非阻塞 I/O。
总结与展望
库为 PHP 开发者提供了一种强大而优雅的方式来处理异步操作。结合 Composer 的便捷管理，它能让你轻松地将异步编程范式引入到项目中，从而解决传统阻塞式I/O带来的性能瓶颈。
通过使用 Promise，你的代码将变得更加模块化、可读性更强，并且能够更好地应对高并发场景。无论是需要同时调用多个微服务，还是处理大量数据流，
都能帮助你构建出响应迅速、性能卓越的 PHP 应用程序，显著提升用户体验和系统效率。
告别漫长等待，拥抱异步编程的强大力量吧！
guzzlehttp/promisesguzzlehttp/promisesthen()guzzlehttp/promisescomposer require guzzlehttp/promisesthen(function($value) use ($apiName, $startTime, $delaySeconds) {
$endTime = microtime(true);
$duration = round($endTime - $startTime, 2);
echo "[{$apiName}] 任务完成！耗时 {$duration} 秒。结果: {$value}\n";
});
// In a real async scenario, the actual work would happen in the background,
// and then $promise->resolve($result) would be called.
// For this demo, we'll just resolve it after a "simulated" delay.
// Let's make the resolution *immediate* for the promise object itself,
// and show how `Utils::all` manages multiple such promises.
// Simpler: Just create a promise and resolve it immediately for demonstration of chaining
// The *actual* async nature comes from *how* the promise is resolved (e.g., from an event loop).
// Let's create a promise that is resolved after a "simulated" delay (conceptually).
// For the demo, we'll just resolve it.
$promise->resolve("数据来自 {$apiName}");
return $promise; // Return the promise immediately
});
}
echo "程序开始执行...\n";
// 模拟同时发起两个 API 调用
// 注意：simulateAsyncApiCall 函数本身是同步的，但它返回的 Promise 对象代表了未来的结果。
// 在实际使用 GuzzleHttp 客户端时，getAsync() 等方法会真正发起非阻塞请求。
$promiseA = new Promise(function($resolve) {
echo "[API-A] 任务开始...\n";
sleep(2); // 模拟耗时操作
$resolve("数据来自 API-A");
});
$promiseB = new Promise(function($resolve) {
echo "[API-B] 任务开始...\n";
sleep(1); // 模拟耗时操作
$resolve("数据来自 API-B");
});
// 使用 GuzzleHttp\Promise\Utils::all() 等待所有 Promise 完成
// all() 方法会返回一个新的 Promise，当所有子 Promise 都完成时，这个新的 Promise 才会完成。
// 这时候，wait() 才会真正阻塞，但它阻塞的是所有并发操作的完成，而不是单个操作。
$combinedPromise = Utils::all([$promiseA, $promiseB]);
// 同步等待所有 Promise 完成并获取结果
// wait() 方法会强制 Promise 完成，并返回其最终值或抛出异常。
try {
$results = $combinedPromise->wait();
echo "所有任务完成！\n";
print_r($results);
} catch (Exception $e) {
echo "任务失败: " . $e->getMessage() . "\n";
}
echo "程序执行完毕。\n";PromisePromise$promiseA$promiseBPromise$resolve()$reject()sleep()sleep()sleep()Utils::all()guzzlehttp/promisesall$combinedPromise->wait()wait()$promiseA$promiseBwait()程序开始执行...
[API-A] 任务开始...
[API-B] 任务开始...
// 大约2秒后
所有任务完成！
Array
(
[0] => 数据来自 API-A
[1] => 数据来自 API-B
)
程序执行完毕。then()then()then()wait()wait()guzzlehttp/promisesGuzzleHttp\Promise\Utils::queue()->run()guzzlehttp/promisesguzzlehttp/promises