Mongo Shell中db.collection.save()命令在PHP中的等效实现是什么？

嘿，我来帮你理清这个问题～

首先得明确Mongo Shell里db.collection.save()的核心逻辑：

• 如果传入的文档包含_id字段，它会完全替换这个_id匹配到的现有文档（相当于带upsert: true的replaceOne）；
• 如果文档没有_id，它就直接执行插入操作（相当于insertOne）。

在PHP的官方MongoDB扩展（也就是通过Composer安装的mongodb/mongodb包，这是目前推荐使用的官方驱动）里，我们可以通过MongoDB\Collection::replaceOne()方法配合upsert选项来实现完全等效的功能。

代码示例 #

<?php
// 初始化MongoDB客户端和目标集合
$client = new MongoDB\Client("mongodb://localhost:27017");
$collection = $client->your_database_name->your_collection_name;

// 准备要"save"的文档——带_id则更新，不带则插入
$targetDocument = [
    // 可选：如果存在这个_id，就替换对应文档；不存在则插入新文档
    '_id' => new MongoDB\BSON\ObjectId('60d21b4667d0d8992e610c85'),
    'username' => 'jane_doe',
    'email' => 'jane@example.com',
    'age' => 32
];

// 执行等效于save()的操作
$operationResult = $collection->replaceOne(
    ['_id' => $targetDocument['_id']], // 匹配条件：根据_id查找
    $targetDocument, // 要替换成的新文档内容
    ['upsert' => true] // 关键选项：如果没找到匹配文档，就插入新的
);

// 查看操作结果
if ($operationResult->getUpsertedCount() > 0) {
    echo "新文档已插入，生成的ID: " . $operationResult->getUpsertedId() . PHP_EOL;
} elseif ($operationResult->getModifiedCount() > 0) {
    echo "现有文档已被替换更新" . PHP_EOL;
}
?>

额外说明 #

• 如果你手上的项目还在使用已废弃的旧版mongo扩展（注意不是现在的mongodb扩展），那里面确实有直接的save()方法，但这个扩展已经停止维护多年，强烈建议升级到官方新驱动。
• 如果你只是想插入新文档（确定没有_id），直接用insertOne()会更直观；只有当你需要“有则替换，无则插入”的逻辑时，才需要用到replaceOne()加upsert选项。

内容的提问来源于stack exchange，提问作者LF-DevJourney