MongoDB\UpdateResult::getUpsertedId()

定义

MongoDB\UpdateResult::getUpsertedId()

返回 ID（即 _id字段值）。

function getUpsertedId(): mixed|null

Return Values

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

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

错误/异常

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

另请参阅

• MongoDB\Driver\WriteResult::getUpsertedIds()