symfony 6.x 中 filesystem 组件移除了构造函数 $umask 参数、mkdir() 默认不递归、copy() 删除 $force 参数、rename()/symlink() 取消自动回退，并强化 dumpfile() 原子性校验与所有权限制。
在 Symfony 6.x 中，Filesystem 组件本身未被废弃，但部分 4.4 时期常用的方法签名、行为或底层依赖已被移除或调整。这些变化并非全部标注为“deprecated”后才删除，有些是随主版本升级直接移除的 BC BREAK。以下是你在从 Symfony 4.4 迁移到 6.x（尤其是 6.4 LTS）时，实际会遇到且已失效的关键 Filesystem 相关变更：
yuanfang-skills 的共享设计系统，提供 token CSS 变量、12+ 主题以及可复用的布局类型 HTML 块，供 yuanfang-html-image（以及 fu...）使用。
1. Filesystem 类构造函数不再接受 $umask 参数
Symfony 4.4 支持：$fs = new Filesystem(0002);
→ 在 Symfony 6.x 中该构造参数已被完全移除。权限控制改由各方法独立传入（如 dumpFile() 的第三个 $mode 参数），全局 umask 不再生效。
2. mkdir() 方法默认不再递归创建多级目录
4.4 中：$fs->mkdir('/var/log/app/2026/10'); 会自动递归建全路径。
→ Symfony 6.x 起，mkdir() 默认行为变为仅创建最后一级目录（类似原生 mkdir($path, 0755, false)）。
若需递归，必须显式传入第二个参数 true：$fs->mkdir('/var/log/app/2026/10', true);
3. copy() 方法移除了 $force 参数的隐式覆盖逻辑
4.4 允许：$fs->copy('src.txt', 'dst.txt', true); —— 第三个参数为布尔值，表示是否强制覆盖。
→ Symfony 6.x 中该签名已被删除。现在只保留两个参数形式：$fs->copy('src.txt', 'dst.txt');
如需覆盖目标文件，必须先用 exists() 判断并手动 remove()，或改用更明确的 mirror() + 自定义选项。
4. rename() 和 symlink() 等方法不再自动处理跨文件系统失败回退
4.4 中 rename() 在跨挂载点失败时，会尝试 fallback 到 copy+unlink；symlink() 对 Windows 支持也做了较多兼容封装。
→ Symfony 6.x 移除了这些“自动兜底”逻辑，严格委托给 PHP 原生函数。这意味着：
- rename() 跨 NFS 或容器卷失败时不再重试；
- symlink() 在 Windows 非管理员模式下直接抛出异常，不再尝试 mklink /D 模拟。
5. dumpFile() 的原子性保障前提更严格
虽 dumpFile() 仍存在且推荐使用，但 Symfony 6.x 明确强化了文档警告：
- 若目标路径位于网络文件系统（如某些 Kubernetes emptyDir 卷、NFSv3）、或临时目录与目标目录不在同一挂载点，rename() 原子性无法保证 → 不再静默降级，而是直接抛出 IOException 并提示 “atomic write not supported”；
- 同时，dumpFile() 不再自动调用 chown() 或 chgrp()，即使你设置了 $mode，所有权仍由进程 uid/gid 决定。
