MongoDB::createDBRef

(PECL mongo >=0.9.0)

MongoDB::createDBRef — Создает ссылку на базу данных

Описание

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

Этот метод является гибким интерфейсом для создания ссылок на базу данных (смотрите MongoDBRef).

Список параметров

collection

Коллекция, на которую будет указывать ссылка на базу данных.

document_or_id

Если указан массив или объект, его поле _id будет использоваться в качестве идентификатора ссылки. Если указан MongoId или скаляр, он будет использоваться в качестве ссылочного идентификатора.

Возвращаемые значения

Возвращает массив ссылок на базу данных.

Если в качестве параметра document_or_id был указан массив без поля _id, будет возвращено значение NULL.

Примеры

Пример #1 Пример использования MongoDB::createDBRef()

Пример, демонстрирующий, как программно создать массив ссылок на базу данных из документа.

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

Результатом выполнения данного примера будет что-то подобное:

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

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

     )

Теперь $ref может быть сохранен в другом документе и получен позже с помощью MongoDB::getDBRef() или MongoCollection::getDBRef().

Пример #2 Пример использования MongoDB::createDBRef()

Пример, демонстрирующий, как программно создать ссылку на базу данных только из идентификатора.

<?php

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