Symfony4.4 升级 Symfony5.4 Finder 方法废弃改造

Symfony 4.4 升级至 5.4 时，Finder 组件的 sortBy*Time() 方法废弃，需改用 sortBy() 配合 DateComparator；date() 过滤器语法更严格，要求显式操作符与 ISO 时间或相对表达式；exclude() 不再接受字符串，仅支持数组或 Traversable；in() 方法路径校验更严格，空值或非法路径将抛出异常。

从 Symfony 4.4 升级到 5.4 时，Finder 组件确实存在若干方法被废弃或行为变更，尤其集中在排序、时间过滤和构造方式上。升级不是简单替换函数名，而是要理解其设计意图的演进——5.4 更强调语义清晰、类型安全与可组合性。

sortBy*Time() 方法已废弃，改用 sortBy() + Comparator

在 4.4 中常用 sortByAccessedTime()、sortByModifiedTime() 等方法，在 5.4 中全部标记为 @deprecated，官方推荐统一使用 sortBy() 并传入 Comparator 实例。

• 4.4 写法（将报 E_USER_DEPRECATED）：

$finder->sortByModifiedTime();

• 5.4 正确写法：

use Symfony\Component\Finder\Comparator\DateComparator;
$finder->sortBy(new DateComparator('mtime', true)); // true 表示升序，false 为降序

其中 'mtime' 可换为 'atime'（访问时间）、'ctime'（inode 变更时间）。这个改动让排序逻辑更显式，也便于复用比较器。

date() 过滤器语法更严格，不支持模糊字符串

4.4 允许类似 date('since 1 hour ago') 这种自由格式，5.4 要求明确指定操作符与 ISO 8601 时间或相对表达式，并强制解析为 DateComparator。

• 4.4 支持但 5.4 已移除的写法：

$finder->date('before yesterday');

• 5.4 推荐写法（兼容且明确）：

use Symfony\Component\Finder\Comparator\DateComparator;
$finder->date(new DateComparator('<=', '-1 day'));

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

也可用 PHP 原生时间生成器：new DateComparator('<=', (new \DateTime())->modify('-30 days')->getTimestamp())。避免依赖 strtotime 的隐式解析，提升可维护性。

exclude() 不再接受字符串，只接受数组或 Traversable

4.4 中 exclude('vendor') 是合法的，5.4 开始要求必须传数组（即使只有一个目录）。

• 4.4 写法（5.4 报错）：

$finder->exclude('node_modules');

• 5.4 必须改为：

$finder->exclude(['node_modules', 'cache']);

该限制早在 5.2 就引入，5.4 彻底移除字符串支持。若原逻辑动态拼接排除项，需确保最终传入的是数组，例如 array_filter([$dir1, $dir2]) 后再传入。

in() 方法仍可用，但注意路径解析逻辑微调

in() 本身未废弃，但 5.4 对路径合法性检查更严格：自动过滤空字符串、null 和非字符串值；同时对 Windows 路径分隔符（\）的处理更健壮，但仍建议统一用 / 或 dirname(__FILE__) 等标准方式生成路径。

• 安全写法（跨版本兼容）：

$finder->in([realpath(__DIR__.'/src'), realpath(__DIR__.'/tests')]);

避免直接传入未清理的用户输入或配置项，防止因路径不存在导致 Finder 静默跳过——5.4 会抛出 InvalidArgumentException，而 4.4 可能仅忽略。