在PHP中使用MongoDB驱动如何实现事务？-MongoDB-PHP中文网

支持，但需满足mongodb 4.0+、副本集或分片集群部署、php驱动≥1.5.0；单节点不支持，事务须在显式会话中starttransaction()开启，并传入session选项执行操作，最后committransaction()或aborttransaction()。

在php中使用mongodb驱动如何实现事务？

PHP MongoDB驱动支持事务吗？

支持，但仅限于 MongoDB 4.0+ 服务端 + 副本集或分片集群（sharded cluster）部署，且 PHP 驱动版本必须 ≥ 1.5.0。单节点（standalone）部署无法开启事务——这是最常被忽略的前提，直接导致 startTransaction() 抛出 MongoDB\Driver\Exception\RuntimeException: Transaction numbers require a replica set 错误。

如何正确启动和提交一个事务？

事务必须在会话（Session）上显式开启，不能直接在 collection 上操作。典型流程是：获取会话 → 开启事务 → 执行多个写操作 → 显式提交或中止。

使用 $client->startSession() 获取会话对象，不要复用全局连接
调用 $session->startTransaction()，注意它不返回值，也不抛异常（即使失败需靠后续操作暴露）
所有参与事务的操作（如 insertOne()、updateOne()）必须传入 ['session' => $session] 选项
成功后调用 $session->commitTransaction()；出错时必须调用 $session->abortTransaction()，否则会话可能卡住

示例片段：

$session = $client->startSession();
try {
    $session->startTransaction();
    $collection->insertOne(['name' => 'A'], ['session' => $session]);
    $collection->updateOne(['name' => 'B'], ['$set' => ['done' => true]], ['session' => $session]);
    $session->commitTransaction();
} catch (Exception $e) {
    $session->abortTransaction();
    throw $e;
}

事务内哪些操作不被支持？

不是所有 MongoDB 操作都能放进事务。常见限制包括：

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

createCollection()、dropCollection()、createIndex() 等 DDL 操作在事务中会报错 Command not supported inside a transaction
跨数据库事务不被支持（即不能在一个事务里操作 db1.users 和 db2.logs）
读操作默认使用快照隔离（snapshot），但 readConcern 必须设为 'majority'（驱动自动设置，无需手动）
事务有 60 秒默认超时（maxTimeMS 不影响事务生命周期），超时后服务端自动 abort，PHP 端再调 commitTransaction() 会失败