推荐使用标准disk驱动方式配置oss磁盘，避免uploadfile硬塞临时路径、密钥明文写死、endpoint漏协议或url多斜杠等高频坑；需通过env读取凭证、type设为'aliyun'、流式上传、ram最小权限授权。
ThinkPHP 文件上传到阿里云 OSS，核心不是“怎么传”，而是“怎么不踩坑”。直接用 uploadFile() 硬塞临时路径、明文写死密钥、配置漏掉协议或斜杠，90% 的失败都出在这几处。推荐走标准 disk 驱动路线，既符合框架规范，又避开临时文件清理、内存溢出、路径越界等高频问题。
用 filesystem 配置 OSS 磁盘（最稳）
这是 ThinkPHP 6+ 官方推荐方式，基于 Flysystem 抽象层，自动处理流式上传和权限控制。
- 安装 SDK：
composer require aliyuncs/oss-sdk-php:2.5.2（PHP 7.4 项目必须锁定此版本） - 在
config/filesystem.php的disks中添加：
'oss' => [<br> 'type' => 'aliyun',<br> 'access_id' => env('ALIYUN_OSS_ACCESS_ID'),<br> 'access_secret' => env('ALIYUN_OSS_ACCESS_SECRET'),<br> 'bucket' => env('ALIYUN_OSS_BUCKET'),<br> 'endpoint' => env('ALIYUN_OSS_ENDPOINT', 'https://oss-cn-hangzhou.aliyuncs.com'),<br> 'url' => env('ALIYUN_OSS_URL', 'https://my-bucket.oss-cn-hangzhou.aliyuncs.com')<br>],
- .env 文件中补全四要素（务必从环境变量读，不硬编码）：
ALIYUN_OSS_ACCESS_ID=xxx<br>ALIYUN_OSS_ACCESS_SECRET=yyy<br>ALIYUN_OSS_BUCKET=my-app-bucket<br>ALIYUN_OSS_ENDPOINT=https://oss-cn-hangzhou.aliyuncs.com
- 验证是否生效：
Storage::disk('oss')->put('test.txt', 'ok')，成功即说明配置通
上传时别碰 moveTo()，改用 store()
$file->moveTo() 只适用于 local 驱动；OSS 是远程存储，调用它必报错或静默失败。
- 控制器中这样写才对：
$path = $file->store('uploads', 'oss'); // 返回 uploads/xxx.jpg - 如果要自定义文件名：
$path = $file->storeAs('images', uniqid().'.'.$file->extension(), 'oss'); - key 值不能以
/开头，否则 OSS 返回 400 —— 所以store('/images/a.jpg', 'oss')是错的，store('images/a.jpg', 'oss')才对
大文件或高并发场景：必须流式上传
临时文件路径（$file->getTmpName()）在请求结束前可能已被 PHP 清理，尤其在 Nginx + PHP-FPM 短超时环境下。uploadFile($bucket, $key, $tmpPath) 就是典型陷阱。
- 正确做法是拿资源句柄：
$stream = fopen($file->getTmpName(), 'rb'); - 再交给 SDK：
$ossClient->putObject($bucket, $key, $stream); - 记得关闭资源：
fclose($stream); - 如需封装为自定义驱动，确保 upload 方法返回含
url、path的数组，且 key 名规范（不用用户原始文件名直拼，防遍历）
安全与运维关键点
上线前必须检查这几项，否则就是生产事故预备役。
- RAM 子账号最小权限：至少授予
AliyunOSSFullAccess或自定义策略含oss:PutObject - .env 不提交 Git：确认
.gitignore包含.env，CI/CD 用 secrets 注入 - endpoint 必须带
https://，结尾不加/；url 字段也一样，结尾多一个/会导致生成 URL 多出双斜杠 - bucket 名严格区分大小写，和控制台里完全一致
- PHP 版本低于 8.0？SDK 必须锁死
2.5.2，否则类加载失败
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
