MongoDB\BSON\toPHP

(mongodb >=1.0.0)

MongoDB\BSON\toPHP返回 BSON 值的 PHP 表示形式

描述

MongoDB\BSON\toPHP(string $bson, array $typeMap = array()): array|object

将 BSON 文档(即二进制字符串)反序列化为其 PHP 表示形式。typeMap 参数可用于控制用于转换 BSON 数组和文档(根和嵌入式)的 PHP 类型。

警告

从技术上讲,BSON 文档可以包含重复的键,因为文档存储为键值对的列表;但是,应用程序应避免生成包含重复键的文档,因为服务器和驱动程序的行为可能未定义。由于 PHP 对象和数组不能包含重复的键,因此在解码包含重复键的 BSON 文档时,数据也可能丢失。

参数

bson (string)

要反序列化的 BSON 值。

typeMap (array)

类型映射配置.

返回值

反序列化的 PHP 值。

错误/异常

变更日志

版本 描述
PECL mongodb 1.4.0

如果输入包含不受支持的、已弃用的 BSON 类型,则扩展程序现在将不再向调试日志记录警告,而是将创建一个表示此类型的对象。

PECL mongodb 1.3.2

如果输入包含不受支持的、已弃用的 BSON 类型,则不再抛出 MongoDB\Driver\Exception\UnexpectedValueException。此类类型将被忽略(与 1.3.0 之前的版本一样),尽管扩展程序现在将向调试日志记录警告(参见:mongodb.debug)。

PECL mongodb 1.3.0

如果输入包含不受支持的、已弃用的 BSON 类型,则抛出 MongoDB\Driver\Exception\UnexpectedValueException。以前,此类类型被忽略。

示例

示例 #1 MongoDB\BSON\toPHP() 示例

<?php

$bson
= hex2bin('0e00000010666f6f000100000000');
$value = MongoDB\BSON\toPHP($bson);
var_dump($value);

?>

上面的示例将输出

object(stdClass)#1 (1) {
  ["foo"]=>
  int(1)
}

参见

添加注释

用户贡献的注释

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