PHP.mk документација

MongoDB\BSON\ObjectId

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

class.mongodb-bson-objectid.php PHP.net прокси Преводот се освежува
Оригинал на PHP.net
Патека class.mongodb-bson-objectid.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + превод во позадина Кодовите, табелите и белешките остануваат читливи во истиот тек.
MongoDB\BSON\ObjectId

Референца за `class.mongodb-bson-objectid.php` со подобрена типографија и навигација.

class.mongodb-bson-objectid.php

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, Serializable {
/* Методи */
final public __construct(?string $id = null)
final public getTimestamp(): int
final public jsonSerialize(): mixed
final public __toString(): string
}

Дневник на промени

Верзија = NULL
(mongodb >=1.3.0)

» mapReduce Countable interface.

Оваа класа повеќе не имплементира PECL mongodb 1.12.0 Serializable Имплементира
за PHP 8.0+.

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

PECL mongodb 1.12.0 MongoDB\BSON\ObjectIdInterface.

PECL mongodb 1.3.0 PECL mongodb 1.12.0 Countable and JsonSerializable.

Содржина

Белешки од корисници 2 забелешки

naip1984 at gmail dot com
пред 8 години
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.
Mike T
пред 7 години
Worth noting this will throw an InvalidArgumentException if string is not in the correct format
На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.