symfony 5.4 的 path 类不支持提取文件名或后缀，需用 php 原生函数：basename() 获取文件名，pathinfo($path, pathinfo_extension) 获取后缀，复合后缀需手动处理。
Symfony 5.4 的 Path 类本身不提供提取文件名或后缀的功能。它专注路径拼接、规范化、目录提取等底层字符串操作，而非文件组件解析。要获取文件名（如 report.pdf）或后缀（如 .pdf），需结合 PHP 原生函数或更合适的工具。
用 PHP 原生函数安全提取文件名
basename() 是最直接、跨平台兼容的方式，自动处理不同分隔符（/ 或 \）：
-
basename('/var/www/app/config.yml')→'config.yml' -
basename('C:\xampp\htdocs\index.php')→'index.php' - 若路径以分隔符结尾（如
/home/user/），结果为'user'；这是预期行为，不是错误
用 PHP 原生函数提取后缀（含点）
pathinfo($path, PATHINFO_EXTENSION) 是官方推荐方式，语义明确且能正确处理边界情况：
-
pathinfo('archive.tar.gz', PATHINFO_EXTENSION)→'gz'（只取最后一段） -
pathinfo('.gitignore', PATHINFO_EXTENSION)→''（空字符串，因点开头但无有效扩展名） - 想带点？拼上：
'.' . pathinfo($path, PATHINFO_EXTENSION)
需要多级后缀（如 .tar.gz）？得自己判断
pathinfo 不识别复合后缀。如需支持 .tar.gz、.zip.part 等，建议：
- 预定义常见复合后缀集合（按长度降序排列）
- 检查文件名是否以其中某项结尾
- 未匹配时再回落到
PATHINFO_EXTENSION - 避免用
strrpos($name, '.') + 1这类手动截取——对隐藏文件、多点名易出错
别误用 Path::getDirectory() 或 canonicalize()
这两个方法与文件名/后缀无关：
-
Path::getDirectory('/a/b.txt')返回'/a'（上级目录） -
Path::canonicalize('../b/c.txt')返回'../b/c.txt'（仅整理相对结构，不解析组件） - 强行组合
basename(Path::canonicalize($path))可行，但多此一举——basename()本身已足够健壮
