(mongodb >=1.0.0)
MongoDB\BSON\toPHP — 傳回 BSON 值的 PHP 表示法
此函式自擴充版本 1.20.0 起已遭 *棄用*，並將於 2.0 中移除。應用程式應改用 MongoDB\BSON\Document::toPHP()。
將 BSON 文件（即二進位字串）反序列化為其 PHP 表示式。`typeMap` 參數可用於控制用於轉換 BSON 陣列和文件（根目錄和嵌入式）的 PHP 類型。
由於文件是以鍵值對列表的形式儲存的，因此 BSON 文件技術上可以包含重複的鍵；然而，應用程式應避免產生具有重複鍵的文件，因為伺服器和驅動程式的行為可能未定義。由於 PHP 物件和陣列不能有重複的鍵，因此在解碼具有重複鍵的 BSON 文件時，資料也可能會遺失。
要反序列化的 BSON 值。
反序列化後的 PHP 值。
| 版本 | 說明 |
|---|---|
| PECL mongodb 1.4.0 |
如果輸入包含不支援的、已棄用的 BSON 類型，擴充功能現在將不再將警告記錄到偵錯日誌，而是建立表示此類型的物件。 |
| PECL mongodb 1.3.2 |
如果輸入包含不支援的、已棄用的 BSON 類型，則不再擲出 MongoDB\Driver\Exception\UnexpectedValueException。此類類型將被忽略（如同 1.3.0 之前的版本），但擴充功能現在會將警告記錄到偵錯日誌（請參閱：mongodb.debug）。 |
| PECL mongodb 1.3.0 |
如果輸入包含不支援的、已棄用的 BSON 類型，則會擲出 MongoDB\Driver\Exception\UnexpectedValueException。先前，此類類型會被忽略。 |
範例 #1 MongoDB\BSON\toPHP() 範例
<?php
$bson = hex2bin('0e00000010666f6f000100000000');
$value = MongoDB\BSON\toPHP($bson);
var_dump($value);
?>以上範例將輸出...
object(stdClass)#1 (1) {
["foo"]=>
int(1)
}