MongoDB\ChangeStream::key()

Definición

MongoDB\ChangeStream::key()

Devuelve el índice del evento actual en el flujo de cambios.

function key(): integer|null

El índice del primer evento en un flujo de cambio comienza en cero y se incrementará en uno para cada evento posterior.

Return Values

El índice del evento actual en el flujo de cambios, o null si no hay ningún evento actual (es decir, MongoDB\ChangeStream::valid() falsedevuelve).

Ejemplos

Este ejemplo informa el índice de eventos mientras se itera un flujo de cambios.

<?php
$uri = 'mongodb://rs1.example.com,rs2.example.com/?replicaSet=myReplicaSet';
$collection = (new MongoDB\Client($uri))->test->inventory;
$changeStream = $collection->watch();
for ($changeStream->rewind(); true; $changeStream->next()) {
    if ( ! $changeStream->valid()) {
        continue;
    }
    $event = $changeStream->current();
    printf("%d: %s\n", $changeStream->key(), $event['operationType']);
}

Suponiendo que se insertó, actualizó y eliminó un documento mientras el script anterior iteraba el flujo de cambios, el resultado sería similar a lo siguiente:

0: insert
1: update
2: delete

Ver también

• MongoDB\Client::watch()

• MongoDB\Collection::watch()

• MongoDB\Database::watch()

• Iterator::key()

• Iteración de cursor adaptable

• Documentación de flujos de cambios en el manual de MongoDB