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