PHP 7.2+ 下需同时满足：MongoDB 4.0+ 副本集/分片集群、连接字符串含 replicaSet 参数、启用 mongodb.so 扩展并安装 mongodb/mongodb 库，且事务操作须在新会话中显式 startTransaction() 并传入 session 选项。
PHP 7.2+ 环境下使用 mongodb/mongodb 库才能安全启用事务，原生 mongodb 扩展（extension=mongodb.so）只提供底层驱动，不包含事务 API 封装。
确认 MongoDB 服务版本与部署模式
事务仅在 MongoDB 4.0+ 的副本集（Replica Set）或分片集群（Sharded Cluster）中可用，单节点 standalone 模式不支持事务。
- 运行
mongod --version确认服务端版本 ≥ 4.0 - 检查是否为副本集：连接后执行
rs.status()，若报错not master或提示未初始化，则需先配置副本集（哪怕单节点也要rs.initiate()） - PHP 连接字符串必须显式指定 replicaSet 名称，例如：
mongodb://localhost:27017/?replicaSet=rs0；缺此项会导致事务启动失败并静默回退为普通写入
安装并加载正确的 PHP 依赖组合
仅启用 mongodb 扩展不够，必须通过 Composer 加载官方 PHP Library 才能调用 startTransaction() 等方法。
- 执行
composer require mongodb/mongodb（推荐 v1.15+，兼容 PHP 8.3） - 确保
extension=mongodb.so已启用且php -m | grep mongodb可见输出 - 不要混用旧版
mongo扩展（已废弃）或手动引入MongoClient类——它们根本不识别事务上下文
PHP 代码中正确开启与提交事务
事务必须在会话（Session）内显式启动，且所有操作需绑定同一会话对象，跨会话或未捕获异常会导致自动回滚失效。
- 获取客户端后，先调用
$client->startSession()创建会话实例 - 调用
$session->startTransaction()启动事务（不是$client->startTransaction()） - 所有集合操作（
insertOne、updateOne等）必须传入['session' => $session]选项 - 成功后调用
$session->commitTransaction()；异常时必须显式$session->abortTransaction()，否则会话可能卡在 pending 状态
示例关键片段：
<?php $client = new MongoDB\Client('mongodb://localhost:27017/?replicaSet=rs0');
$session = $client->startSession();
try {
$session->startTransaction();
$client->test->users->insertOne(['name' => 'alice'], ['session' => $session]);
$client->test->logs->insertOne(['event' => 'user_created'], ['session' => $session]);
$session->commitTransaction();
} catch (Exception $e) {
$session->abortTransaction();
throw $e;
}
?>
常见事务失败原因与调试线索
事务失败通常不抛出明确异常，而是静默降级为普通操作，导致数据不一致却难以察觉。
- 连接字符串漏掉
?replicaSet=xxx→ 查看$session->isInTransaction()返回false - 集合所在数据库未启用读写权限（尤其启用了 auth）→ 检查用户是否拥有
readWrite角色且作用域覆盖对应 DB - 事务内执行了不支持的操作（如
createCollection、dropDatabase）→ 会直接抛出InvalidArgumentException - 事务持续超时（默认 60 秒）→ 在
startTransaction()中传入['maxTimeMS' => 30000]显式控制
真正容易被忽略的是：事务会话对象不能复用，每次新事务都必须新建 $client->startSession()；复用旧会话可能因内部状态残留导致 commitTransaction() 无响应。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
