(mongodb >=1.0.0)
MongoDB\BSON\toPHP — Renvoie la représentation PHP d'une valeur BSON
Cette fonction a été DÉPRÉCIÉE depuis la version 1.20.0 de l'extension et sera supprimée dans la version 2.0. Les applications devraient utiliser MongoDB\BSON\Document::toPHP() à la place.
Désérialise un document BSON (c'est-à-dire une chaîne binaire) en sa représentation PHP.
Le paramètre typeMap peut être utilisé pour contrôler les types PHP utilisés
pour convertir les tableaux et documents BSON (à la fois racine et intégrés).
Les documents BSON peuvent techniquement contenir des clés dupliquées car les documents sont stockés en tant qu'une liste de paire clé-valeur ; cependant, les applications devrait s'abstenir de générer des documents avec des clés dupliquées car le comportement du serveur et du pilote peut être indéfinie. Puisque les objets et tableaux PHP ne peuvent pas avoir de clés dupliquées, les données pourraient aussi être perdu lors du décodage d'un document BSON avec des clés dupliquées.
La valeur PHP non sérialisée.
| Version | Description |
|---|---|
| PECL mongodb 1.4.0 |
Si l'entrée contient un type BSON non pris en charge ou obsolète, l'extension ne générera plus un avertissement dans le journal de débogage, mais créera plutôt un objet représentant ce type. |
| PECL mongodb 1.3.2 |
MongoDB\Driver\Exception\UnexpectedValueException ne lance plus d'exception si l'entrée contient un type BSON non pris en charge ou obsolète. Ces types seront ignorés (comme ils l'étaient dans les versions antérieures à 1.3.0), bien que l'extension écrira désormais un avertissement dans le journal de débogage (voir : mongodb.debug). |
| PECL mongodb 1.3.0 |
MongoDB\Driver\Exception\UnexpectedValueException est lancée si l'entrée contient un type BSON non pris en charge ou obsolète. Auparavant, de tels types étaient ignorés. |
Exemple #1 Exemple de MongoDB\BSON\toPHP()
<?php
$bson = hex2bin('0e00000010666f6f000100000000');
$value = MongoDB\BSON\toPHP($bson);
var_dump($value);
?>L'exemple ci-dessus va afficher :
object(stdClass)#1 (1) {
["foo"]=>
int(1)
}