php 8.6需要同时保存业务记录和待发送事件时,可以将两次数据库写入放在同一个事务中:两者都成功才提交,任一失败则回滚。下面使用pdo sqlite演示outbox落库,只解决“业务数据与事件记录一起保存”,不直接调用外部消息服务,也不承诺消息只会投递一次。

PHP手册中的PDO::beginTransaction定义
先准备表结构,再进入业务事务
建表属于部署步骤,与业务事务分开。生产项目还应限制数据库文件权限并使用迁移管理结构;改用MySQL时要确认表引擎支持事务,不能把DDL隐式提交行为带进此事务。
<?php $pdo = new PDO('sqlite:'.__DIR__.'/orders.sqlite', null, null,
[PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$pdo->exec('CREATE TABLE IF NOT EXISTS order_records (
id TEXT PRIMARY KEY, amount_cents INTEGER NOT NULL)');
$pdo->exec("CREATE TABLE IF NOT EXISTS event_outbox (
event_id TEXT PRIMARY KEY, order_id TEXT NOT NULL,
event_type TEXT NOT NULL, payload TEXT NOT NULL,
status TEXT NOT NULL DEFAULT 'pending')");
$orderId = bin2hex(random_bytes(16));
$eventId = bin2hex(random_bytes(16));
$payload = json_encode(['order_id' => $orderId, 'amount_cents' => 2990], JSON_THROW_ON_ERROR);
$pdo->beginTransaction();
try {
$order = $pdo->prepare('INSERT INTO order_records(id, amount_cents) VALUES (?, ?)');
$order->execute([$orderId, 2990]);
$event = $pdo->prepare('INSERT INTO event_outbox(event_id, order_id, event_type, payload)
VALUES (?, ?, ?, ?)');
$event->execute([$eventId, $orderId, 'order.created', $payload]);
$pdo->commit();
} catch (Throwable $error) {
if ($pdo->inTransaction()) $pdo->rollBack();
throw $error;
}
echo $orderId, PHP_EOL;

PHP手册中的PDO::commit定义
提交成功后再由独立发送器处理
发送器读取pending事件、调用目标服务,获得确认后更新状态。这些动作不能放在上面的数据库事务中等待网络;若发送后、标记前进程退出,事件可能再次投递,因此外部消费者还需按event_id实现幂等。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
覆盖请求重试的业务重复
示例每次执行创建新订单和事件,适合说明事务边界。真实HTTP接口必须另外设计业务幂等键,避免客户端重试创建第二笔订单。Outbox不会自动合并相同业务请求,也不会替代授权、库存等业务校验。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










