MongoDB\BSON\Document::fromPHP()函数—用法及示例

函数名：MongoDB\BSON\Document::fromPHP()

适用版本：MongoDB extension 1.2.0+

用法：MongoDB\BSON\Document::fromPHP()函数用于将PHP数组转换为MongoDB\BSON\Document对象。

语法：

public static MongoDB\BSON\Document MongoDB\BSON\Document::fromPHP(
    array|object $data,
    array $options = []
): MongoDB\BSON\Document

参数：

• $data：要转换为Document的PHP数组或对象。
• $options（可选）：一个关联数组，用于指定转换选项。

返回值：返回一个MongoDB\BSON\Document对象，表示转换后的数据。

示例：

<?php

// 定义一个PHP数组
$data = [
    'name' => 'John Doe',
    'age' => 25,
    'email' => 'johndoe@example.com'
];

// 将PHP数组转换为MongoDB\BSON\Document对象
$document = MongoDB\BSON\Document::fromPHP($data);

// 打印转换后的Document对象
var_dump($document);

输出：

object(MongoDB\BSON\Document)#1 (3) {
  ["name"]=>
  string(8) "John Doe"
  ["age"]=>
  int(25)
  ["email"]=>
  string(19) "johndoe@example.com"
}

注意事项：

• 如果传递的参数是一个PHP对象而不是数组，该函数会自动将其转换为关联数组。
• 可以通过$options参数传递选项来控制转换的行为，例如指定文档的类名、是否保留键的顺序等。具体选项请参考官方文档。

这是MongoDB extension中的一个函数，它用于将PHP数组转换为MongoDB\BSON\Document对象，方便在MongoDB数据库中存储和操作数据。