thinkphp文件存储配置需按场景选择：本地存储只需正确配置config/filesystem.php的local磁盘；oss配置必须严格匹配type、endpoint、access_id、access_secret、bucket字段且路径不能以/开头；七牛云须用overtrue/flysystem-qiniu扩展并校验bucket、region和domain。
新手在ThinkPHP项目中配文件存储，别一上来就堆SDK——先理清目标：是临时开发用本地？还是上线后要高可用、可扩展？本地配置最简单，OSS和七牛云则需注意驱动类型、参数命名、路径规范这三处最容易翻车的地方。
本地存储：够用、零依赖、适合起步
本地磁盘是ThinkPHP默认启用的，不用装任何扩展。只需确认 config/filesystem.php 中有这个定义：
- 'local' => ['type' => 'local', 'root' => app()->getRuntimePath() . 'storage']
- 上传时直接用
Storage::disk('local')->put('test.txt', 'hello')，文件会写入runtime/storage/目录 - 如需网页可访问，把
public/storage软链接到runtime/storage（Linux/macOS）或用 Windows 符号链接，再通过/storage/test.txt访问
OSS配置：字段大小写和路径开头不能错
阿里云OSS必须用 overtrue/flysystem-oss 扩展（不是官方旧包），且四个字段名一个字母都不能拼错：
-
type → 小写字符串
'oss'（写成 'OSS' 或 'AliyunOSS' 都会静默失败） -
endpoint → 带
https://，如https://oss-cn-shanghai.aliyuncs.com，不能含 bucket 名 - access_id 和 access_secret → 必须来自 RAM 子账号，主账号 AK 不行
-
bucket → 纯名称，如
my-app-bucket，不加协议、不加斜杠、不带区域后缀 - 上传路径禁止以
/开头：Storage::disk('oss')->put('avatar/1.jpg', $content)✅，'/avatar/1.jpg'❌（直接 400 错误）
七牛云配置：换对适配器、校验 bucket 和 region
ThinkPHP 6/7 必须用 overtrue/flysystem-qiniu，旧版 league/flysystem-qiniu 已废弃，会导致鉴权失败：
-
bucket 全小写，不含
-z2、cn-east-1这类后缀；区域信息单独填在 region 字段（如z2表示华南） - accessKey / secretKey 从七牛控制台「密钥管理」复制，勿用临时 Token
- domain 必须是已备案并绑定该 bucket 的 CDN 域名，且协议（http/https）与 useHttps 参数一致
- 上传时别传
$file对象本身，要用$file->getRealPath()拿路径，再file_get_contents()读内容；若返回 false（如 Swoole 环境），fallback 到$file->read()
大文件上传：绕过 Flysystem 直接调 SDK
Flysystem 的 put() 会把整个文件读进内存，>10MB 就容易超时或爆内存。这时应跳过抽象层，直连云 SDK：
- 七牛：装
qiniu/php-sdk，用UploadManager::putFile()传临时路径 - OSS：用
aliyun/oss-sdk-php的putObject，传fopen($tmpPath, 'rb')流式上传 - 所有大文件上传前，务必检查
$_FILES['xxx']['error'] === UPLOAD_ERR_OK，避免空文件上传
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
