PHP 怎么PHP BSON

PHP 怎么用 BSON？深入解析 MongoDB 二进制序列化格式的实战指南

---

目录导读（Table of Contents）

1. 什么是 BSON？为什么 MongoDB 要用它？
2. PHP 中处理 BSON 的核心扩展：mongodb 与 ext-mongodb
3. BSON 与 JSON 的对比：性能与数据类型的差异
4. PHP 实战：编码（Encode）与解码（Decode）BSON
   • 1 安装与启用扩展
   • 2 使用 BSON\fromPHP() 与 BSON\toPHP()
   • 3 处理特殊类型：日期、ObjectId、二进制数据
5. 常见问题与性能优化技巧（FAQ）
6. 何时该直接用 BSON，何时用 JSON？

---

什么是 BSON？为什么 MongoDB 要用它？

BSON（Binary JSON）是一种类 JSON 的二进制序列化格式，由 MongoDB 设计并用于存储文档和网络传输，与纯文本的 JSON 不同，BSON 在编码时记录了每个字段的类型信息（如 int32、double、datetime），这使 MongoDB 能够高效地执行范围查询、排序和索引操作，BSON 是 MongoDB 的“母语”，而 PHP 作为服务端语言，需要理解这种语言才能与数据库无缝交互。

如果你在 PHP 中直接操作 JSON 字符串去查询 MongoDB，你会遇到两个致命问题：日期格式无法还原为 Date 对象；整数可能被解析为浮点数，而 BSON 扩展则完美解决了这些痛点。

PHP 中处理 BSON 的核心扩展：mongodb 与 ext-mongodb

在 PHP 7.4+ 和 PHP 8.x 环境中，官方推荐使用 mongodb/mongodb 库（通过 Composer 安装），其底层依赖于 PECL 的 mongodb 扩展，该扩展提供了 BSON 命名空间下的类（如 BSON\ObjectId、BSON\UTCDateTime）以及两个核心函数：BSON\fromPHP(array $document): string 和 BSON\toPHP(string $bson, array $typeMap): array。

你需要通过 PECL 安装：

pecl install mongodb

或者在 php.ini 中启用 extension=mongodb.so，安装后可用 php -m | grep mongodb 验证。

BSON 与 JSON 的对比：性能与数据类型的差异

特性	JSON	BSON
编码体积	较大（纯文本冗余）	较小（二进制 + 类型标记）
数据精度	整数可能变浮点	保留 int32/int64/float
日期支持	字符串	64位毫秒时间戳
遍历速度	慢（需解析字符串）	快（直接寻址）

关键差异：JSON 无法区分 1 和 0，而 BSON 会严格标记，且 BSON 文档在末尾追加长度字段，便于快速截断。

PHP 实战：编码（Encode）与解码（Decode）BSON

1 安装与启用扩展

确保已安装 mongodb 扩展，并验证版本：

<?php
var_dump(extension_loaded('mongodb'));

2 使用 BSON\fromPHP() 与 BSON\toPHP()

编码：将 PHP 数组转为 BSON 二进制字符串：

$document = [
    'name' => 'Alice',
    'age' => 30,
    'score' => 89.5,
    'tags' => ['php', 'mongodb'],
];
$bson = BSON\fromPHP($document);
echo bin2hex($bson); // 输出十六进制 BSON

解码：将 BSON 字符串转回 PHP 数组（需指定类型映射）：

$decoded = BSON\toPHP($bson, ['root' => 'array', 'document' => 'array']);
print_r($decoded);

如果不指定 typeMap，默认会返回 stdClass 对象，容易引发属性访问问题。

3 处理特殊类型：日期、ObjectId、二进制数据

• ObjectId：MongoDB 的自增主键，在 PHP 中创建：

$id = new BSON\ObjectId();
echo $id->__toString(); // 生成24位十六进制字符串
// 编码时自动转换
$doc = ['_id' => $id, 'msg' => 'hello'];
$bson = BSON\fromPHP($doc);

• UTCDateTime：日期存储为毫秒时间戳。

$date = new BSON\UTCDateTime((new DateTime('2025-03-01'))->getTimestamp() * 1000);
$doc = ['created_at' => $date];

解码时,需在 typeMap 中设置 'root' => 'array'，然后手动将 UTCDateTime 对象转回格式化日期：

$decoded = BSON\toPHP($bson, ['root' => 'array']);
$timestamp = $decoded['created_at']->toDateTime()->format('Y-m-d H:i:s');

常见问题与性能优化技巧（FAQ）

Q1：为什么 BSON\toPHP() 返回的是 stdClass 而不是数组？ A：这是默认行为，为了安全，BSON 保留了对象嵌套语义，建议统一使用 ['root' => 'array', 'document' => 'array'] 强制转换为数组，避免 -> 和 混用导致 bug。

Q2：如何批量编码大量文档？ A：不要在一个循环中重复调用 BSON\fromPHP()，对于写入 MongoDB，直接使用 MongoDB\Driver\BulkWrite，它会内部处理 BSON 转换，且支持批量插入，性能提升显著。

Q3：BSON 能否直接存进 Redis？ A：可以，但语义不明确，若只做缓存，推荐用 JSON 或 IgBinary，因为 BSON 携带大量类型标记，体积膨胀约 10%，仅在跨语言或需要精确类型时使用 BSON。

性能优化建议：

• 避免在循环内重复 BSON\fromPHP()，最好一次性构造完整数组。
• 尽量使用索引字段存储 ObjectId 或 UTCDateTime，因为 BSON 的二进制比较比字符串快。
• 如果只是读取并输出 JSON，可以用 MongoDB\Driver\Cursor 的 setTypeMap(['root' => 'array']) 直接以数组形式获取，省去手动解码。

何时该直接用 BSON，何时用 JSON？

• 使用 BSON：当你需要操作 MongoDB 时，或者需要和 Node.js、Python 等共享二进制数据并保留类型时。
• 使用 JSON：作为 API 响应格式、前端交互或简单的缓存记忆体。

BSON 是 MongoDB 高效运行的基石，PHP 开发者掌握 BSON\fromPHP() 和 BSON\toPHP() 后，不仅能避免数据陷阱，还能深刻理解文档数据库的设计哲学，建议在本地环境中用 bin2hex() 输出 BSON 结构，观察每个字段的类型标记，你会有更直观的收获。

---

希望本文能成为你进入 MongoDB + PHP 世界的导航图，动手写几个示例，你会立刻感受到 BSON 带来的“类型安全感”。