PHP SDK无法直接读取又拍云文件内容，需拼公开URL或调signUrl()生成签名URL后，用curl/file_get_contents()拉取；路径含中文须rawurlencode()，且注意超时与重试配置。
PHP怎么用SDK读取又拍云文件
又拍云官方 PHP SDK（upyun/sdk）默认只支持上传、删除、获取文件信息等基础操作，**不直接提供“读取文件内容”的封装方法**。你不能像 file_get_contents() 那样直接拿到远程文件的字符串，必须手动发起 HTTP GET 请求并处理响应。
常见错误是调用 $client->getInfo() 以为能返回内容——它只返回元数据（如大小、时间），不是文件体。
- 正确做法：拼出公开 URL（如
https://bucket.b0.upaiyun.com/path/to/file.txt），用curl或file_get_contents()（需开启allow_url_fopen）拉取 - 若文件私有，必须生成带签名的临时 URL：调用
$client->signUrl()，传入路径和过期时间（单位秒），再用该 URL 发起请求 - 注意响应头中的
Content-Type和编码，尤其是读取 JSON 或 XML 时，别漏掉json_decode($body, true)这步
PHP写入又拍云失败的典型原因
上传失败多数不是代码逻辑错，而是权限或配置没对上。最常踩的坑是：用错了存储类型（表单上传 vs. API 上传）、没设好回调或签名失效。
- 确认 Bucket 权限：控制台里检查「API 访问」是否开启，且操作员账号有
write权限（不是只读） - 上传路径不能以
/开头：$client->put('/a.txt', $content)会报400 Bad Request，应写成$client->put('a.txt', $content) - 大文件（>10MB）建议用分片上传（
$client->uploadFile()支持自动分片），别硬扛；小文件用put()更快 - 如果用表单上传（
UpYunFormUploader），policy和signature必须由服务端生成，前端 JS 不能自己算——否则签名校验失败，返回401 Unauthorized
又拍云 PHP SDK 的 timeout 和 retry 怎么调
默认超时只有 30 秒，公网波动或文件稍大就容易触发 cURL error 28: Operation timed out。SDK 不暴露底层 cURL 句柄，必须通过构造参数改。
立即学习“PHP免费学习笔记（深入）”；
- 初始化客户端时传入
timeout和connect_timeout（单位秒）：$client = new UpYunClient($bucket, $username, $password, [ 'timeout' => 60, 'connect_timeout' => 10, ]); - 重试机制 SDK 没内置，得自己包一层：捕获
UpYunException，检查$e->getCode()是否为0（网络错误）或503（服务忙），再循环重试 2–3 次 - 别盲目加长 timeout：超过 120 秒可能触发又拍云网关主动断连，实际有效上限建议 90 秒内
PHP读写又拍云时怎么处理中文路径和文件名
又拍云后端对路径做 UTF-8 编码处理，但 PHP SDK 默认不帮你 encode，直接传中文字符串大概率 404 或乱码。
- 所有路径参数（
put()、getInfo()、delete()的第一个参数）都必须先rawurlencode()，例如：rawurlencode('测试/文件.txt')→%E6%B5%8B%E8%AF%95/%E6%96%87%E4%BB%B6.txt - 别用
urlencode()：它把/编成%2F，又拍云会当成普通字符而非路径分隔符，导致找不到资源 - 从又拍云回调或目录列表返回的文件名是已解码的 UTF-8 字符串，可直接用，不用再
urldecode()
