MongoDB\BSON\Unserializable::bsonUnserialize

(mongodb >=1.0.0)

MongoDB\BSON\Unserializable::bsonUnserialize — Construit l'objet à partir d'un tableau ou d'un document BSON

Description

abstract public MongoDB\BSON\Unserializable::bsonUnserialize(array $data): void

Appelé lors de la désérialisation de l'objet à partir de BSON. Les propriétés du tableau ou du document BSON seront transmises à la méthode sous la forme d'un tableau.

N'oubliez pas de rechercher une propriété _id lors de la gestion des données à partir d'un document BSON.

Note: Cette méthode agit comme le constructeur de l'objet. La méthode __construct() ne sera pas appelée après cette méthode.

Liste de paramètres

data (array): Propriétés ayant le tableau ou le document BSON.

Valeurs de retour

La valeur de retour de cette méthode est ignorée.

Historique

Version	Description
PECL mongodb 2.0.0	Les types de retour précédemment déclarés comme provisoires sont désormais appliqués.

Exemples

Exemple #1 Exemple avec MongoDB\BSON\Unserializable::bsonUnserialize()

<?php

class MyDocument implements MongoDB\BSON\Unserializable
{
    private $data = [];

    function bsonUnserialize(array $data): void
    {
        $this->data = $data;
    }
}

$bson = MongoDB\BSON\Document::fromJSON('{ "foo": "bar" }');

var_dump($bson->toPHP(['root' => 'MyDocument']));

?>

Résultat de l'exemple ci-dessus est similaire à :

object(MyDocument)#1 (1) {
  ["data":"MyDocument":private]=>
  array(1) {
    ["foo"]=>
    string(3) "bar"
  }
}

Voir aussi

MongoDB\BSON\Serializable::bsonSerialize() - Fournit un tableau ou un document à sérialiser en tant que BSON
MongoDB\BSON\Persistable
Persister des données