MongoDB\BSON\Binary 類別

(mongodb >=1.0.0)

簡介

用於二進位資料（即位元組陣列）的 BSON 類型。二進位值也有子類型，用於指示位元組陣列中是哪種資料。從零到 127 的子類型是預定義或保留的。從 128 到 255 的子類型是使用者自訂的。

類別概要

最終類別 MongoDB\BSON\Binary 實作 MongoDB\BSON\BinaryInterface、MongoDB\BSON\Type、Serializable、JsonSerializable 以及 Stringable

/* 常數 */

const int TYPE_GENERIC = 0;

const int TYPE_FUNCTION = 1;

const int TYPE_OLD_BINARY = 2;

const int TYPE_OLD_UUID = 3;

const int TYPE_UUID = 4;

const int TYPE_MD5 = 5;

const int TYPE_ENCRYPTED = 6;

const int TYPE_COLUMN = 7;

const int TYPE_SENSITIVE = 8;

const int TYPE_USER_DEFINED = 128;

/* 方法 */

final public __construct(string $data, int $type = MongoDB\BSON\Binary::TYPE_GENERIC)

final public getData(): string

final public getType(): int

final public jsonSerialize(): mixed

最終公開方法 serialize(): 字串

最終公開方法 __toString(): 字串

最終公開方法 unserialize(字串 $data): 無

}

預定義常數

MongoDB\BSON\Binary::TYPE_GENERIC

通用二進位資料。

MongoDB\BSON\Binary::TYPE_FUNCTION

函式。

MongoDB\BSON\Binary::TYPE_OLD_BINARY

通用二進位資料（已棄用，建議使用 MongoDB\BSON\Binary::TYPE_GENERIC）。

MongoDB\BSON\Binary::TYPE_OLD_UUID

通用唯一識別碼（已棄用，建議使用 MongoDB\BSON\Binary::TYPE_UUID）。使用此類型時，二進位資料的長度應為 16 個位元組。

過去，其他驅動程式會根據其語言慣例（例如不同的位元組順序）編碼此類型的值，這使得它不具可攜性。PHP 擴充功能不會對使用此類型編碼或解碼資料套用任何特殊處理。

MongoDB\BSON\Binary::TYPE_UUID

通用唯一識別碼。使用此類型時，二進位資料的長度應為 16 個位元組，並根據 » RFC 4122 進行編碼。

MongoDB\BSON\Binary::TYPE_MD5

MD5 雜湊值。使用此類型時，二進位資料的長度應為 16 個位元組。

MongoDB\BSON\Binary::TYPE_ENCRYPTED

加密值。此子類型用於用戶端加密。

MongoDB\BSON\Binary::TYPE_COLUMN

欄位資料。此子類型用於時間序列集合。

MongoDB\BSON\Binary::TYPE_SENSITIVE

敏感資料。此子類型用於敏感資料，應盡可能從伺服器端記錄中排除。

MongoDB\BSON\Binary::TYPE_USER_DEFINED

使用者定義類型。0 到 127 之間的類型是預定義或保留的，而 128 到 255 之間的類型是使用者定義的，可用於任何用途。

更新日誌

版本	說明
PECL mongodb 1.17.0	新增 `MongoDB\BSON\Binary::TYPE_SENSITIVE`。
PECL mongodb 1.12.0	針對 PHP 8.0+ 版本實作 Stringable 介面。新增 `MongoDB\BSON\Binary::TYPE_COLUMN`。
PECL mongodb 1.7.0	新增 `MongoDB\BSON\Binary::TYPE_ENCRYPTED`。
PECL mongodb 1.3.0	實作 MongoDB\BSON\BinaryInterface 介面。
PECL mongodb 1.2.0	實作 Serializable 和 JsonSerializable 介面。

MongoDB\BSON\Binary::__construct — 建構新的 Binary 物件
MongoDB\BSON\Binary::getData — 傳回 Binary 的資料
MongoDB\BSON\Binary::getType — 傳回 Binary 的類型
MongoDB\BSON\Binary::jsonSerialize — 傳回可轉換為 JSON 的表示法
MongoDB\BSON\Binary::serialize — 序列化 Binary 物件
MongoDB\BSON\Binary::__toString — 傳回 Binary 的資料
MongoDB\BSON\Binary::unserialize — 反序列化 Binary 物件

發現問題？

瞭解如何改進此頁面 • 提交拉取請求 • 回報錯誤

＋新增筆記

使用者貢獻的筆記

此頁面沒有使用者貢獻的筆記。