MongoDB\BSON\toPHP
(mongodb >=1.0.0)
MongoDB\BSON\toPHP — Returns the PHP representation of a BSON value
Descrição
Unserializes a BSON document (i.e. binary string) to its PHP representation.
The typeMap paramater may be used to control the PHP
types used for converting BSON arrays and documents (both root and embedded).
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.
Valor Retornado
The unserialized PHP value.
Erros/Exceções
- Throws MongoDB\Driver\Exception\InvalidArgumentException if a class in the type map cannot be instantiated or does not implement MongoDB\BSON\Unserializable.
- Lança uma exceção MongoDB\Driver\Exception\UnexpectedValueException se a entrada não contiver exatamente um documento BSON. Os possíveis motivos incluem, mas não estão limitados a, BSON inválido, dados extras (depois de ler um documento BSON) ou um erro inesperado da » libbson.
Registro de Alterações
| Versão | Descrição |
|---|---|
| PECL mongodb 1.4.0 |
If the input contains an unsupported, deprecated BSON type, the driver will now no longer log a warning to the debug log, but instead will create an object representing this type. |
| PECL mongodb 1.3.2 |
MongoDB\Driver\Exception\UnexpectedValueException is no longer thrown if the input contains an unsupported, deprecated BSON type. Such types will be ignored (as they were in versions before 1.3.0), although the driver will now log a warning to the debug log (see: mongodb.debug). |
| PECL mongodb 1.3.0 |
MongoDB\Driver\Exception\UnexpectedValueException is thrown if the input contains an unsupported, deprecated BSON type. Previously, such types were ignored. |
Exemplos
Exemplo #1 MongoDB\BSON\toPHP() example
<?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
- MongoDB\BSON\Document::toPHP() - Returns the PHP representation of the BSON document
- MongoDB\BSON\fromPHP() - Returns the BSON representation of a PHP value
- » MongoDB BSON
- Persisting Data
add a note
