最近在开发一个处理用户提交数据的程序时，遇到了一个棘手的问题：用户输入的文本中包含各种非ASCII字符，例如中文、日文、特殊符号等等。这些字符导致程序在处理字符串时效率低下，甚至出现错误。为了解决这个问题，我尝试了多种方法，最终找到了voku/portable-ascii这个库。 Composer在线学习地址：学习地址
在现代web开发中，与外部服务（如restful api）交互几乎是家常便饭。然而，php的传统执行模式是同步的，这意味着当你的代码发起一个外部请求时，它会一直等待直到收到响应，才能继续执行后续代码。
想象一下，你需要从三个不同的第三方API获取数据来构建一个页面——如果每个请求都需要2秒，那么你的用户可能要等待6秒才能看到完整内容！这种漫长的等待不仅用户体验极差，还可能导致服务器资源浪费和超时。更糟糕的是，如果这些请求之间存在复杂的依赖关系，你的代码可能会陷入“回调地狱”，变得难以阅读和维护。
这种同步阻塞的问题，在需要高并发、低延迟的场景下，尤其令人头疼。我们渴望一种能够“并发”执行任务，同时又能优雅地处理结果和错误的方式。
救星登场：Composer 与 Guzzle Promises
幸运的是，PHP社区拥有一个强大的包管理工具——Composer。它不仅仅是下载依赖，更是连接你与无数优秀开源库的桥梁。通过Composer，我们可以轻松引入像 guzzlehttp/promises 这样的库，为PHP带来异步编程的能力。
guzzlehttp/promises 是一个健壮的 Promises/A+ 实现，它为PHP带来了“Promise”的概念。那么，什么是Promise呢？
立即学习“PHP免费学习笔记（深入）”；
简单来说，Promise 代表了一个异步操作的最终结果。这个结果可能在未来的某个时间点成功（fulfilled）并带有一个值，也可能失败（rejected）并带有一个原因。Promise 的核心思想是，你不需要立即知道结果，但你可以注册回调函数，在结果可用时执行相应的逻辑。
如何使用 Composer 引入 Guzzle Promises
首先，你需要确保你的项目中已经安装了Composer。如果还没有，可以通过上面的学习地址进行学习。
然后，在你的项目根目录执行以下命令，安装 guzzlehttp/promises：
<code class="bash">composer require guzzlehttp/promises</code>
这会将库及其依赖项下载到你的 vendor 目录，并自动生成 autoload.php 文件，方便你直接在代码中使用。
Guzzle Promises 如何让你的 API 调用“飞起来”
让我们通过一个简单的例子来理解 Guzzle Promises 的魔力。假设我们需要模拟三个耗时操作（比如三个API请求），并希望它们能并发执行，而不是串行等待。
1. 基本 Promise 概念：resolve, then, wait
一个 Promise 有三种状态：
- Pending (待定)：初始状态，既没有成功，也没有失败。
- Fulfilled (已成功)：操作成功完成。
- Rejected (已失败)：操作失败。
你可以通过 resolve() 方法让 Promise 成功，通过 reject() 方法让 Promise 失败。then() 方法用于注册当 Promise 成功或失败时要执行的回调函数。wait() 方法则会同步地等待 Promise 完成并返回其结果（或抛出异常）。
<code class="php"><?php
require 'vendor/autoload.php';
use GuzzleHttp\Promise\Promise;
// 创建一个Promise
$promise = new Promise();
// 注册成功回调
$promise->then(
function ($value) {
echo "Promise 成功了，值是: " . $value . "\n";
},
function ($reason) {
echo "Promise 失败了，原因是: " . $reason . "\n";
}
);
// 模拟一个异步操作，1秒后解决Promise
echo "开始模拟异步操作...\n";
// 实际应用中，这里可能是发起一个网络请求，然后在其回调中resolve/reject
// 这里我们用一个简单的延迟来模拟
$delay = 1;
// 在真实异步场景中，你不会在这里立即 resolve，而是等待异步任务完成
// 为了演示，我们先 resolve，然后通过 wait 立即获取
// $promise->resolve('异步任务完成！'); // 如果立即 resolve，wait 会立刻返回
// 为了演示 wait 的阻塞效果，我们给 Promise 构造函数一个 waitFn
$promiseWithWaitFn = new Promise(function () use (&$promiseWithWaitFn, $delay) {
// 模拟耗时操作
sleep($delay);
$promiseWithWaitFn->resolve('模拟异步任务完成！');
});
echo "等待 Promise 完成...\n";
$result = $promiseWithWaitFn->wait(); // 这一行会阻塞1秒
echo "Promise 等待结果: " . $result . "\n";
// 也可以在任何时候手动 resolve 或 reject
$anotherPromise = new Promise();
$anotherPromise->then(function($value){
echo "另一个 Promise 成功: " . $value . "\n";
});
$anotherPromise->resolve('手动解决');
$rejectedPromise = new Promise();
$rejectedPromise->then(null, function($reason){
echo "一个被拒绝的 Promise: " . $reason . "\n";
});
$rejectedPromise->reject('出错了！');
?></code>2. 实现并发：Promise\Utils::all()
现在，我们来解决多个API调用串行的问题。GuzzleHttp\Promise\Utils::all() 方法可以接收一个 Promise 数组，并返回一个新的 Promise。这个新的 Promise 会在所有输入 Promise 都成功后才成功，并返回一个包含所有结果的数组；只要有一个输入 Promise 失败，它就会立即失败。
<code class="php"><?php
require 'vendor/autoload.php';
use GuzzleHttp\Promise; // 注意这里使用了别名
use GuzzleHttp\Promise\Promise as GuzzlePromise; // 避免与 Promise 关键词冲突
function fetchDataFromApi(string $apiName, int $delaySeconds): GuzzlePromise
{
return new GuzzlePromise(function () use (&$promise, $apiName, $delaySeconds) {
// 模拟网络请求耗时
echo "开始从 {$apiName} 获取数据 (预计耗时 {$delaySeconds} 秒)...\n";
sleep($delaySeconds); // 实际中这里是 cURL 或 GuzzleHttp\Client 的异步请求
echo "从 {$apiName} 获取数据完成！\n";
$promise->resolve("来自 {$apiName} 的数据");
});
}
// 创建三个模拟的异步API请求
$promise1 = fetchDataFromApi('API A', 3);
$promise2 = fetchDataFromApi('API B', 1);
$promise3 = fetchDataFromApi('API C', 2);
echo "所有异步请求已发出，等待并发完成...\n";
// 使用 Promise\Utils::all() 等待所有 Promise 完成
$allPromises = Promise\Utils::all([
'api_a_data' => $promise1,
'api_b_data' => $promise2,
'api_c_data' => $promise3,
]);
try {
// wait() 会阻塞直到所有 Promise 完成
$results = $allPromises->wait();
echo "\n所有数据已获取：\n";
print_r($results);
// 此时，总耗时大约是耗时最长的那个 Promise 的时间（3秒），而不是所有之和（3+1+2=6秒）
echo "总耗时大致等于最长的请求时间。\n";
} catch (Exception $e) {
echo "有 Promise 失败了: " . $e->getMessage() . "\n";
}
?></code>运行上述代码，你会发现尽管有三个请求，但总的等待时间将接近最长的那个请求（3秒），而不是所有请求时间的总和。这就是并发的魔力！
Guzzle Promises 的优势
- 提升性能与用户体验： 最直接的优势就是并发执行任务，大大缩短了总响应时间，尤其是在需要频繁与外部服务交互的应用中。
-
告别“回调地狱”，代码更清晰： 通过链式调用
then()，你可以清晰地定义异步操作的流程，避免了多层嵌套回调带来的可读性问题。 -
统一的错误处理： Promise 提供了一种结构化的方式来捕获和处理异步操作中的错误，你可以使用
then(null, $onRejected)或otherwise()来集中处理失败情况。 -
灵活的同步/异步模式：
wait()方法允许你在需要时同步地等待异步结果，而通过集成事件循环（如 ReactPHP 的 EventLoop），则可以实现真正的非阻塞异步编程。 -
强大的组合能力：
Promise\Utils::all()、Promise\Utils::some()等方法让你能够轻松地组合和管理多个 Promise，实现复杂的并发逻辑。 - 可扩展性与互操作性： Guzzle Promises 遵循 Promises/A+ 规范，这意味着它可以与其他遵循相同规范的 Promise 库（如 ReactPHP 的 Promise）进行互操作。
总结
从传统的同步阻塞到高效的异步并发，guzzlehttp/promises 为 PHP 开发者打开了一扇新的大门。它通过优雅的 Promise 模式，让处理耗时操作变得前所未有的简单和高效。
Composer 作为 PHP 生态的基石，使得引入和管理这类强大工具变得轻而易举。当你下次再遇到因为外部API调用而导致页面加载缓慢、用户抱怨等待时间过长的问题时，不妨考虑一下 guzzlehttp/promises。它将帮助你优化程序的处理效率，让你的 PHP 应用真正“飞起来”！
