PHP 8.4.1 Released!

MongoDB\BSON\toPHP

(mongodb >=1.0.0)

MongoDB\BSON\toPHPRenvoie 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 sera 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

Historique

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.

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

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top