« MongoDB\\BSON\\toJSONMongoDB\\BSON\\toRelaxedExtendedJSON »PHP ManualФункції

MongoDB\BSON\toPHP

(mongodb >=1.0.0)

MongoDB\BSON\toPHP — Повертає PHP уявлення значення BSON

Опис

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

Десериализует документ BSON (т.е. двоичную строку) в его представление PHP. ПараметрtypeMap може використовуватися для керування типами PHP, що використовуються для перетворення масивів та документів BSON (як кореневих, так і вбудованих).

Увага

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

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

bson(string)

Значення BSON для десеріалізації.

typeMap(array)

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

Значення, що повертаються

Десеріалізоване значення PHP.

Помилки

список змін

ВерсияОпис
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 Приклад використання MongoDB\BSON\toPHP()****

Loading...

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

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

Дивіться також