Cloud Firestore Client - Class QuerySnapshot (1.51.0)

Reference documentation and code samples for the Cloud Firestore Client class QuerySnapshot.

Represents the result set of a Cloud Firestore Query.

Example:

use Google\Cloud\Firestore\FirestoreClient;

$firestore = new FirestoreClient();
$collection = $firestore->collection('users');
$query = $collection->where('age', '>', 18);

$snapshot = $query->documents();
// Snapshots can be iterated with foreach:
foreach ($snapshot as $user) {
    echo $user['name'] . PHP_EOL;
}

Namespace

Google \ Cloud \ Firestore

Methods

__construct

Parameters
Name Description
query Query

The Query which generated this snapshot.

rows array<DocumentSnapshot>

The query result rows.

explainMetrics null|V1\ExplainMetrics

isEmpty

Check if the result is empty.

Example:

$empty = $snapshot->isEmpty();
Returns
Type Description
bool|null

size

Returns the size of the result set.

Example:

$size = $snapshot->size();
Returns
Type Description
int|null

rows

Return the formatted and decoded rows. If the stream is interrupted, attempts will be made on your behalf to resume.

Example:

$rows = $snapshot->rows();
Returns
Type Description
array<DocumentSnapshot>

getExplainMetrics

Gets ExplainMetrics when the explainOptions option is supplied.

If ExplainOptions::setAnalyze is set to false, the query is planned and not executed, returning only the V1\PlanSummary instead of the V1\ExecutionStats and result.

Returns
Type Description
null|V1\ExplainMetrics

getIterator

Returns
Type Description
ArrayIterator