
cloudinary rest api 删除资源时,常见的失败原因在于认证签名生成不正确。核心在于,除特定参数外,所有请求参数(如 `public_id` 和 `invalidate`)必须按字母顺序排列并包含在签名字符串中,再与 `api_secret` 结合进行 sha1 哈希。本教程将详细指导如何正确生成签名,确保 cloudinary 资源销毁请求成功执行。
Cloudinary 提供强大的媒体管理服务,其 REST API 允许开发者通过编程方式上传、转换和删除资源。为了确保请求的安全性,Cloudinary 对大多数 API 调用都要求进行身份验证,其中核心机制是生成一个认证签名。这个签名通过结合请求参数和您的 API 密钥(api_secret)生成,用于验证请求的合法性。
当您尝试使用 destroy API 删除图片或其他资源时,如果请求没有成功,一个非常常见的原因就是签名生成不正确。
Cloudinary 签名生成的关键在于以下几点:
在 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
// 您的 Cloudinary 凭据
$cloud_name = "YOUR_CLOUD_NAME"; // 替换为您的 Cloudinary Cloud Name
$api_key = "YOUR_API_KEY"; // 替换为您的 Cloudinary API Key
$api_secret = "YOUR_API_SECRET"; // 替换为您的 Cloudinary API Secret
// 请求参数
$public_id = "folder/sample_public_id"; // 待删除资源的 public_id
$timestamp = time();
$invalidate = true; // 是否从 CDN 缓存中删除
// 1. 构建签名字符串:按照参数名的字母顺序排列并组合
// 参数包括:invalidate, public_id, timestamp
$signature_params = [
'invalidate' => ($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);
?>重要提示:
Cloudinary REST API 的删除操作失败,最常见的原因是认证签名生成不正确。解决此问题的关键在于理解 Cloudinary 签名机制:所有请求参数(除特定例外)必须按字母顺序排列并包含在签名字符串中,然后与 api_secret 一起进行 SHA1 哈希。通过严格遵循这一规则,您可以确保 API 请求得到正确认证,从而成功执行资源删除操作。在实际开发中,优先使用 Cloudinary 官方 SDK 是提高效率和避免错误的最佳实践。
以上就是解决 Cloudinary REST API 删除失败问题:正确生成认证签名的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号