SparkPost PHP客户端库异步promise.then()无法发送邮件问题

我之前也碰到过一模一样的问题！核心原因是命令行环境下ReactPHP的事件循环不会自动启动，而wait()和then()的工作机制有本质区别：

问题根源 #

• $promise->wait()：这个方法是同步阻塞的，它内部会自动启动ReactPHP的事件循环，一直等待异步请求完成后才会继续执行脚本，所以邮件能正常发送。
• $promise->then()：这个方法只是注册异步回调，不会阻塞脚本执行。在命令行中，脚本会直接执行到末尾然后退出，根本没给事件循环运行的机会，所以异步发送请求根本没被触发，自然发不出邮件。

解决方案：手动启动事件循环 #

要让then()的异步逻辑生效，你需要在脚本末尾手动启动ReactPHP的事件循环，确保异步任务有机会执行。以下是完整的可运行示例：

require 'vendor/autoload.php';

use SparkPost\SparkPost;
use SparkPost\HttpClientAsync;
use GuzzleHttp\Client as GuzzleClient;
use React\EventLoop\Factory;

// 初始化SparkPost异步客户端
$sparkpost = new SparkPost(
    new HttpClientAsync(new GuzzleClient(), ['async' => true]),
    ['key' => '你的SparkPost API密钥']
);

// 构建邮件传输参数
$transmissionData = [
    'content' => [
        'from' => ['email' => 'sender@your-domain.com', 'name' => '测试发件人'],
        'subject' => '[异步测试] 这是一封通过Promise发送的邮件',
        'html' => '<h3>Hello!</h3><p>这是SparkPost异步发送的测试邮件</p>'
    ],
    'recipients' => [
        ['address' => ['email' => 'recipient@example.com']]
    ]
];

// 发送邮件获取Promise对象
$sendPromise = $sparkpost->transmissions->send($transmissionData);

// 注册成功/失败回调
$sendPromise->then(
    function ($response) {
        echo "✅ 邮件发送成功！\n";
        echo "响应数据：\n" . print_r($response, true);
    },
    function ($exception) {
        echo "❌ 邮件发送失败：" . $exception->getMessage() . "\n";
    }
);

// 关键步骤：启动ReactPHP事件循环，让异步任务执行
$eventLoop = Factory::create();
$eventLoop->run();

注意事项 #

1. 不要遗漏事件循环启动：脚本必须调用$eventLoop->run()，否则所有异步任务都会被忽略，脚本直接退出。
2. 循环实例复用：如果你的脚本中已经有其他ReactPHP异步逻辑（比如多个邮件发送请求），请复用同一个事件循环实例，不要重复创建。
3. 脚本退出时机：run()方法会阻塞脚本，直到事件循环中的所有异步任务完成才会退出，所以不用担心脚本提前结束。

内容的提问来源于stack exchange，提问作者Banditvibe