ThinkPHP 6.0 中 think\facade\Filesystem 是标准门面，调用方式为静态风格，如 Filesystem::disk('public')->putFile('images', $file)，自动重命名、校验并写入；验证需通过 $file->validate()（非门面链式调用），返回相对路径，拼 URL 需手动加 Filesystem::getDiskConfig('public', 'url') 前缀，磁盘配置在 config/filesystem.php。
ThinkPHP 6.0 的 Filesystem 门面怎么用
TP6.0 中 think\facade\Filesystem 是标准门面，底层绑定的是 think\Filesystem 实例（由 think-filesystem v1.x 提供），调用方式统一为静态风格：
-
Filesystem::disk('public')->putFile('images', $file)是推荐上传方式，自动重命名、校验、写入 - 磁盘配置在
config/filesystem.php，新增自定义磁盘如'uploads'后可直接Filesystem::disk('uploads') - 不支持链式
validate()—— 这是 TP6 的坑：文件验证必须走$file->validate()（think\File实例），不是Filesystem门面的事 -
putFile()返回相对路径（如images/abc.jpg），拼 URL 要手动加前缀：Filesystem::getDiskConfig('public', 'url') . '/' . $path
ThinkPHP 8.0 的 Filesystem 门面关键变化
TP8.0 要求 topthink/think-filesystem ≥ v2.0，门面类仍是 think\facade\Filesystem，但底层已切换到 Flysystem v3+，行为有实质性差异：
- 必须显式声明依赖：
"topthink/think-filesystem": "^2.0"不再隐含，漏写会导致Class 'think\facade\Filesystem' not found -
putFile()默认启用更严格的 MIME 校验（基于内容头而非后缀），若旧逻辑依赖伪造后缀上传，会直接失败 -
getDiskConfig()返回结构微调：'url'键可能为空，需 fallback 到app()->getRootPath() . 'public/storage'或检查是否已运行php think storage:link - 远程磁盘（OSS/COS）的凭证字段名变更，比如阿里云 OSS 的
access_key→access_id，配置不更新会静默初始化失败
从 TP6 升级到 TP8 时 Filesystem 门面最常崩的点
不是语法报错，而是“看起来能跑，实际不干活”——这类问题最难排查：
mac-system-control
下载
管理和控制 macOS 系统功能。包括查看系统信息、管理进程、控制音量/亮度、 网络管理、电源管理、截图、剪贴板、Finder 操作等。当用户要求查看系统状态、 控制系统设置、管理进程、截图、调节音量亮度、查看网络信息、 关机重启睡眠等 Mac 系统操作时使用。
- PHP 版本不一致：CLI 用 php8.2，fpm 仍为 php7.4 →
Filesystem类加载成功，但putFile()内部反射失败，返回null且无异常 - 磁盘配置里漏了
'visibility' => 'public'→ 本地磁盘写入成功，但生成的 URL 访问 404（尤其在 Nginx 配置未配 alias 时） - 自定义磁盘的
'root'路径用了相对路径如'./public/uploads'→ TP8 的路径解析更严格，必须用绝对路径：app()->getRootPath() . 'public/uploads' - 第三方包冲突：比如老版
overtrue/wechat依赖league/flysystemv1，会把think-filesystemv2 的核心类覆盖掉，Filesystem::disk()返回空对象
为什么不能直接 new Filesystem()？
门面不是语法糖，它是容器代理。直接 new \think\Filesystem() 会绕过依赖注入，导致：
立即学习“PHP免费学习笔记（深入）”；
- 无法自动加载磁盘配置（
config/filesystem.php完全失效） - 缓存、日志、事件监听等扩展机制全部丢失
- 在 TP8 中甚至构造失败：v2 的
think\Filesystem构造函数强制要求FilesystemAdapter实例，不再接受简单数组配置 - 测试时无法 Mock：门面可通过
think\Facade::fake()模拟，而 new 出来的实例只能靠复杂反射替换
TP8 的 Filesystem 门面表面用法没变，但背后是整套 Flysystem v3 生态和 PHP 8 类型系统重构。最容易忽略的是：它现在真的只认配置、只信容器、只走约定路径——任何“手动拼接”“临时绕过”的操作，都会在上线后某个深夜悄无声息地断掉文件写入。
