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