# 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

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