PHP 8.5.6 Released!

MongoDB\BSON\toPHP

(mongodb >=1.0.0)

MongoDB\BSON\toPHPDevuelve la representación en PHP de un valor BSON

Advertencia

Esta función ha sido DEPRECADA a partir de la versión 1.20.0 de la extensión y fue eliminada en la versión 2.0. Las aplicaciones deben usar MongoDB\BSON\Document::toPHP() en su lugar.

Descripción

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

Deserializa un documento BSON (es decir, una cadena binaria) a su representación en PHP. El parámetro typeMap puede usarse para controlar los tipos de PHP utilizados para convertir matrices y documentos BSON (tanto raíz como incrustados).

Advertencia

Los documentos BSON pueden contener técnicamente claves duplicadas ya que los documentos se almacenan como una lista de pares clave-valor; sin embargo, las aplicaciones deben abstenerse de generar documentos con claves duplicadas ya que el comportamiento del servidor y del controlador puede ser indefinido. Dado que los objetos y arrays de PHP no pueden tener claves duplicadas, los datos también podrían perderse al decodificar un documento BSON con claves duplicadas.

Parámetros

bson (string)
Valor BSON a deserializar.
typeMap (array)
Configuración del mapa de tipos.

Valores devueltos

El valor en PHP deserializado.

Errores/Excepciones

Historial de cambios

Versión Descripción
PECL mongodb 2.0.0 Esta función ha sido eliminada.
PECL mongodb 1.4.0 Si la entrada contiene un tipo BSON obsoleto no admitido, la extensión ya no registrará una advertencia en el registro de depuración, sino que creará un objeto que represente este tipo.
PECL mongodb 1.3.2 Ya no se lanza MongoDB\Driver\Exception\UnexpectedValueException si la entrada contiene un tipo BSON obsoleto no admitido. Tales tipos serán ignorados (como lo eran en versiones anteriores a 1.3.0), aunque la extensión registrará ahora una advertencia en el registro de depuración (ver: mongodb.debug).
PECL mongodb 1.3.0 Se lanza MongoDB\Driver\Exception\UnexpectedValueException si la entrada contiene un tipo BSON obsoleto no admitido. Anteriormente, tales tipos eran ignorados.

Ejemplos

Ejemplo #1 Ejemplo de MongoDB\BSON\toPHP()

<?php

$bson
= hex2bin('0e00000010666f6f000100000000');
$value = MongoDB\BSON\toPHP($bson);
var_dump($value);

?>

El ejemplo anterior mostrará:

object(stdClass)#1 (1) {
  ["foo"]=>
  int(1)
}

Ver también

add a note

User Contributed Notes

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