MongoDB\Driver\ReadPreference
PHP マニュアル

MongoDB\Driver\ReadPreference::bsonSerialize

Returns an object for BSON serialization

説明

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

パラメータ

この関数にはパラメータはありません。

戻り値

Returns an object for serializing the ReadPreference as BSON.

エラー / 例外

  • Throws MongoDB\Driver\Exception\InvalidArgumentException on argument parsing errors.

例

例1 MongoDB\Driver\ReadPreference::bsonSerialize with primary read preference

<?php

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

echo "\n", MongoDB\BSON\Document::fromPHP($rp)->toRelaxedExtendedJSON();

?>

上の例の出力は、 たとえば以下のようになります。

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

{ "mode" : "primary" }

例2 MongoDB\Driver\ReadPreference::bsonSerialize with secondary read preference and tag sets

<?php

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

echo "\n", MongoDB\BSON\Document::fromPHP($rp)->toRelaxedExtendedJSON();

?>

上の例の出力は、 たとえば以下のようになります。

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" }, {  } ] }

例3 MongoDB\Driver\ReadPreference::bsonSerialize with secondary read preference and max staleness

<?php

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

echo "\n", MongoDB\BSON\Document::fromPHP($rp)->toRelaxedExtendedJSON();

?>

上の例の出力は、 たとえば以下のようになります。

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

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

参考