使用PHP FirestoreClient发送自定义头部认证令牌的最佳实践

use Google\Cloud\Firestore\FirestoreClient;

/**
 * 初始化Cloud Firestore客户端。
 * @param string|null $projectId Google Cloud项目ID。
 */
function setupClientWithGlobalVariable(string $projectId = null)
{
    // 尝试通过设置$_SERVER["GOOGLE_APPLICATION_CREDENTIALS"]来指定密钥文件路径
    // 在某些安全配置下，这种方式可能导致权限问题
    $_SERVER["GOOGLE_APPLICATION_CREDENTIALS"] = "/path/to/your/service-account-key.json";

    if (empty($projectId)) {
        $db = new FirestoreClient();
        printf('使用默认项目ID创建Cloud Firestore客户端。' . PHP_EOL);
    } else {
        $db = new FirestoreClient([
            'projectId' => $projectId
        ]);
        printf('使用项目ID %s 创建Cloud Firestore客户端。' . PHP_EOL, $projectId);
    }
    // 尝试执行操作，例如：
    // $db->collection('messages')->document('some_id')->create(['message' => 'Hello']);
}

<?php

require 'vendor/autoload.php'; // 确保Composer自动加载器已引入

use Google\Cloud\Firestore\FirestoreClient;

/**
 * 初始化Cloud Firestore客户端，并使用keyFilePath进行服务账户认证。
 * @param string $projectId Google Cloud项目ID。
 * @param string $keyFilePath 服务账户密钥文件的绝对路径。
 * @return FirestoreClient 已认证的Firestore客户端实例。
 */
function setupClientWithKeyFilePath(string $projectId, string $keyFilePath): FirestoreClient
{
    // 在FirestoreClient构造函数中明确指定keyFilePath
    $db = new FirestoreClient([
        'projectId' => $projectId,
        'keyFilePath' => $keyFilePath, // 推荐的认证方式
    ]);
    printf('使用项目ID %s 和指定密钥文件路径创建Cloud Firestore客户端。' . PHP_EOL, $projectId);
    return $db;
}

// 示例用法：
$projectId = 'your-google-cloud-project-id'; // 替换为你的项目ID
$serviceAccountKeyPath = '/path/to/your/service-account-key.json'; // 替换为你的服务账户密钥文件路径

try {
    $firestore = setupClientWithKeyFilePath($projectId, $serviceAccountKeyPath);

    // 示例：插入一个文档
    $collectionRef = $firestore->collection('messages');
    $documentRef = $collectionRef->document('new_message_id_' . uniqid());
    $documentRef->set([
        'text' => '这是一条来自PHP客户端的消息',
        'timestamp' => new \DateTimeImmutable(),
    ]);
    printf('成功创建文档，ID: %s' . PHP_EOL, $documentRef->id());

    // 示例：获取一个文档
    $snapshot = $documentRef->snapshot();
    if ($snapshot->exists()) {
        printf('获取到文档内容: %s' . PHP_EOL, json_encode($snapshot->data()));
    }

} catch (\Exception $e) {
    fprintf(STDERR, '操作失败: %s' . PHP_EOL, $e->getMessage());
    if ($e instanceof \Google\Cloud\Core\Exception\ServiceException) {
        fprintf(STDERR, '错误详情: %s' . PHP_EOL, $e->getMessage());
    }
}