(mongodb >=1.0.0)
MongoDB\Driver\Cursor::getId — Возвращает идентификатор текущего курсора
Метод возвращает идентификатор текущего курсора. На сервере каждому курсору присваивается уникальный идентификатор.
У этой функции нет параметров.
Метод возвращает идентификатор текущего курсора. Метод вернёт идентификатор как объект MongoDB\BSON\Int64.
| Версия | Описание |
|---|---|
| PECL-модуль mongodb 2.0.0 |
Тип значения возврата изменили на MongoDB\BSON\Int64.
Параметр asInt64 удалили.
|
| PECL-модуль mongodb 1.20.0 |
Возврат объекта MongoDB\Driver\CursorId устарел.
Добавили параметр asInt64, чтобы упростить переход
на будущие версии. Идентификатор вернётся как объект MongoDB\BSON\Int64,
если для параметра asInt64 установили значение true.
|
Пример #1 Пример получения идентификатора курсора методом MongoDB\Driver\Cursor::getId()
<?php
/** Пример добавляет набор документов в коллекцию и указывает
* меньший batchSize, чтобы гарантировать, что первый пакет содержит только
* подмножество результатов, а курсор остаётся открытым на сервере
*/
$manager = new MongoDB\Driver\Manager("mongodb://localhost:27017");
$query = new MongoDB\Driver\Query([], ['batchSize' => 2]);
$bulk = new MongoDB\Driver\BulkWrite();
$bulk->insert(['x' => 1]);
$bulk->insert(['x' => 2]);
$bulk->insert(['x' => 3]);
$manager->executeBulkWrite('db.collection', $bulk);
$cursor = $manager->executeQuery('db.collection', $query);
var_dump($cursor->getId(true));
?>Вывод приведённого примера будет похож на:
object(MongoDB\BSON\Int64)#5 (1) {
["integer"]=>
string(11) "94810124093"
}