symfony 8.0 的 filesystem 组件不提供 is_directory() 方法，应使用 php 原生 file_exists($path) && is_dir($path) 组合判断，以避免路径不存在、权限不足或符号链接导致的误判。
在 Symfony 8.0 中，Filesystem 组件本身不提供 is_directory() 方法。它专注跨平台安全操作（如 mkdir、remove、chmod），但不负责路径类型判断。要检查一个路径是否为目录，必须借助 PHP 原生的 std::filesystem（C++）——不对，那是 C++；PHP 场景下应使用 PHP 自带的 is_dir() 或更健壮的 file_exists() + is_dir() 组合。
直接用 PHP 原生函数（推荐，简洁可靠）
这是最常用、无依赖、兼容 Symfony 8.0 的方式：
-
is_dir($path)：返回true当且仅当路径存在且是目录 - 但它对不存在的路径、权限不足的路径、符号链接（未解析目标）也返回
false，不报错 - 所以建议先用
file_exists($path)排除“不存在”情况，再判断类型
示例代码：
$path = $this->getParameter('kernel.project_dir').'/var/log';
if (!file_exists($path)) {
// 路径不存在
} elseif (is_dir($path)) {
// 是目录
} else {
// 存在但不是目录（可能是文件、软链、设备节点等）
}
用 Symfony Filesystem 配合异常捕获（间接方式）
虽然 Filesystem 没有 isDirectory()，但你可以尝试调用 isReadable() 和 scandir() 的组合逻辑，或更稳妥地——利用其 exists() 和 mkdir() 的行为差异：
-
$filesystem->exists($path)只说明路径存在，不分类型 -
$filesystem->isReadable($path)对目录和文件都可能返回true - 真正有效的间接判断：尝试
$filesystem->scandir($path)—— 若成功返回数组，基本可确认是可读目录；若抛出IOException（如 “Not a directory”），则不是目录
示例（带异常处理）：
Yuanfang Design System
下载
yuanfang-skills 的共享设计系统，提供 token CSS 变量、12+ 主题以及可复用的布局类型 HTML 块，供 yuanfang-html-image（以及 fu...）使用。
use Symfony\Component\Filesystem\Exception\IOException;
try {
$items = $filesystem->scandir($path);
// 成功返回数组 → 极大概率是目录
} catch (IOException $e) {
if (str_contains($e->getMessage(), 'Not a directory')) {
// 明确不是目录
}
}
为什么不推荐只用 is_dir() 单独判断？
is_dir() 在以下情况都会静默返回 false，容易误判：
- 路径根本不存在
- 当前 PHP 进程无权限访问该路径（如 Linux 上权限为 000 或属主不符）
- 路径是符号链接，且目标不可达或非目录
- Windows 下路径含保留名（如
AUX、NUL）或非法字符
因此，**务必先确认存在性与可访问性，再做类型判断**，避免把“权限拒绝”当成“不是目录”。
补充：Symfony 项目中常见需判断目录的场景
比如在命令行命令、缓存清理逻辑或上传目录初始化时：
- 检查
var/cache是否为目录（而非同名文件） - 确认自定义上传目录（如
public/uploads）已存在且是目录 - 防止
$filesystem->mkdir($path)因同名文件存在而失败
此时可封装一个工具方法：
private function isDirectory(string $path): bool
{
return file_exists($path) && is_dir($path);
}
