异步代码测试：一个让人头疼的挑战
想象一下，你正在构建一个高性能的 PHP 应用，其中大量使用了事件循环或 Fibers 来处理异步操作，比如一个需要与多个外部 API 并行交互的微服务，或者一个需要处理大量并发请求的实时推送服务。当你完成代码编写，满怀信心地准备测试时，却发现传统 PHPUnit 的同步测试模式在这里寸步难行。
异步代码的特性决定了它的执行流程是非线性的：回调函数会在未来某个时刻触发，Promise 会在后台解析，网络请求的响应时间也不确定。在这种环境下，你如何确保一个 Promise 最终会以你期望的值解决？如何保证你的事件循环在测试结束前已经处理了所有挂起的任务？更糟糕的是，如果某个异步操作永远没有完成，你的测试就会无限期地挂起，导致 CI/CD 流程卡死。
我曾无数次被这些问题困扰。我的测试套件时而通过，时而失败，结果完全取决于当时的网络延迟或服务器负载。调试异步流更是噩梦，你必须在同步的测试环境中努力追踪那些异步发生的事件。我甚至被迫在测试中加入 sleep() 调用——这在异步测试中是一个巨大的反模式，它不仅拖慢了测试速度，还无法真正解决异步问题。我感觉自己一直在与异步编程的本质作斗争，测试工作变得异常痛苦。
救星登场：wyrihaximus/async-test-utilities
正当我快要对异步测试感到绝望时，我发现了 wyrihaximus/async-test-utilities 这个 Composer 包。它简直是为异步 PHP 开发者量身定制的救星！这个库提供了一个专门的 TestCase 类，能够与 PHPUnit 无缝集成，将异步代码的测试从一场噩梦转变为一种流畅、可靠的体验。
立即学习“PHP免费学习笔记（深入）”；
轻松安装
与所有优秀的 Composer 包一样，安装 wyrihaximus/async-test-utilities 简单快捷：
composer require wyrihaximus/async-test-utilities
如何工作：解锁可靠的异步测试
wyrihaximus/async-test-utilities 的核心魔力在于其 WyriHaximus\AsyncTestUtilities\AsyncTestCase 类。通过让你的测试类继承它而不是 PHPUnit 默认的 TestCase，你将获得以下强大的优势：
测试运行在 Fiber 中：每个测试方法都会自动在其独立的 PHP Fiber 中执行。这是解决异步测试难题的基石。这意味着你可以在测试中直接使用
await()，就像在你的应用代码中一样，从而编写出看起来像同步代码、但内部能够平滑处理异步操作的测试。告别复杂的嵌套回调和测试中手动管理事件循环的麻烦！-
智能超时管理：异步操作有时可能会意外挂起。
AsyncTestCase默认给每个测试设置了 30 秒的超时时间。更重要的是，它提供了灵活的#[TimeOut]属性。你可以在类级别应用它来设置一个通用超时，也可以在方法级别覆盖它，为特定测试设置更长或更短的时间。这能有效防止测试无限期地阻塞你的 CI/CD 流程。use WyriHaximus\AsyncTestUtilities\TimeOut; #[TimeOut(0.3)] // 类级别超时 0.3 秒 final class MyAsyncTest extends AsyncTestCase { #[TimeOut(1)] // 方法级别超时 1 秒，将覆盖类级别设置 public function testSomethingAsync(): void { // ... 你的异步代码 ... } } -
异步断言辅助工具：你如何断言一个异步回调函数是否被调用了，以及被调用了多少次？
AsyncTestCase提供了方便的方法，如expectCallableExactly($count)和expectCallableOnce()。它们会生成可调用的 Mock 对象，你可以将其传递给你的异步函数，测试运行器会自动验证它们的调用次数。use React\EventLoop\Loop; public function testExpectCallableExactly(): void { $callable = $this->expectCallableExactly(3); // 期望这个可调用对象被调用 3 次 Loop::futureTick($callable); // 模拟异步调用 Loop::futureTick($callable); Loop::futureTick($callable); } public function testExpectCallableOnce(): void { Loop::futureTick($this->expectCallableOnce()); // 期望这个可调用对象被调用 1 次 } 随机测试资源：对于涉及文件系统交互或需要唯一命名的测试，
AsyncTestCase也提供了一些实用工具，用于生成随机命名空间和目录，有助于隔离测试并防止副作用。
实战示例：让异步测试清晰可见
让我们来看一个来自库文档的实际例子，它演示了如何测试一个涉及事件循环和延迟的异步操作：
<?php
declare(strict_types=1);
namespace WyriHaximus\Tests\AsyncTestUtilities;
use React\EventLoop\Loop;
use WyriHaximus\AsyncTestUtilities\AsyncTestCase;
use WyriHaximus\AsyncTestUtilities\TimeOut;
use function React\Async\async;
use function React\Async\await;
use function React\Promise\Timer\sleep;
#[TimeOut(0.3)] // 为整个测试类设置一个严格的超时
final class AsyncTestCaseTest extends AsyncTestCase
{
#[TimeOut(1)] // 为此特定测试方法设置 1 秒的超时，覆盖类级别设置
public function testAllTestsAreRanInAFiber(): void
{
self::expectOutputString('ab'); // 期望输出字符串为 'ab'
// 调度一个异步任务，将在未来某个时刻执行
Loop::futureTick(async(static function (): void {
echo 'a'; // 这将异步执行
}));
// 暂停当前 Fiber 的执行 1 秒，允许事件循环运行并处理 'a' 的输出
await(sleep(1));
echo 'b'; // 这将在 sleep 结束后打印
}
}在这个例子中，testAllTestsAreRanInAFiber 方法展示了几个关键点：
- 它被包裹在一个 Fiber 中，允许
await(sleep(1))暂停当前测试的执行，而不会阻塞整个测试运行器。 -
Loop::futureTick调度了一个异步任务，打印字符 'a'。 -
await(sleep(1))确保了事件循环有机会运行并执行futureTick回调，然后再打印字符 'b'。 -
#[TimeOut(1)]确保即使sleep(1)出现问题或耗时过长，测试最终也会因超时而失败，而不是无限期挂起。
总结：告别异步测试的烦恼，迎接高效可靠
wyrihaximus/async-test-utilities 彻底改变了我测试异步 PHP 代码的方式。它的核心优势在于：
- 可靠性大幅提升：通过在 Fiber 中运行测试并提供精确的超时控制，它消除了异步代码测试中常见的竞态条件和不稳定性，让你的测试套件变得更加健壮，测试结果更值得信赖。
-
代码可读性显著增强：你可以用更接近同步代码的直观风格来编写异步测试，使用
await让逻辑流清晰可见，大大提高了测试代码的可读性和可维护性。 -
开发效率显著提高：告别了繁琐的事件循环手动管理和
sleep()调试，你可以将更多精力投入到业务逻辑的测试上，从而加快开发速度。 - 无缝集成：作为 PHPUnit 的扩展，它能轻松融入现有的测试流程，学习成本低，几乎无需改变你现有的测试习惯。
如果你正在使用 ReactPHP、AmpPHP 或 PHP 8.1+ 的 Fibers 进行异步编程，并且为异步测试的复杂性所困扰，那么 wyrihaximus/async-test-utilities 绝对是你工具箱中不可或缺的一员。它将帮助你构建一个更稳定、更易于维护的异步应用，让你的测试工作从痛苦变为享受。
