# MongoCollection::getDBRef

(PECL mongo >=0.9.0)

MongoCollection::getDBRef — Fetches the document pointed to by a database reference

### Description

public MongoCollection::getDBRef ( array `$ref` ) : array

### Parameters

`ref`

  A database reference.

### Return Values

Returns the database document pointed to by the reference.

### Examples

Example #1 MongoCollection::getDBRef() example

`<?php
$playlists = $db->playlists;
$myList = $playlists->findOne(array('username' => 'me'));
// fetch each song in the playlist
foreach ($myList['songlist'] as $songRef) {
$song = $playlists->getDBRef($songRef);
echo $song['title'] . "\n";
}
?>`

The above example will output something similar to:

    Dazed and Confused
    Ma na ma na
    Bohemian Rhapsody

In the above example each $songRef looks something like the following:

        Array
        (
            [$ref] => songs
            [$id] => 49902cde5162504500b45c2c
        )

### See Also

- MongoCollection::createDBRef() - Creates a database reference