array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.mongodb.bson-tophp.php', 1 => 'MongoDB\\BSON\\toPHP', 2 => 'Devuelve la representación PHP de un valor BSON', ), 'up' => array ( 0 => 'ref.bson.functions.php', 1 => 'Funciones', ), 'prev' => array ( 0 => 'function.mongodb.bson-tojson.php', 1 => 'MongoDB\\BSON\\toJSON', ), 'next' => array ( 0 => 'function.mongodb.bson-torelaxedextendedjson.php', 1 => 'MongoDB\\BSON\\toRelaxedExtendedJSON', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/mongodb/functions/bson/tophp.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

MongoDB\BSON\toPHP

(mongodb >=1.0.0)

MongoDB\BSON\toPHP — Devuelve la representación PHP de un valor BSON

Advertencia

Esta función ha sido DEPRECADA desde la versión 1.20.0 de la extensión y ha sido eliminada en la versión 2.0. Las aplicaciones deberían utilizar 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) en su representación PHP. El parámetro typeMap puede ser utilizado para controlar los tipos PHP utilizados para convertir los arrays y documentos BSON (tanto raíz como integrados).

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)

El valor BSON a deserializar.

typeMap (array)

Configuración del mapa de tipos.

Valores devueltos

El valor PHP no serializado.

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 no soportado o obsoleto, la extensión ya no generará una advertencia en el registro de depuración, sino que creará un objeto que represente dicho tipo.

PECL mongodb 1.3.2

MongoDB\Driver\Exception\UnexpectedValueException ya no lanza una excepción si la entrada contiene un tipo BSON no soportado o obsoleto. Estos tipos serán ignorados (como lo eran en versiones anteriores a 1.3.0), aunque la extensión ahora escribirá una advertencia en el registro de depuración (ver: mongodb.debug).

PECL mongodb 1.3.0

MongoDB\Driver\Exception\UnexpectedValueException es lanzada si la entrada contiene un tipo BSON no soportado o obsoleto. Anteriormente, dichos 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