MongoDB\BSON\fromPHP

Returns the BSON representation of a PHP value

Warning

This function has been DEPRECATED as of extension version 1.20.0 and will be removed in 2.0. Applications should use MongoDB\BSON\Document::fromPHP instead.

Description

string MongoDB\BSON\fromPHP(arrayobject $value)

Serializes a PHP array or object (e.g. document) to its » BSON representation. The returned binary string will describe a BSON document.

Parameters

value (arrayobject)

PHP value to be serialized.

Return Values

The serialized BSON document as a binary string.

Errors/Exceptions

  • Throws MongoDB\Driver\Exception\UnexpectedValueException if the PHP value cannot be converted to BSON. Possible reasons include, but are not limited to, encountering an unexpected MongoDB\BSON\Type instance or MongoDB\BSON\Serializable::bsonSerialize failing to return an array or stdClass.

Examples

Example #1 MongoDB\BSON\fromPHP example

<?php

$bson = MongoDB\BSON\fromPHP(['foo' => 1]);
echo bin2hex($bson), "\n";

?>

The above example will output:

0e00000010666f6f000100000000cat

See Also