symfony 6.4 的 filesystem::remove() 方法支持递归删除非空目录，传入目录路径即可自动清除其所有内容，无需手动遍历；应避免使用已移除的 delete() 或对目录调用 unlink()。
在 Symfony 6.4 中，Filesystem 组件不提供直接的「递归删除非空目录」方法（如 remove() 默认只删空目录或文件），但可通过组合已有方法安全、可靠地实现。
使用 remove() 配合 exists() 和路径遍历
Symfony 的 Filesystem::remove() 实际上支持递归删除——只要传入的是目录路径，它会自动递归删除其所有内容（包括子目录和文件）。这是最简洁、推荐的方式，无需手动遍历。
- 确保你使用的是 Symfony 6.4+ 的
Filesystem（来自symfony/filesystem包） -
remove()接受字符串路径或字符串数组，对每个路径执行递归删除 - 若路径不存在，不会报错（可选：先用
exists()判断）
示例代码：
use Symfony\Component\Filesystem\Filesystem;
$fs = new Filesystem();
$dir = '/path/to/non-empty-directory';
if ($fs->exists($dir)) {
$fs->remove($dir); // ✅ 自动递归删除整个目录树
}
避免常见误区：不要误用 delete() 或 unlink()
旧版 Symfony 或其他框架中可能有 delete() 方法，但在 Symfony 6.4 的 Filesystem 中已移除。当前可用的核心删除方法只有：
-
remove(string|array $paths)—— 唯一官方支持的递归删除入口 -
mkdir(),touch(),copy()等为辅助操作，不用于删除 -
unlink()仅适用于文件，对目录会抛出IOException
错误写法（会失败）：
$fs->unlink('/some/dir'); // ❌ 抛出异常：Cannot unlink directory
增强健壮性：添加权限检查与异常捕获
生产环境中，目录可能因权限不足、被进程占用或符号链接问题导致删除失败。建议包裹 try-catch 并记录原因：
- 捕获
Symfony\Component\Filesystem\Exception\IOException - 必要时用
chmod()临时提升权限（需谨慎） - 对符号链接目录，
remove()默认只删链接本身（非目标），如需穿透删除，需先readlink()+ 手动处理
示例：
try {
$fs->remove($dir);
} catch (IOException $e) {
// 记录日志或触发告警
error_log('Failed to remove '.$dir.': '.$e->getMessage());
}
替代方案：手动遍历 + remove()（仅特殊场景需要）
绝大多数情况无需手动遍历。仅当你需要：
- 按特定规则过滤删除（如只删 7 天前的子目录）
- 逐个文件做审计或回调通知
- 兼容极老环境（Symfony
此时可用 Finder 组件配合 remove()：
use Symfony\Component\Finder\Finder;
$finder = Finder::create()->in($dir)->depth('>= 0')->sortByName();
foreach ($finder as $file) {
$fs->remove((string) $file->getPathname()); // 从深到浅删（确保父目录最后删）
}
$fs->remove($dir); // 最后删根目录（其实已被清空）
⚠️ 注意：手动遍历时务必按深度倒序（depth('>= 0') + sortByName() 不够可靠），更稳妥是用 IteratorIterator + RecursiveDirectoryIterator 反向遍历，但复杂度显著上升——优先信任 remove() 的内置递归逻辑。
