MongoDB\BSON\Serializable::bsonSerialize
(mongodb >=1.0.0)
MongoDB\BSON\Serializable::bsonSerialize — Fournit un tableau ou un document à sérialiser en tant que BSON
Description
Les documents racine (par exemple, un
MongoDB\BSON\Serializable passé à
MongoDB\BSON\Document::fromPHP()) seront toujours sérialisés en tant
que document BSON. Pour les valeurs de champ, les tableaux associatifs et les
instances stdClass seront sérialisés en tant que
document BSON et les tableaux séquentiels (c'est-à-dire les index numériques
séquentiels commençant à 0
) seront sérialisés en tant que
tableau BSON.
Les utilisateurs sont encouragés à inclure une propriété _id
(par exemple un MongoDB\BSON\ObjectId initialisé dans le constructeur)
lors du retour des données pour un document racine BSON. En l'absence d'une
propriété _id, l'extension ou le serveur générera un
MongoDB\BSON\ObjectId pour les opérations d'insertion ou
de mise à jour, respectivement.
Liste de paramètres
Cette fonction ne contient aucun paramètre.
Exemples
Exemple #1 MongoDB\BSON\Serializable::bsonSerialize() renvoyant un tableau associatif pour le document racine
<?php
class MyDocument implements MongoDB\BSON\Serializable
{
private $id;
function __construct()
{
$this->id = new MongoDB\BSON\ObjectId;
}
function bsonSerialize(): array
{
return ['_id' => $this->id, 'foo' => 'bar'];
}
}
echo MongoDB\BSON\Document::fromPHP(new MyDocument)->toRelaxedExtendedJSON(), "\n";
?>
Résultat de l'exemple ci-dessus est similaire à :
{ "_id" : { "$oid" : "56cccdcada14d8755a58c591" }, "foo" : "bar" }
Exemple #2 MongoDB\BSON\Serializable::bsonSerialize() renvoyant un tableau séquentiel pour le document racine
<?php
class MyArray implements MongoDB\BSON\Serializable
{
function bsonSerialize(): array
{
return [1, 2, 3];
}
}
echo MongoDB\BSON\Document::fromPHP(new MyArray)->toRelaxedExtendedJSON(), "\n";
?>
L'exemple ci-dessus va afficher :
{ "0" : 1, "1" : 2, "2" : 3 }
Exemple #3 MongoDB\BSON\Serializable::bsonSerialize() renvoyant un tableau associatif pour le champ de document
<?php
class MyDocument implements MongoDB\BSON\Serializable
{
function bsonSerialize(): array
{
return ['foo' => 'bar'];
}
}
$value = ['document' => new MyDocument];
echo MongoDB\BSON\Document::fromPHP($value)->toRelaxedExtendedJSON(), "\n";
?>
L'exemple ci-dessus va afficher :
{ "document" : { "foo" : "bar" } }
Exemple #4 MongoDB\BSON\Serializable::bsonSerialize() renvoyant un tableau séquentiel pour le champ de document
<?php
class MyArray implements MongoDB\BSON\Serializable
{
function bsonSerialize(): array
{
return [1, 2, 3];
}
}
$value = ['array' => new MyArray];
$bson = MongoDB\BSON\fromPHP($value);
echo MongoDB\BSON\toJSON($bson), "\n";
?>
L'exemple ci-dessus va afficher :
{ "array" : [ 1, 2, 3 ] }