ThinkPHP怎样集成OvertrueFlysystem七牛_OvertrueFlysystem七牛实战【教程】-ThinkPHP-PHP中文网

错误主因是使用废弃扩展或配置不符，需改用overtrue/flysystem-qiniu适配器，严格校验bucket命名、region参数、密钥来源及域名备案一致性，并修正文件读取方式与大文件上传逻辑。

thinkphp怎样集成overtrueflysystem七牛_overtrueflysystem七牛实战【教程】

如果您在ThinkPHP项目中尝试接入七牛云存储，但上传失败、报错Invalid bucket name或401 Unauthorized，则很可能是因使用了已废弃的league/flysystem-qiniu扩展，或配置参数不符合overtrue/flysystem-qiniu适配器要求。以下是多种可行的集成方案：

一、安装兼容适配器并配置Filesystem磁盘

overtrue/flysystem-qiniu是当前唯一兼容ThinkPHP 6.x/7.x与七牛云SDK v7+的官方推荐适配器，它支持region、useHttps等关键参数，且不依赖已弃用的Auth类。

1、执行Composer命令安装适配器：composer require overtrue/flysystem-qiniu

2、在config/filesystems.php的disks数组中添加qiniu磁盘配置项，确保bucket全小写、不含区域后缀（如-z1），domain必须带https://协议头：

3、从七牛控制台「密钥管理」页面完整复制accessKey和secretKey，不可混用临时Token或对象存储子账号密钥

4、region参数须按实际空间所在区域填写：华南填z2、华东填z1、华北填z0、北美填na0、新加坡填as0，不能留空或填错为cn-east-1等S3风格标识

二、修正文件上传逻辑避免路径错误

ThinkPHP的$request->file()返回的是think\File对象，其getPathname()返回/tmp/phpXXX路径，而Flysystem无法直接读取该路径内容；必须通过getRealPath()获取真实临时路径后再读取二进制流，否则将触发open_basedir拦截或返回空文件。

1、获取上传文件对象：$file = $this->request->file('image');

2、安全读取文件内容：先调用getRealPath()，若返回false（如Swoole环境或OPcache干扰），则fallback至$file->read()方法

3、使用file_get_contents()读取二进制数据：$content = file_get_contents($file->getRealPath());

4、调用Filesystem上传：\think\facade\Filesystem::disk('qiniu')->put('uploads/' . uniqid() . '.jpg', $content);