简介
cffps（全称为 Cloud Firestore for PHP）是一个用于使用 PHP 与 Google Cloud Firestore 数据库交互的 PHP 库。它提供了一个简单易用的 API，可用于读写和查询文档、集合和事务。
多级标题
安装和使用
要安装 cffps 库，请使用 Composer：``` composer require google/cloud-firestore ```然后，您可以使用以下代码初始化 Firestore 客户端：```php use Google\Cloud\Firestore\FirestoreClient;$db = new FirestoreClient(); ```
操作文档和集合
您可以使用 `document()` 和 `collection()` 方法来获取对文档和集合的引用。要保存文档，请使用 `set()` 方法：```php $db->collection('users')->document('alovelace')->set(['name' => 'Ada Lovelace','born' => 1815 ]); ```要获取文档，请使用 `get()` 方法：```php $doc = $db->collection('users')->document('alovelace')->get(); ```
查询
cffps 提供了一个强大的查询 API，可用于过滤和排序结果。例如，以下查询将返回所有名为“Ada”的用户：```php $query = $db->collection('users')->where('name', '=', 'Ada'); ```
事务
cffps 支持事务，这使您可以以原子方式执行读取和写入操作。要开始事务，请使用 `runTransaction()` 方法：```php $db->runTransaction(function (Transaction $transaction) {// 读取文档$doc = $transaction->document('users/alovelace');// 更新文档$transaction->update($doc, ['age' => $doc['age'] + 1]); }); ```
监听器
cffps 提供了用于在文档或集合进行更改时接收实时更新的监听器。要创建监听器，请使用 `listen()` 方法：```php $listener = $db->collection('users')->listen(function (DocumentSnapshot $snapshot) {// 处理快照 }); ```
其他功能
除了上述功能外，cffps 还提供以下功能：
批处理操作
：允许您一次执行多个操作。
游标
：允许您分批迭代查询结果。
索引
：允许您创建索引以提高查询性能。
安全性规则
：允许您控制对数据的访问。