MongoDB::createDBRef

(PECL mongo >=0.9.0)

MongoDB::createDBRefCrée une référence de base de données

Description

public MongoDB::createDBRef ( string $collection , mixed $document_or_id ) : array

Cette méthode est une interface flexible pour créer des références à des bases de données (voir la classe MongoDBRef).

Liste de paramètres

collection

La collection vers laquelle la référence de base de données va pointer.

document_or_id

Si un tableau ou un objet est fourni, son champ _id sera utilisé comme identifiant de référence. Si un MongoId ou un scalaire est fourni, il sera utilisé comme identifiant de référence.

Valeurs de retour

Retourne la tableau de référence de la base de données.

Si un tableau sans champ _id a été fourni comme paramètre document_or_id, NULL sera retourné.

Exemples

Exemple #1 Exemple pour MongoDB::createDBRef()

Cet exemple montre comment créer un tableau de référence de base de données à partir d'un document.

<?php

$articles 
$db->articles;

$article = array(
 
'title' => 'Test article',
 
'description' => 'Test article description'
);

$articles->insert($article);
$ref $db->createDBRef('articles'$article);

print_r($article);
print_r($ref);
?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

     Array
     (
         [title] => Test article
         [description] => Test article description
         [_id] => MongoId Object
             (
             )

     )
     Array
     (
         [$ref] => articles
         [$id] => MongoId Object
             (
             )

     )
     

Maintenant $ref peut être stocké sur un autre document et récupéré plus tard avec MongoDB::getDBRef() ou MongoCollection::getDBRef().

Exemple #2 Exemple pour MongoDB::createDBRef()

Exemple montrant comment créer une référence de base de données depuis un simple id.

<?php

$id 
= new MongoId('47cc67093475061e3d9536d2');
$ref $db->createDBRef('articles'$id);
?>