MongoDB\UpdateResult::getUpsertedId()

定义

MongoDB\UpdateResult::getUpsertedId()

返回 ID（即 _id字段值）。

function getUpsertedId(): mixed|null

返回值

ID（即 _id字段值）。 如果未更新或插入任何文档，则返回null 。

如果文档在更新或插入之前具有 ID（即服务器不需要生成 ID），则这将包含其_id 字段值。任何服务器生成的 ID 都是 MongoDB\BSON\ObjectId 实例。

错误/异常

MongoDB\Exception\BadMethodCallException如果调用此方法并且写入操作使用了未确认的写关注。

另请参阅

• MongoDB\Driver\WriteResult::getUpsertedIds()