推荐使用多磁盘配置+显式调用指定磁盘方案：通过config/filesystem.php定义local和oss两个磁盘，上传时显式调用storage::disk('oss')->put()或storage::disk('local')->put()，配合默认参数封装即可无缝切换，轻量且无需扩展。
如果您在ThinkPHP6.x项目中需要根据环境或业务规则动态选择文件存储位置，则本地磁盘与阿里云OSS之间无法自动切换往往导致重复编码或硬编码路径。以下是实现本地存储与云存储（OSS）无缝切换的多种可行方案：
一、多磁盘配置 + 显式调用指定磁盘
该方案利用ThinkPHP6原生filesystem组件的多磁盘能力，无需扩展或重写驱动，仅通过配置和调用方式控制存储目标，是最轻量且推荐的默认方式。
1、确认已安装阿里云OSS SDK：执行composer require aliyuncs/oss-sdk-php命令。
2、在config/filesystem.php的'disks'数组中新增两个独立磁盘配置：
• 'local'磁盘使用'type' => 'local'，'root'设为runtime/upload（避开public目录直访风险）；
• 'oss'磁盘使用'type' => 'oss'，并完整填写access_key_id、access_key_secret、bucket、endpoint（必须含https://协议），同时设置'url'字段为对外可访问的Bucket域名（结尾不加/）。
3、上传时不再依赖default磁盘，而是显式调用：Storage::disk('oss')->put('images/avatar.jpg', $file->getStream())或Storage::disk('local')->put('tmp/log.txt', 'content')。
4、若需封装通用上传方法，可在参数中加入$disk = 'local'默认值，调用时传入'oss'即可即时切换，避免修改控制器逻辑即可完成存储策略变更。
二、基于File对象的store()方法统一入口
该方案将上传逻辑收口至think\File类的store()方法，利用其自动重命名、MIME校验、路径安全处理等特性，同时支持磁盘名传参，实现业务层零耦合切换。
1、确保config/filesystem.php中已正确定义'local'与'oss'两个磁盘，且'oss'驱动参数完整无误。
2、在控制器中接收上传文件后，不使用$file->move()（该方式绕过filesystem抽象，无法切换远程存储）。
3、改用$file->store('uploads', 'oss')，其中第二个参数即为磁盘名称；若存本地则传'local'。
4、如需自定义文件名，使用$file->storeAs('uploads', 'custom_name.jpg', 'oss')，注意custom_name.jpg不得包含路径遍历字符（如../）。
5、此方式天然支持真实MIME校验与并发安全命名，且上传大文件时自动采用流式读取，内存占用更低。
三、引入thans/thinkphp-filesystem-cloud扩展驱动
该方案采用社区成熟扩展，专为ThinkPHP6设计，内置对阿里云OSS、腾讯云COS等的标准化适配，规避手写驱动易出现的临时文件丢失、内存溢出、权限配置遗漏等问题。
1、执行composer require thans/thinkphp-filesystem-cloud安装扩展包。
2、在config/filesystem.php中新增磁盘配置，'type'必须设为'aliyun'（非'oss'），'endpoint'须带协议（如https://oss-cn-hangzhou.aliyuncs.com），'url'为公开访问域名（结尾不可有/）。
3、确保.env中已定义OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET、OSS_ENDPOINT、OSS_BUCKET四项，且在配置中通过env()函数引用。
4、上传操作仍使用标准Storage::disk('aliyun')->put(...)，扩展自动接管流式上传、断点续传及错误重试逻辑。
5、该扩展彻底绕开moveTo()落盘流程，直接从HTTP上传流写入OSS，杜绝/tmp/phpXXXXXX文件不存在类错误。
四、服务类封装 + 驱动策略模式
该方案面向中大型项目，将上传行为抽象为服务接口，通过依赖注入动态解析具体驱动，实现运行时策略切换，便于灰度发布、A/B测试或多租户隔离。
1、创建app/service/UploadService.php，定义upload(File $file, string $disk = 'local'): array方法。
2、在服务内部调用Storage::disk($disk)->put($path, $file->getStream())，并统一处理返回URL（根据磁盘配置的url字段拼接）。
3、编写app/driver/LocalUploadDriver.php与app/driver/OssUploadDriver.php，分别实现相同接口，但底层调用不同磁盘实例。
4、在app/common/provider/AppServiceProvider.php中绑定服务：$this->app->bind(UploadService::class, function ($app) { return new UploadService(); });。
5、控制器中通过app(UploadService::class)->upload($file, 'oss')调用，业务代码完全不感知存储细节，切换仅需更改参数字符串。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
