PHP 8.3.0 RC 6 available for testing

MongoDB\BSON\Persistable::bsonSerialize

(mongodb >=1.0.0)

MongoDB\BSON\Persistable::bsonSerializeProvides an array or document to serialize as BSON

说明

abstract public MongoDB\BSON\Persistable::bsonSerialize(): array|stdClass|MongoDB\BSON\Document

Called during serialization of the object to BSON. The method must return an array, stdClass, or MongoDB\BSON\Document.

The return value will always be serialized as a BSON document. The serialized document will include a field containing the class name of the object. For this reason, it is not possible to return a MongoDB\BSON\PackedArray instance in this method.

Users are encouraged to include an _id property (e.g. a MongoDB\BSON\ObjectId initialized in your constructor) when returning data for a BSON root document; otherwise, the driver or database will need to generate a MongoDB\BSON\ObjectId when inserting or upserting the document, respectively.

参数

此函数没有参数。

返回值

An array, stdClass, or MongoDB\BSON\Document to be serialized as a BSON document.

更新日志

版本 说明
PECL mongodb 1.17.0

This method may now also return MongoDB\BSON\Document instances in addition to array and stdClass.

参见

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top