MongoDB\BSON\toPHP

(mongodb >=1.0.0)

MongoDB\BSON\toPHP — Renvoie la représentation PHP d'une valeur BSON

Avertissement

Cette fonction a été DÉPRÉCIÉE depuis la version 1.20.0 de l'extension et a été supprimée dans la version 2.0. Les applications devraient utiliser MongoDB\BSON\Document::toPHP() à la place.

Description

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

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).

Avertissement

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.

Liste de paramètres

bson (string): La valeur BSON à désérialiser.
typeMap (array): Configuration du type de carte.

Valeurs de retour

La valeur PHP non sérialisée.

Erreurs / Exceptions

Lance une MongoDB\Driver\Exception\InvalidArgumentException si une classe dans la table de types ne peut pas être instanciée ou n'implémente pas MongoDB\BSON\Unserializable.
Lance une exception MongoDB\Driver\Exception\UnexpectedValueException si l'entrée ne contient pas exactement un document BSON. Les raisons possibles comprennent, mais ne sont pas limitées à, BSON invalide, des données supplémentaires (après avoir lu un document BSON), ou une erreur imprévu de » libbson.

Historique

Version	Description
PECL mongodb 2.0.0	Cette fonction a été supprimée.
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.

Exemples

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)
}

Voir aussi

MongoDB\BSON\Document::toPHP() - Renvoie la représentation PHP du document BSON
MongoDB\BSON\fromPHP() - Retourne la représentation BSON d'une valeur PHP
» MongoDB BSON
Persister des données

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.