FirestoreClient PHP 库中服务账户认证与权限配置指南

use Google\Cloud\Firestore\FirestoreClient;

// ...
$id = 123;
$data = ['message' => 123];

$db = new FirestoreClient([
    'projectId' => 'myProject' // 假设这里没有正确配置认证
]);

try {
    $db->collection('messages')->document($id)->create($data);
} catch (\Google\Cloud\Core\Exception\ServiceException $e) {
    // 收到错误: { "message": "Missing or insufficient permissions.", "code": 7, "status": "PERMISSION_DENIED" }
    echo "操作失败: " . $e->getMessage() . PHP_EOL;
}

use Google\Cloud\Firestore\FirestoreClient;

/**
 * 初始化 Cloud Firestore 客户端并尝试创建文档。
 * 
 * @param string|null $projectId 项目ID。
 */
function setupClientAndCreateDocumentWithEnvVar(string $projectId = null)
{
    // 设置环境变量，指向服务账户密钥文件路径
    // 注意：在某些环境中，直接设置 $_SERVER 变量可能无效或不推荐。
    // 更好的做法是在系统级别设置环境变量，或通过 .env 文件加载。
    $_SERVER["GOOGLE_APPLICATION_CREDENTIALS"] = "/path/to/your/keyfile.json";

    // 创建 Cloud Firestore 客户端
    // 如果环境变量设置正确，客户端会自动加载凭据
    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);
    }

    // 尝试执行 Firestore 操作
    try {
        $db->collection('messages')->document('doc_env')->set(['message' => 'Hello from env var!']);
        echo "文档 'doc_env' 创建成功！" . PHP_EOL;
    } catch (\Google\Cloud\Core\Exception\ServiceException $e) {
        echo "文档 'doc_env' 创建失败: " . $e->getMessage() . PHP_EOL;
    }
}

// 调用示例
// setupClientAndCreateDocumentWithEnvVar('your-project-id');

use Google\Cloud\Firestore\FirestoreClient;

/**
 * 初始化 Cloud Firestore 客户端并尝试创建文档。
 * 
 * @param string $projectId 项目ID。
 */
function setupClientAndCreateDocumentWithKeyFile(string $projectId)
{
    // 创建 Cloud Firestore 客户端
    // 在构造函数的配置数组中显式指定 keyFilePath
    $db = new FirestoreClient([
        'projectId' => $projectId,
        'keyFilePath' => '/path/to/your/keyfile.json', // 替换为您的服务账户密钥文件路径
    ]);
    printf('使用项目ID %s 和显式密钥文件创建 Cloud Firestore 客户端。' . PHP_EOL, $projectId);

    // 尝试执行 Firestore 操作
    try {
        $db->collection('messages')->document('doc_explicit')->set(['message' => 'Hello from explicit key file!']);
        echo "文档 'doc_explicit' 创建成功！" . PHP_EOL;
    } catch (\Google\Cloud\Core\Exception\ServiceException $e) {
        echo "文档 'doc_explicit' 创建失败: " . $e->getMessage() . PHP_EOL;
    }
}

// 调用示例
// setupClientAndCreateDocumentWithKeyFile('your-project-id');