MongoDB::createDBRef
(PECL mongo >=0.9.0)
MongoDB::createDBRef — Crée une référence de base de données
Description
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);
?>