MongoDB\BSON\Binary 类

(mongodb >=1.0.0)

简介

用于二进制数据的 BSON 类型(例如字节数组)。二进制值还具有一个子类型,用于指示字节数组中数据的类型。从零到 127 的子类型是预定义或保留的。从 128 到 255 的子类型是用户定义的。

类概要

/* 常量 */
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
final public serialize(): string
final public __toString(): string
final public unserialize(string $data): void
}

预定义常量

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)。使用此类型时,Binary 的数据应为 16 字节长。

历史上,其他驱动程序根据其语言约定(例如不同的字节序)对使用此类型的数值进行编码,这使其不可移植。PHP 扩展对使用此类型的数据的编码或解码不进行任何特殊处理。

MongoDB\BSON\Binary::TYPE_UUID

通用唯一标识符。使用此类型时,Binary 的数据应为 16 字节长,并按照 » RFC 4122 进行编码。

MongoDB\BSON\Binary::TYPE_MD5

MD5 哈希。使用此类型时,Binary 的数据应为 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 实现 SerializableJsonSerializable

目录

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top