MongoDB\BSON\toPHP

(mongodb >=1.0.0)

MongoDB\BSON\toPHP — Retorna a representação PHP de um valor BSON

Warning

Esta função tornou-se DEFASADA a partir da versão 1.20.0 da extensão, e será removida na 2.0. As aplicações devem usar MongoDB\BSON\Document::toPHP() em seu lugar.

Descrição

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

Desserializa um documento BSON (ou seja, string binária) para sua representação PHP. O parâmetro typeMap pode ser usado para controlar os tipos PHP usados ​​para converter arrays e documentos BSON (raiz e incorporados).

Warning

Os documentos BSON tecnicamente podem conter chaves duplicadas porque os documentos são armazenados como uma lista de pares chave-valor; no entanto, as aplicações devem evitar a geração de documentos com chaves duplicadas, pois o comportamento do servidor e do driver pode ser indefinido. Como os objetos e arrays do PHP não podem ter chaves duplicadas, os dados também podem ser perdidos ao decodificar um documento BSON com chaves duplicadas.

Parâmetros

bson (string)

Valor BSON a ser desserializado.

typeMap (array)

Configuração de mapeamento de tipos.

Valor Retornado

O valor PHP desserializado.

Erros/Exceções

Registro de Alterações

Versão Descrição
PECL mongodb 1.4.0

Se a entrada contiver um tipo BSON obsoleto e sem suporte, a extensão não registrará mais um aviso no registro de depuração, mas criará um objeto que representa esse tipo.

PECL mongodb 1.3.2

MongoDB\Driver\Exception\UnexpectedValueException não será mais lançada se a entrada contiver um tipo BSON obsoleto e sem suporte. Esses tipos serão ignorados (como eram nas versões anteriores a 1.3.0), embora a extensão agora grave um alerta no registro de depuração (consulte: mongodb.debug).

PECL mongodb 1.3.0

MongoDB\Driver\Exception\UnexpectedValueException será lançada se a entrada contiver um tipo BSON obsoleto e não suportado. Anteriormente, esses tipos eram ignorados.

Exemplos

Example #1 Exemplo de MongoDB\BSON\toPHP()

<?php

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

?>

O exemplo acima produzirá:

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

Veja Também