Cloud Firestore Client - Class Transaction (1.53.0)

 use Google\Cloud\Firestore\FirestoreClient;
use Google\Cloud\Firestore\Transaction;

$firestore = new FirestoreClient();
$document = $firestore->document('users/john');
$firestore->runTransaction(function (Transaction $transaction) use ($document) {
    // Manage Transaction.
}); 

 $snapshot = $transaction->snapshot($document); 

 $snapshot = $transaction->runAggregateQuery($aggregateQuery); 

 $results = $transaction->runQuery($query); 

 $transaction->create($document, [
    'name' => 'John',
    'country' => 'USA'
]); 

 // In this example, all field not explicitly specified will be removed.
$transaction->set($document, [
    'name' => 'Johnny'
]); 

 // To specify MERGE over REPLACE, set `$options.merge` to `true`.
$transaction->set($document, [
    'name' => 'Johnny'
], [
    'merge' => true
]); 

 $transaction->update($document, [
    ['path' => 'name', 'value' => 'John'],
    ['path' => 'country', 'value' => 'USA'],
    ['path' => 'cryptoCurrencies.bitcoin', 'value' => 0.5],
    ['path' => 'cryptoCurrencies.ethereum', 'value' => 10],
    ['path' => 'cryptoCurrencies.litecoin', 'value' => 5.51]
]); 

 // Google Cloud PHP provides special field values to enable operations such
// as deleting fields or setting the value to the current server timestamp.
use Google\Cloud\Firestore\FieldValue;

$transaction->update($document, [
    ['path' => 'country', 'value' => FieldValue::deleteField()],
    ['path' => 'lastLogin', 'value' => FieldValue::serverTimestamp()]
]); 

 // If your field names contain special characters (such as `.`, or symbols),
// using <xref uid="\Google\Cloud\Firestore\FieldPath">FieldPath</xref> will properly escape each element.

use Google\Cloud\Firestore\FieldPath;

$transaction->update($document, [
    ['path' => new FieldPath(['cryptoCurrencies', 'big$$$coin']), 'value' => 5.51]
]); 

 $transaction->delete($document);