array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.mongodb.bson-tophp.php', 1 => 'MongoDB\\BSON\\toPHP', 2 => 'Retorna a representação PHP de um valor BSON', ), 'up' => array ( 0 => 'ref.bson.functions.php', 1 => 'Funções', ), 'prev' => array ( 0 => 'function.mongodb.bson-tojson.php', 1 => 'MongoDB\\BSON\\toJSON', ), 'next' => array ( 0 => 'function.mongodb.bson-torelaxedextendedjson.php', 1 => 'MongoDB\\BSON\\toRelaxedExtendedJSON', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mongodb/functions/bson/tophp.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

MongoDB\BSON\toPHP

(mongodb >=1.0.0)

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

Aviso

Esta função foi DESCONTINUADA a partir da versão 1.20.0 da extensão, e foi 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).

Aviso

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 2.0.0 Esta função foi removida.
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

Exemplo #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