The MongoDB\BSON\ObjectId class

    (mongodb >=1.0.0)

    简介

    BSON type for an » ObjectId. The value consists of 12 bytes, where the first four bytes are a timestamp that reflect the ObjectId's creation. Specifically, the value consists of:

    • a 4-byte value representing the seconds since the Unix epoch,
    • a 5-byte random number unique to a machine and process, and
    • a 3-byte counter, starting with a random value.

    In MongoDB, each document stored in a collection requires a unique _id field that acts as a primary key. If an inserted document omits the _id field, the extension automatically generates an ObjectId for the _id field.

    Using ObjectIds for the _id field provides the following additional benefits:

    • The creation time of the ObjectId may be accessed using the MongoDB\BSON\ObjectId::getTimestamp() method.
    • Sorting on an _id field that stores ObjectId values is roughly equivalent to sorting by creation time.

    类摘要

    final class MongoDB\BSON\ObjectId implements MongoDB\BSON\ObjectIdInterface, MongoDB\BSON\Type, JsonSerializable, Stringable {
    /* 方法 */
    final public __construct(?string $id = null)
    final public getTimestamp(): int
    final public jsonSerialize(): mixed
    final public __toString(): string
    }

    更新日志

    版本 说明
    PECL mongodb 2.0.0

    此类不再实现 Serializable 接口。

    PECL mongodb 1.12.0 Implements Stringable for PHP 8.0+.
    PECL mongodb 1.3.0

    Renamed from MongoDB\BSON\ObjectID to MongoDB\BSON\ObjectId.

    Implements MongoDB\BSON\ObjectIdInterface.

    PECL mongodb 1.2.0 Implements Serializable and JsonSerializable.

    目录

    发现了问题？

    了解如何改进此页面 • 提交拉取请求 • 报告一个错误
    ＋添加备注

    用户贡献的备注 2 notes

    up
    28
    naip1984 at gmail dot com
    7 years ago
    I struggled for awhile to identify the way to find() using a ObjectID

    This seems to work, I hope this helps someone else out.

    $mongoId = '5a2493c33c95a1281836eb6a';

    $collection->find(['_id'=> new MongoDB\BSON\ObjectId("$mongoId")]);

    I found it here:
    8
    Mike T
    6 years ago
    Worth noting this will throw an InvalidArgumentException if string is not in the correct format
    ＋添加备注
    To Top

    Follow Lee on X/Twitter - Father, Husband, Serial builder creating AI, crypto, games & web tools. We are friends :) AI Will Come To Life!

    Check out: eBank.nz (Art Generator) | Netwrck.com (AI Tools) | Text-Generator.io (AI API) | BitBank.nz (Crypto AI) | ReadingTime (Kids Reading) | RewordGame | BigMultiplayerChess | WebFiddle | How.nz | Helix AI Assistant