1. 基础准备
1.1 安装与引入
安装与引入阶段是实现 PHP 操作 MongoDB 更新数据的前提条件。只有在环境中正确安装了 MongoDB PHP 驱动并完成自动加载，后续的更新操作才能稳定执行。通过 Composer 可以方便地获取官方库，确保与最新 MongoDB 服务器版本的兼容性。
在开始编码前，请确认服务器上已经安装了 PHP 扩展 mongodb，并且通过 Composer 引入了 mongodb/mongodb 包。以下示例展示了典型的引入方式与客户端初始化流程，确保自动加载生效。
mydb->users;
?>
注意：请根据实际环境替换连接字符串、数据库名称与集合名称，以确保连接正确性与权限可用性。以下步骤将逐步展示如何对集合中的文档执行更新操作。
1.2 连接 MongoDB 服务
连接阶段的核心是确保客户端能够稳定地与 MongoDB 服务端通信。连接字符串可以包含认证信息、超时设置等参数，合理配置有助于提升写入稳定性与吞吐量。
连接成功后，可通过 $collection 对象执行更新操作、筛选文档以及组合不同的更新运算符。以下示例演示了如何在同一段代码中创建一个可复用的集合对象，为后续的更新操作打下基础。
2. 更新操作的核心概念
2.1 更新筛选器与更新文档
更新筛选器用于定位需要更新的文档，更新文档定义将要应用到匹配文档的变化内容。两者组合决定了更新行为的范围与结果。
理解这两部分的关系，对实现幂等更新、避免重复写入、以及实现复杂业务逻辑至关重要。下面的示例展示如何通过简单筛选器定位一个文档并应用更新。
'user@example.com']; // 匹配条件
$update = ['$set' => ['lastLogin' => new MongoDB\BSON\UTCDateTime()]]; // 更新内容
$result = $collection->updateOne($filter, $update);// 输出结果信息，帮助判定更新是否命中与修改数量
echo "Matched: " . $result->getMatchedCount() . ", Modified: " . $result->getModifiedCount() . "\n";
?>
过滤条件应尽量明确，以避免误更新。若涉及多文档更新，请考虑使用 updateMany 以提升写入效率。
2.2 常用更新运算符
更新运算符定义了对文档字段的具体修改方式。常见的有 $set、$inc、$unset、$push、$addToSet 等。
为了实现高效且可维护的代码，建议将更新逻辑拆分成明确的运算符组合，并尽可能在服务器端完成批处理。以下文本段落将逐步展示这些运算符的具体用法。
3. 常用更新操作
3.1 使用 $set 更新字段
$set是最常用的更新运算符，用于给现有字段赋新值，若字段不存在则创建字段。它是实现“局部更新”的核心工具，能显著降低数据变更的粒度。
在实际应用中，仅更新需要变更的字段可以减少网络传输与日志产生，提高性能。下面示例演示如何对单条记录做字段更新。
new MongoDB\BSON\ObjectId('64c0f0000000000000000000')];
$update = ['$set' => ['name' => '张三', 'email' => 'zhangsan@example.com']];
$collection->updateOne($filter, $update);
?>
注意：更新前请确保字段命名规范、字段类型正确，以避免数据不一致问题。
3.2 使用 $inc 实现自增更新
$inc用于对数值字段执行自增或自减，适合实现计数、版本号提升等场景。原子性保证了并发写入下的正确性。
结合实际业务，可以在更新时同时更新多个文档的同一字段，以实现全局统计的快速演变。下方示例展示如何对一个文档的点击数进行自增。
new MongoDB\BSON\ObjectId('64c0f0000000000000000000')];
$update = ['$inc' => ['clickCount' => 1]];
$collection->updateOne($filter, $update);
?>
3.3 使用 $unset 删除字段
$unset用于从文档中移除一个或多个字段，常用于清理临时字段或不再需要的属性。移除字段通常比设置为 null 更加明确且不会占用存储。
在批量更新场景中，搭配条件筛选，可以一次性移除多条文档中的字段。以下示例演示如何删除临时字段。
true];
$update = ['$unset' => ['tempFlag' => '']];
$collection->updateMany($filter, $update);
?>
3.4 使用 $push 与 $addToSet 更新数组
$push用于向数组字段追加新的元素，适合记录日志、历史操作等累积数据。$addToSet则在向数组添加元素时去重，避免重复值。
为了确保幂等性，建议根据实际需求选择 $push 或 $addToSet，必要时结合 $each 实现批量追加。
new MongoDB\BSON\ObjectId('64c0f0000000000000000000')];
$update = ['$push' => ['logs' => ['message' => '更新完成','ts' => new MongoDB\BSON\UTCDateTime()]]
];
$collection->updateOne($filter, $update);
?>
new MongoDB\BSON\ObjectId('64c0f0000000000000000000')];
$update = ['$addToSet' => ['tags' => ['$each' => ['php', 'mongodb']]]
];
$collection->updateOne($filter, $update);
?>
4. 高级更新与性能
4.1 updateMany 的批量更新
updateMany允许对匹配条件的所有文档执行更新，从而实现大规模变更。使用时请谨慎设定筛选条件，以避免不必要的写入。
在需要对同一字段进行同类型更新的场景下，updateMany能显著提升吞吐量，同时保持原子性对单文档的更新效果。
'pending'];
$update = ['$set' => ['status' => 'processing']];
$cursor = $collection->updateMany($filter, $update);
printf("Updated %d documents\n", $cursor->getModifiedCount());
?>
4.2 BulkWrite 的批量写入更新
BulkWrite提供了更底层的批量写入能力，适合需要将多种更新混合在同一个批次中的场景。通过 BulkWrite 可以显式构造一组更新操作并一次性提交。
请注意 BulkWrite 的执行结果包含每条更新的状态，便于后续的错误处理与重试策略。下面示例展示了一个简单的多操作批量更新。
update(['status' => 'new'],['$set' => ['status' => 'processed']],['multi' => true]
);
$result = $manager->executeBulkWrite('mydb.orders', $bulk);
?>
4.3 Upsert 场景的应用与注意
Upsert是在更新条件未命中时插入新文档的特性，写入成本与数据一致性需要仔细评估。通过在 updateOne 或 updateMany 的选项中开启 upsert，可以确保关键数据在缺失时自动创建。
结合 $set 与条件过滤，可以实现“先判断再写入”的幂等更新模式，避免重复记录与脏数据。
'alice'];
$update = ['$set' => ['username' => 'alice', 'signupDate' => new MongoDB\BSON\UTCDateTime()]];
$options = ['upsert' => true];
$result = $collection->updateOne($filter, $update, $options);
?>
5. 实战场景
5.1 场景：单条记录的快速更新
在日常应用中，常见需求是对单条用户信息进行局部更新。先定位再更新，确保只修改必要的字段，避免全表扫描导致的性能下降。
实际业务中，通常会结合 $set、$inc 与写超时控制，保障更新在高并发场景下的稳定性。以下是一个综合示例，演示如何对单条文档执行多字段更新。
'user@example.com'];
$update = ['$set' => ['name' => '王五', 'updatedAt' => new MongoDB\BSON\UTCDateTime()],'$inc' => ['version' => 1]
];
$result = $collection->updateOne($filter, $update);
?>
5.2 场景扩展：批量更新与回滚准备
在需要对多条记录执行相同更新时，批量更新策略尤为重要。结合 updateMany 与 BulkWrite，可以显著提升吞吐并降低网络往返。若业务对一致性要求较高，结合事务（在副本集环境下）进一步确保原子性。
为了应对异常情况，建议在更新前后记录日志、捕获异常并按策略执行重试、回滚或补偿操作。以下示例呈现一个简化的批量更新流程，与简单的异常处理逻辑相结合。
update(['status' => 'new'],['$set' => ['status' => 'processed']],['multi' => true]);$result = $manager->executeBulkWrite('mydb.orders', $bulk);// 日志记录更新结果
} catch (Exception $e) {// 错误处理与回滚策略error_log("MongoDB update failed: " . $e->getMessage());
}
?>
