MongoCollection::createDBRef

(PECL mongo >=0.9.0)

MongoCollection::createDBRef — データベースへの参照を作成する

説明

public MongoCollection::createDBRef ( mixed $document_or_id ) : array

パラメータ

document_or_id

配列あるいはオブジェクトを渡した場合は、その _id フィールドを参照 ID として利用します。 MongoId あるいはスカラーを渡した場合は、 それ自体を参照 ID として利用します。

返り値

データベース参照配列を返します。

_id フィールドがない配列を document_or_id に渡した場合は、NULL を返します。

例

例1 MongoCollection::createDBRef() の例

<?php

$songs = $db->songs;
$playlists = $db->playlists;

// 曲への参照を作成します
$manamana = $songs->findOne(array('title' => 'Ma na ma na'));
$refToSong = $songs->createDBRef($manamana);

// プレイリストへの参照を追加します
$playlists->update(array('username' => 'me'), array('$push' => array('songlist' => $refToSong)));

?>

参考