データベースへの参照を作成する

# 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)));
?>`

### 参考

- MongoCollection::getDBRef() - データベース参照が指すドキュメントを取得する