PHP Conference Japan 2024

MongoDB\BSON\Persistable::bsonSerialize

(mongodb >=1.0.0)

MongoDB\BSON\Persistable::bsonSerialize提供一個陣列或文件以序列化為 BSON

說明

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

在物件序列化為 BSON 期間呼叫。此方法必須返回一個 陣列stdClassMongoDB\BSON\Document

傳回值將永遠序列化為 BSON 文件。序列化後的文檔將包含一個欄位,其中包含物件的類別名稱。因此,在此方法中無法傳回 MongoDB\BSON\PackedArray 實例。

建議使用者在傳回 BSON 根文檔的資料時包含 _id 屬性(例如,在建構函式中初始化的 MongoDB\BSON\ObjectId)。如果沒有 _id 屬性,擴充套件或伺服器將分別為插入或更新操作產生一個 MongoDB\BSON\ObjectId

參數

此函數沒有參數。

傳回值

要序列化為 BSON 文件的 陣列stdClassMongoDB\BSON\Document

更新日誌

版本 說明
PECL mongodb 1.17.0

除了 陣列stdClass 之外,此方法現在也可以傳回 MongoDB\BSON\Document 實例。

另請參閱

新增註解

使用者貢獻的註解

此頁面沒有使用者貢獻的註解。
To Top