Symfony 4.4 升级至 6.4 时，Finder 组件变更最显著：sortBy*Time() 方法被移除，须改用 sortBy(new DateComparator())；date() 过滤器需显式传入 DateComparator；exclude() 仅接受数组或 Traversable；in() 对路径合法性校验更严格。
从 Symfony 4.4 升级到 6.4，文件管理相关代码最常出问题的模块是 Finder 和 Filesystem 组件，尤其 Finder 在 5.x 阶段已发生语义与类型层面的重大调整，而 6.4 延续并强化了这些变更。升级不是简单替换方法名，而是要适配更严格的类型约束、显式比较逻辑和构造规范。
Finder 排序方法必须改用 sortBy() + DateComparator
Symfony 4.4 中常用的 sortByModifiedTime()、sortByAccessedTime() 等快捷方法，在 5.2+ 已废弃，6.4 完全移除。直接调用会触发 E_USER_DEPRECATED 并在后续版本中断。
- 替换为
sortBy()并传入DateComparator实例，明确指定时间类型（mtime、atime、ctime）和排序方向 - 示例：升序按修改时间排序 →
$finder->sortBy(new DateComparator('mtime', true)) - 降序则传
false；若需多级排序，可链式调用多次sortBy()
date() 过滤器必须传 DateComparator，禁用模糊字符串
4.4 支持 date('since 1 week ago') 这类自由格式，6.4 要求显式操作符（<=、> 等）与 ISO 时间或相对表达式，并强制封装为 DateComparator。
- 错误写法：
$finder->date('before yesterday')（解析失败或静默忽略） - 正确写法：
$finder->date(new DateComparator('<=', '-1 day')) - 如需精确时间点，可用
(new \DateTime('2025-01-01'))->getTimestamp()构造
exclude() 只接受数组或 Traversable，不再支持字符串
4.4 允许 exclude('vendor')，6.4 报 TypeError，因签名已限定为 array|Traversable。
- 单个目录排除 →
exclude(['vendor']) - 多个目录 →
exclude(['node_modules', 'cache', 'var/logs']) - 动态生成时务必确保结果是数组，例如：
$excludes = array_filter([$dir1, $dir2]); $finder->exclude($excludes);
in() 路径校验更严格，空值或非法路径直接抛异常
in() 方法本身未废弃，但 6.4 对输入路径做前置合法性检查：空字符串、null、不存在路径、非绝对路径（相对路径未在上下文中解析）均会抛出 InvalidArgumentException。
- 使用前建议先判断：
if (is_dir($path) && $path) { $finder->in($path); } - 避免依赖未定义变量或配置未加载完成的路径，尤其是从环境变量或参数读取时
- 推荐统一用
realpath()或__DIR__.'/../some/dir'显式构造路径
