Cloud Firestore Client - Class QuerySnapshot (1.54.4)

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