php 8.6写接口可以用mysql唯一约束与事务保存幂等结果:同一账号、同一请求键只对应一份输入摘要和业务编号。相同键但不同输入应拒绝,重复的相同输入则读取原结果;本例把业务行与幂等行放在同一个innodb事务内,不包含外部付款、邮件等副作用。
。图源:PHP Documentation Group(CC BY 3.0)。
PHP手册中的Transactions and auto-commit。图源:PHP Documentation Group(CC BY 3.0)。
建立带账号边界的请求表
CREATE TABLE demo_requests ( account_id BIGINT NOT NULL, request_key VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, input_hash CHAR(64) NOT NULL, result_id BIGINT NULL, PRIMARY KEY(account_id,request_key) ) ENGINE=InnoDB; CREATE TABLE demo_actions ( id BIGINT NOT NULL AUTO_INCREMENT PRIMARY KEY, account_id BIGINT NOT NULL, item_id BIGINT NOT NULL, quantity INT NOT NULL ) ENGINE=InnoDB;
。图源:PHP Documentation Group(CC BY 3.0)。
PHP手册中的PDO::beginTransaction。图源:PHP Documentation Group(CC BY 3.0)。
在事务中保存或复用结果
<?php $db=new PDO('mysql:host=127.0.0.1;dbname=app;charset=utf8mb4',getenv('DB_USER'),getenv('DB_PASSWORD'),[
PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION,PDO::ATTR_EMULATE_PREPARES=>false]);
$accountId=42; // 由当前已认证身份取得,不从请求体信任。
$key=$_SERVER['HTTP_IDEMPOTENCY_KEY']??'';
if(!is_string($key)||!preg_match('/\A[A-Za-z0-9_-]{20,64}\z/D',$key))throw new InvalidArgumentException('请求键无效');
$itemId=101;$quantity=2; // 已完成字段、库存/业务权限等必要校验的输入。
$hash=hash('sha256',json_encode([$itemId,$quantity],JSON_THROW_ON_ERROR));
$db->beginTransaction();
try{
$put=$db->prepare('INSERT INTO demo_requests(account_id,request_key,input_hash) VALUES(?,?,?) ON DUPLICATE KEY UPDATE request_key=request_key');
$put->execute([$accountId,$key,$hash]);
$get=$db->prepare('SELECT input_hash,result_id FROM demo_requests WHERE account_id=? AND request_key=? FOR UPDATE');
$get->execute([$accountId,$key]);$row=$get->fetch(PDO::FETCH_ASSOC);
if(!$row||!hash_equals($row['input_hash'],$hash))throw new DomainException('同一请求键对应不同输入');
if($row['result_id']===null){
$st=$db->prepare('INSERT INTO demo_actions(account_id,item_id,quantity) VALUES(?,?,?)');
$st->execute([$accountId,$itemId,$quantity]);$id=$db->lastInsertId();
$st=$db->prepare('UPDATE demo_requests SET result_id=? WHERE account_id=? AND request_key=?');
$st->execute([$id,$accountId,$key]);
}else{$id=$row['result_id'];}
$db->commit();
}catch(Throwable $e){if($db->inTransaction())$db->rollBack();throw $e;}
echo json_encode(['id'=>(string)$id],JSON_THROW_ON_ERROR);
覆盖响应丢失和输入冲突
事务已提交但客户端没收到响应时,用原键重试会返回同一编号。把输入换成另一个商品或数量却保留原键,应返回业务冲突;不能默默复用旧结果。请求键的保留时间必须覆盖客户端允许的重试期,过早删除会重新创建业务行。
示例专注幂等契约,死锁、连接中断等故障仍按完整事务的处理规则恢复;提交结果未知时优先使用同键查询,不能换新键重做。长期状态、外部副作用与跨系统幂等需要额外协议,数据库事务不能自动覆盖它们。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










