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地址转换函数 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 ADORecordSet对象 adodb手册 opcache预加载 Composer的Packagist资源 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet mysql面试题 PHP json解析（json_decode）页面工具 php中几种注释规范 [原创]诡异的php-fpm超时问题纯php实现DES以及TripleDES加密算法 php 修改图片大小 PHP5 扩展SOAP 调用 webservice [鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式

略微加速

PHP官方手册 - 互联网笔记

The MongoDB\BSON\ObjectId class

简介

类摘要

更新日志

目录

User Contributed Notes 2 notes