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 driver 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, Serializable, JsonSerializable, Stringable {

/* 方法 */

final public __construct(string $id = ?)

final public getTimestamp(): int

final public jsonSerialize(): mixed

final public serialize(): string

final public __toString(): string

final public unserialize(string $serialized): void

}

更新日志

版本说明

PECL mongodb 1.12.0 Implements Stringable for PHP 8.0+.

PECL mongodb 1.3.0

版本	说明
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.

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

Implements MongoDB\BSON\ObjectIdInterface.

PECL mongodb 1.2.0 Implements Serializable and JsonSerializable.

MongoDB\BSON\ObjectId::__construct — Construct a new ObjectId
MongoDB\BSON\ObjectId::getTimestamp — Returns the timestamp component of this ObjectId
MongoDB\BSON\ObjectId::jsonSerialize — Returns a representation that can be converted to JSON
MongoDB\BSON\ObjectId::serialize — Serialize an ObjectId
MongoDB\BSON\ObjectId::__toString — Returns the hexidecimal representation of this ObjectId
MongoDB\BSON\ObjectId::unserialize — Unserialize an ObjectId

add a note

User Contributed Notes 2 notes

down

naip1984 at gmail dot com ¶

4 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:   https://docs.mongodb.com/php-library/current/reference/method/MongoDBCollection-findOne/

Note this is for the PHP library, not the legacy library.

down

Mike T ¶

4 years ago


Worth noting this will throw an InvalidArgumentException if string is not in the correct format

add a note

官方地址：https://www.php.net/manual/en/class.mongodb-bson-objectid.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络 JAVA NoSQL 数据库面试 C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet ADORecordSet对象 adodb手册 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 Composer的Packagist资源 opcache预加载 mysql面试题 [鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式 PHP7添加redis扩展 PHPstorm 里面Terminal 不能使用 esc键吗退出编辑模式吗 PHP mkdir()写出来的权限与mode值不符合 php $_SERVER中的SERVER_NAME 和HTTP_HOST的区别 PHP-FPM进程数的设定 php设置cookie为httponly防止xss攻击

略微加速

PHP官方手册 - 互联网笔记

The MongoDB\BSON\ObjectId class

简介

类摘要

更新日志

目录

User Contributed Notes 2 notes