PHP 8.1.15 Released!

MongoDB\Driver\ReadPreference::bsonSerialize

(mongodb >=1.2.0)

MongoDB\Driver\ReadPreference::bsonSerializeReturns an object for BSON serialization

Description

final public MongoDB\Driver\ReadPreference::bsonSerialize(): object

Parameters

This function has no parameters.

Return Values

Returns an object for serializing the ReadPreference as BSON.

Errors/Exceptions

Examples

Example #1 MongoDB\Driver\ReadPreference::bsonSerialize() with primary read preference

<?php

$rp
= new MongoDB\Driver\ReadPreference(MongoDB\Driver\ReadPreference::RP_PRIMARY);
var_dump($rp->bsonSerialize());

echo
"\n", MongoDB\BSON\toJSON(MongoDB\BSON\fromPHP($rp));

?>

The above example will output something similar to:

object(stdClass)#2 (1) {
  ["mode"]=>
  string(7) "primary"
}

{ "mode" : "primary" }

Example #2 MongoDB\Driver\ReadPreference::bsonSerialize() with secondary read preference and tag sets

<?php

$rp
= new MongoDB\Driver\ReadPreference(
MongoDB\Driver\ReadPreference::RP_SECONDARY,
[
[
'dc' => 'ny'],
[
'dc' => 'sf', 'use' => 'reporting'],
[]
]
);
var_dump($rp->bsonSerialize());

echo
"\n", MongoDB\BSON\toJSON(MongoDB\BSON\fromPHP($rp));

?>

The above example will output something similar to:

object(stdClass)#2 (2) {
  ["mode"]=>
  string(9) "secondary"
  ["tags"]=>
  array(3) {
    [0]=>
    object(stdClass)#1 (1) {
      ["dc"]=>
      string(2) "ny"
    }
    [1]=>
    object(stdClass)#5 (2) {
      ["dc"]=>
      string(2) "sf"
      ["use"]=>
      string(9) "reporting"
    }
    [2]=>
    object(stdClass)#4 (0) {
    }
  }
}

{ "mode" : "secondary", "tags" : [ { "dc" : "ny" }, { "dc" : "sf", "use" : "reporting" }, {  } ] }

Example #3 MongoDB\Driver\ReadPreference::bsonSerialize() with secondary read preference and max staleness

<?php

$rp
= new MongoDB\Driver\ReadPreference(
MongoDB\Driver\ReadPreference::RP_SECONDARY,
null,
[
'maxStalenessSeconds' => 120]
);
var_dump($rp->bsonSerialize());

echo
"\n", MongoDB\BSON\toJSON(MongoDB\BSON\fromPHP($rp));

?>

The above example will output something similar to:

object(stdClass)#2 (2) {
  ["mode"]=>
  string(9) "secondary"
  ["maxStalenessSeconds"]=>
  int(120)
}

{ "mode" : "secondary", "maxStalenessSeconds" : 120 }

See Also

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top