cloudinary rest api 删除资源时，常见的失败原因在于认证签名生成不正确。核心在于，除特定参数外，所有请求参数（如 `public_id` 和 `invalidate`）必须按字母顺序排列并包含在签名字符串中，再与 `api_secret` 结合进行 sha1 哈希。本教程将详细指导如何正确生成签名，确保 cloudinary 资源销毁请求成功执行。
Cloudinary API 认证机制概述
Cloudinary 提供强大的媒体管理服务，其 REST API 允许开发者通过编程方式上传、转换和删除资源。为了确保请求的安全性，Cloudinary 对大多数 API 调用都要求进行身份验证，其中核心机制是生成一个认证签名。这个签名通过结合请求参数和您的 API 密钥（api_secret）生成，用于验证请求的合法性。
当您尝试使用 destroy API 删除图片或其他资源时，如果请求没有成功，一个非常常见的原因就是签名生成不正确。
签名生成的核心规则
Cloudinary 签名生成的关键在于以下几点：
参数范围： 除了 file、cloud_name、resource_type 和 api_key 这四个参数外，所有其他在请求中发送的参数都必须包含在签名字符串中。字母顺序： 签名字符串中的参数必须按照其参数名的字母顺序进行排列。连接方式： 参数之间使用 & 符号连接，形成 key=value 的格式。最终哈希： 将所有排序好的参数字符串与您的 api_secret 拼接在一起，然后进行 SHA1 哈希计算，得到最终的签名。
在 destroy API 的场景中，常见的请求参数包括 public_id、timestamp 和 invalidate。如果您的请求中包含了这些参数，它们就必须全部参与签名计算。
修正后的签名生成示例
考虑一个删除资源的请求，其中包含 public_id、timestamp 和 invalidate 参数。原始代码可能只对 timestamp 进行了签名，导致其他参数未被验证，从而使请求失败。
原始（错误）的签名生成方式：
$timestamp = time();$signature = sha1("timestamp=".$timestamp.$api_secret); // 错误：只包含了 timestamp
正确（修正后）的签名生成方式：
根据 Cloudinary 的规则，我们需要将 invalidate、public_id 和 timestamp 这三个参数按字母顺序排列并包含在签名字符串中。
$api_secret = "YOUR_API_SECRET"; // 请替换为您的 Cloudinary API Secret$timestamp = time();$public_id = "folder/sample_public_id"; // 待删除资源的 public_id$invalidate = true; // 是否从 CDN 缓存中删除// 按照参数名的字母顺序排列并组合参数// 注意：布尔值 true 在字符串中通常表示为 "true"$signature_string = "invalidate=" . ($invalidate ? "true" : "false") . "&public_id=" . $public_id . "×tamp=" . $timestamp;$signature = sha1($signature_string . $api_secret);
请注意，invalidate=true 在签名字符串中必须以 invalidate=true 的形式出现，而不是 invalidate=1 或其他形式，这取决于 Cloudinary 对布尔值的具体要求。
完整的 PHP cURL 请求示例
将修正后的签名生成逻辑整合到完整的 PHP cURL 请求中，示例如下：
($invalidate ? "true" : "false"), // 布尔值转换为字符串 'public_id' => $public_id, 'timestamp' => $timestamp];ksort($signature_params); // 确保参数按键名字母顺序排序$signature_string_parts = [];foreach ($signature_params as $key => $value) { $signature_string_parts[] = "{$key}={$value}";}$signature_string = implode("&", $signature_string_parts);// 2. 生成 SHA1 签名$signature = sha1($signature_string . $api_secret);// 3. 构建 POST 请求数据$postRequest = array( 'public_id' => $public_id, 'timestamp' => $timestamp, 'api_key' => $api_key, 'signature' => $signature, 'resource_type' => 'image', // 根据您要删除的资源类型设置，例如 'image', 'video', 'raw' 'invalidate' => $invalidate);// 4. 发送 cURL 请求$ch = curl_init();curl_setopt($ch, CURLOPT_URL, "https://api.cloudinary.com/v1_1/{$cloud_name}/image/destroy");curl_setopt($ch, CURLOPT_POST, 1);curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postRequest));curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 返回响应内容curl_setopt($ch, CURLOPT_FAILONERROR, false); // 不在 HTTP 错误时终止，以便检查响应体curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2); // 建议开启 SSL 验证curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true); // 建议开启 SSL 验证curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);curl_setopt($ch, CURLOPT_TIMEOUT, 30);// curl_setopt($ch, CURLOPT_VERBOSE, true); // 调试时可以开启，查看详细 cURL 过程$response = curl_exec($ch);$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);$curl_error = curl_error($ch);if ($curl_error) { echo "cURL 错误: " . $curl_error . "n";} else { echo "HTTP 状态码: " . $http_code . "n"; echo "Cloudinary 响应: " . $response . "n"; // 解析 JSON 响应 $responseData = json_decode($response, true); if ($responseData && isset($responseData['result']) && $responseData['result'] === 'ok') { echo "资源删除成功！n"; } elseif ($responseData && isset($responseData['error'])) { echo "删除失败: " . $responseData['error']['message'] . "n"; } else { echo "未知错误或非预期响应。n"; }}curl_close($ch);?>
重要提示：
请将 YOUR_CLOUD_NAME、YOUR_API_KEY 和 YOUR_API_SECRET 替换为您的实际 Cloudinary 账户信息。public_id 必须是您要删除的资源的准确公共 ID，包括任何文件夹路径。resource_type 应与您要删除的资源类型匹配（image、video 或 raw）。
注意事项与最佳实践
使用官方 SDK： 强烈建议使用 Cloudinary 官方提供的 SDK（如 PHP SDK、Node.js SDK、Python SDK 等）。这些 SDK 已经封装了复杂的签名生成逻辑，可以大大简化开发过程并减少出错的可能性。它们会自动处理参数排序和签名计算。安全管理 API Secret： 您的 api_secret 是敏感信息，绝不能暴露在客户端代码或公共可访问的存储库中。它应该始终在服务器端进行管理和使用。错误处理： 始终检查 API 调用的返回值和 HTTP 状态码。Cloudinary 会在响应中提供详细的错误信息，帮助您诊断问题。例如，HTTP 401 状态码通常表示认证失败。CDN 缓存失效： invalidate=true 参数会尝试从 Cloudinary 的 CDN 缓存中删除资源，这可能需要一些时间来完全生效。参数一致性： 确保用于生成签名的参数与实际发送到 Cloudinary API 的参数完全一致。任何不匹配都将导致签名验证失败。
总结
Cloudinary REST API 的删除操作失败，最常见的原因是认证签名生成不正确。解决此问题的关键在于理解 Cloudinary 签名机制：所有请求参数（除特定例外）必须按字母顺序排列并包含在签名字符串中，然后与 api_secret 一起进行 SHA1 哈希。通过严格遵循这一规则，您可以确保 API 请求得到正确认证，从而成功执行资源删除操作。在实际开发中，优先使用 Cloudinary 官方 SDK 是提高效率和避免错误的最佳实践。
以上就是解决 Cloudinary REST API 删除失败问题：正确生成认证签名的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1332639.html
微信扫一扫 
支付宝扫一扫 
