Devuelve la representación en PHP de un valor BSON

# MongoDB\BSON\toPHP

(mongodb >=1.0.0)

MongoDB\BSON\toPHP — Devuelve 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

function 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

- Lanza MongoDB\Driver\Exception\InvalidArgumentException si una clase en el mapa de tipos no puede ser instanciada o no implementa MongoDB\BSON\Unserializable.
- Lanza una excepción MongoDB\Driver\Exception\UnexpectedValueException si la entrada no contiene exactamente un documento BSON. Las razones posibles incluyen, pero no se limitan a, BSON inválido, datos adicionales (después de leer un documento BSON), o un error inesperado de » libbson.

### 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

- MongoDB\BSON\Document::toPHP() - Devuelve la representación PHP del documento BSON
- MongoDB\BSON\fromPHP() - Devuelve la representación BSON de un valor PHP
- » MongoDB BSON
- Persistir datos

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open