array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.mongodb.bson-tophp.php', 1 => 'MongoDB\\BSON\\toPHP', 2 => 'Возвращает PHP-представление BSON-значения', ), 'up' => array ( 0 => 'ref.bson.functions.php', 1 => 'Функции', ), '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' => 'ru', '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 — Возвращает PHP-представление BSON-значения

Внимание

Метод УСТАРЕЛ с модуля версии 1.20.0, а в версии 2.0 метод удалили. Вместо этого метода приложениям лучше вызывать метод MongoDB\BSON\Document::toPHP().

Описание

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

Метод десериализует BSON-документ — двоичную строку — в его PHP-представление. Через параметр typeMap управляют PHP-типами, через которые преобразовывают BSON-массивы и BSON-документы (как корневые, так и встроенные).

Внимание

Документы BSON технически могут содержать повторяющиеся ключи, поскольку документы хранятся в виде списка пар ключ-значение; однако приложениям следует воздерживаться от создания документов с дубликатами ключей, поскольку поведение сервера и драйвера может быть неопределённым. Поскольку объекты и массивы PHP не могут иметь повторяющихся ключей, данные также могут быть потеряны при декодировании документа BSON с повторяющимися ключами.

Список параметров

bson (string)

BSON-значение для десериализации.

typeMap (array)

Конфигурация карты типов.

Возвращаемые значения

Метод возвращает PHP-значение, которое сгенерировал путём десериализации BSON-документа.

Ошибки

Список изменений

Версия Описание
PECL-модуль mongodb 2.0.0 Функцию удалили.
PECL-модуль mongodb 1.4.0

Модуль больше не записывает предупреждение в журнал отладки, если входные данные содержат устаревший BSON-тип, который не поддерживается модулем. Вместо этого метод создаст объект, который представляет такой тип.

PECL-модуль mongodb 1.3.2

Метод больше не выбрасывает исключение MongoDB\Driver\Exception\UnexpectedValueException если входные данные содержат устаревший BSON-тип, который не поддерживается модулем. Метод проигнорирует такие типы (как и в версиях до 1.3.0), хотя модуль теперь записывает предупреждение в журнал отладки (смотрите описание директивы mongodb.debug).

PECL-модуль mongodb 1.3.0

Метод выбрасывает исключение MongoDB\Driver\Exception\UnexpectedValueException, если входные данные содержат устаревший BSON-тип, который не поддерживается модулем. Раньше модуль игнорировал такие типы.

Примеры

Пример #1 Пример преобразования BSON-значения в PHP-представление методом MongoDB\BSON\toPHP()

<?php

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

?>

Результат выполнения приведённого примера: 

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

Смотрите также