七牛云PHP SDK读取文件内容需先用Auth生成私有下载链接（如privateDownloadUrl($baseUrl, 3600)），再用file_get_contents或curl请求该链接获取文件体；直接调用BucketManager::get仅返回元信息，无法获取文件内容。
PHP怎么用七牛云SDK读取文件内容
直接用 Qiniu\Storage\BucketManager 的 get 方法无法拿到文件体，它只返回元信息；真正读文件得走 HTTP 下载流。常见错误是以为调用一次 SDK 接口就能拿到内容，结果返回的是空或 401。
- 先用
Qiniu\Auth生成带过期时间的私有下载链接（哪怕空间是公开的，也建议统一走此流程防盗链） - 用
file_get_contents或curl请求该链接；注意设置超时和User-Agent，否则某些 CDN 节点可能拒绝响应 - 私有空间必须加签名，示例：
$auth->privateDownloadUrl($baseUrl, 3600)，其中3600是秒级有效期，别设太长
PHP怎么上传文件到七牛云并控制路径与覆盖行为
上传核心是 Qiniu\Storage\UploadManager 的 put 方法，但默认不覆盖同名文件，且 key（即文件路径）若含非法字符会静默失败。
-
key必须是合法 URL 路径格式：不能以/开头，不能含..、空格、控制字符；推荐用md5_file($filePath) . '.jpg'生成安全 key - 如需覆盖，不用额外配置——七牛云默认同 key 上传即覆盖，但前提是账号没开启「禁止覆盖」策略（可在 Portal → 空间设置里确认）
- 上传大文件建议用分片上传
putFile，小文件用put即可；put的第三个参数是$params，可传['x:tag' => 'user_123']做业务标记
PHP读写时遇到 “invalid token” 或 “no such file” 怎么快速定位
这两个错误看着像权限或路径问题，但根因常在 token 生成逻辑或域名配置上。
-
invalid token多半因为Qiniu\Auth初始化时用了错误的$accessKey/$secretKey，或上传时未传$token（put第二个参数），又或者 token 已过期（检查生成时是否传了$expires） -
no such file不一定是文件真不存在：可能是绑定的加速域名未备案、测试用的测试域名（如xxx.qiniup.com）已过期、或请求的 host 写成了上传域名（up.qiniup.com）而非下载域名（your-bucket-name.oss-cn-hangzhou.aliyuncs.com风格不对，七牛是bucketname.z0.qiniup.com） - 调试时直接把生成的下载 URL 拿浏览器打开，看返回的 HTTP 状态码和 body，比查 PHP 日志更快
PHP处理七牛云数据要不要自己维护文件列表
不要。七牛云不提供实时全量文件列表接口，BucketManager::listFiles 是分页+最终一致性，延迟可达数分钟，且频繁调用会触发频率限制。
立即学习“PHP免费学习笔记（深入）”；
- 业务侧需要“文件存在性判断”或“批量操作”，应该自己在 MySQL 或 Redis 中记录 key 和状态，上传成功后立刻写入
- 如果只是偶尔查某几个文件，用
stat接口（BucketManager::stat）单次验证，比拉列表快得多，也更准 - 注意
listFiles返回的marker是字符串，不是数字偏移，下一页必须原样传回，不能做任何截断或 base64 解码
