Firebase与PHP：如何按指定字段查询Firestore集合？

你之前写法的核心问题 #

出现「Uncaught Error: Call to undefined function」的原因是对Firestore PHP SDK的API逻辑完全误解：

• 错误写法1：把collection()返回的对象和字符串拼接，还将where当成普通函数调用（实际是Firestore查询对象的专属方法）
• 错误写法2：用SQL语句作为document()的参数，Firestore是NoSQL数据库，不支持SQL语法，document()仅接受文档ID
• 错误写法3：误用了Firebase Realtime Database的getReference API，Firestore与Realtime Database是独立服务，API不通用

正确的查询实现代码 #

以下是按client_name字段查询集合的标准写法，同时做了参数安全处理：

public function getServiceOrderByName(): array {
    // 安全获取并过滤查询参数，避免空值或恶意输入
    $clientName = isset($_GET["name"]) ? trim($_GET["name"]) : '';
    if (empty($clientName)) {
        return [];
    }

    // 构建Firestore查询：指定集合 + 字段匹配条件
    $query = $this->firestore->collection('material_detail')
        ->where('client_name', '=', $clientName); // 注意字段名必须和Firestore数据库中的完全一致

    // 执行查询并遍历结果
    $documents = $query->documents();
    $results = [];
    foreach ($documents as $doc) {
        if ($doc->exists()) {
            // 可选：将文档ID与数据合并返回，方便后续使用
            $results[] = array_merge(
                ['document_id' => $doc->id()],
                $doc->data()
            );
        }
    }

    return $results;
}

关键注意事项 #

1. 字段名严格匹配：确保client_name和Firestore集合中文档的实际字段名一致（比如你之前写的name_client、name_cliente，要核对数据库里的字段名称）
2. 支持多种操作符：除了=，还可使用<、>、>=、<=、array-contains等Firestore支持的操作符
3. 参数安全处理：永远不要直接使用未过滤的$_GET/$_POST参数，避免潜在风险
4. 多文档遍历：where查询可能返回多个匹配文档，需遍历documents()返回的快照集合，判断文档存在后再获取数据

内容的提问来源于stack exchange，提问作者user20749778