能否使用PHP连接Azure Cosmos DB？求相关实现方案与技术建议

嘿，没问题！PHP完全可以连接Azure Cosmos DB，我之前做过类似的项目，给你梳理下可行的方案和最佳实践，刚好适配你用Unity生成JSON数据的场景：

一、核心结论：完全支持PHP连接 #

Azure Cosmos DB虽然没有官方发布的PHP SDK，但咱们可以通过两种主流方式实现连接与数据操作：直接调用Cosmos DB的REST API（灵活无依赖），或者使用社区维护的第三方PHP库（更省心），这两种方式都能完美兼容你从Unity生成的JSON数据。

二、具体实现方法 #

1. 直接调用REST API（最灵活，无额外依赖） #

Cosmos DB的所有操作都可以通过REST API完成，PHP可以用curl或者guzzle这类HTTP客户端来发送请求。这里给个简单的插入JSON文档示例，你可以直接套用到自己的场景：

首先你需要从Azure门户获取几个关键配置：

• Cosmos DB账户的终结点URL
• 你的主键（或只读密钥，根据操作权限选择）
• 目标数据库ID和容器ID

示例代码（用curl实现插入文档）：

<?php
// 替换为你的Cosmos DB配置
$endpoint = "https://your-cosmos-account.documents.azure.com:443/";
$primaryKey = "your-primary-key-here";
$databaseId = "your-db-id";
$containerId = "your-container-id";
$documentId = "unique-doc-id-123";

// 直接使用Unity生成的JSON数据即可，这里模拟示例
$document = json_encode([
    "id" => $documentId,
    "unityData" => "从Unity传入的JSON内容",
    "timestamp" => time()
]);

// 构建请求URL
$url = $endpoint . "dbs/" . $databaseId . "/colls/" . $containerId . "/docs";

// 生成Cosmos DB要求的授权令牌
$date = gmdate("D, d M Y H:i:s T");
$resourceType = "docs";
$resourceLink = "dbs/" . $databaseId . "/colls/" . $containerId;
$key = base64_decode($primaryKey);
$signatureString = "POST\n" . $resourceType . "\n" . $resourceLink . "\n" . $date . "\n" . "" . "\n";
$signature = base64_encode(hash_hmac("sha256", $signatureString, $key, true));
$authHeader = "type=master&ver=1.0&sig=" . rawurlencode($signature);

// 配置curl请求
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $document);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: " . $authHeader,
    "x-ms-date: " . $date,
    "x-ms-version: 2021-05-15", // 使用较新的API版本
    "x-ms-documentdb-is-upsert: true" // 开启upsert，存在则覆盖
]);

// 执行请求并处理响应
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode >= 200 && $httpCode < 300) {
    echo "文档插入成功！响应：" . $response;
} else {
    echo "请求失败！状态码：" . $httpCode . "，响应：" . $response;
}
?>

2. 使用社区维护的PHP库（更便捷，减少重复代码） #

社区有几个成熟的PHP库封装了Cosmos DB的REST API，比如azure/cosmos（注意是社区维护包，非官方），可以通过Composer快速安装：

composer require azure/cosmos

示例代码（插入文档）：

<?php
require 'vendor/autoload.php';

use Azure\Cosmos\CosmosClient;

// 初始化客户端
$client = new CosmosClient([
    'endpoint' => 'https://your-cosmos-account.documents.azure.com:443/',
    'key' => 'your-primary-key-here'
]);

// 获取目标数据库和容器
$database = $client->getDatabase('your-db-id');
$container = $database->getContainer('your-container-id');

// 插入Unity生成的JSON数据（直接传入数组或JSON字符串均可）
$document = [
    'id' => 'unique-doc-id-456',
    'unityPayload' => '从Unity解析的JSON内容',
    // 其他自定义字段
];

$response = $container->createItem($document);

if ($response->getStatusCode() === 201) {
    echo "文档创建成功！";
}
?>

注意：社区库可能存在版本兼容问题，建议优先选择维护活跃的包，并查看README确认支持的Cosmos DB API版本。

三、最佳数据访问建议 #

结合你用Unity生成JSON的场景，给你几个优化建议：

• API类型选择：因为你用的是JSON数据，推荐使用Cosmos DB的SQL API（默认类型），它原生支持JSON文档，和PHP的JSON处理兼容性最好。
• 批量操作优化：如果Unity会生成大量JSON数据，建议在PHP中做批量插入，减少HTTP请求次数。可以通过REST API的Batch端点，或者社区库的批量方法实现。
• 安全配置：绝对不要在PHP代码中硬编码主键！建议用环境变量存储敏感信息，比如getenv('COSMOS_PRIMARY_KEY')，提升项目安全性。
• 索引策略调整：根据你的查询需求，在Cosmos DB容器中配置合适的索引，避免全表扫描，大幅提升查询性能。

四、常见问题注意事项 #

• API版本：确保使用的REST API版本是较新的（比如2021-05-15及以上），旧版本可能不支持某些新特性。
• 认证签名：手动调用REST API时，签名生成容易出错，要注意resourceType和resourceLink的格式，以及HTTP方法的大小写（比如POST必须大写）。
• 错误处理：Cosmos DB会返回详细的错误信息，建议在PHP中捕获并处理这些错误，比如409冲突（文档已存在）、401未授权等。

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