PHP Conference Kansai 2025

MongoDB\BSON\Persistable::bsonSerialize

(mongodb >=1.0.0)

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

Beschreibung

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 the constructor) when returning data for a BSON root document. In the absence of an _id property, the extension or server will generate a MongoDB\BSON\ObjectId for insert or upsert operations, respectively.

Parameter-Liste

Diese Funktion besitzt keine Parameter.

Rückgabewerte

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

Changelog

Version Beschreibung
PECL mongodb 2.0.0 Rückgabetypen, die zuvor als vorläufig deklariert waren, werden nun erzwungen.
PECL mongodb 1.17.0

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

Siehe auch

add a note

User Contributed Notes

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