filesystem::mkdir() 在 symfony 5.4 中默认支持递归创建多级目录，失败主因是权限不足、父目录不可写或路径配置错误；需确保 php 进程用户对首个缺失目录的直接父目录有写权限，避免手动 is_dir() 判断，并注意 selinux 或 docker 挂载限制。
Filesystem::mkdir() 在 Symfony 5.4 中创建多级目录失败，根本原因通常不是组件本身问题，而是权限、父目录缺失或调用方式不匹配预期。它默认支持递归创建（即自动建好所有不存在的上级目录），但有几个关键细节必须满足，否则静默失败或抛出异常。
✅ 确保传入的是路径数组或字符串，且目标父级可写
mkdir() 接受单个路径字符串或路径数组：
$filesystem = new Filesystem();
$filesystem->mkdir('/var/www/myapp/uploads/cache'); // ✅ 支持递归
// 或
$filesystem->mkdir(['/var/www/myapp/logs', '/var/www/myapp/tmp']); // ✅ 批量
但它不会自动修复父目录的不可写状态。例如：
若 /var/www/myapp 存在但权限为 drwxr-xr-x（即组/其他无写权），而当前 PHP 进程用户（如 www-data）不属于该目录所属组，则 /var/www/myapp/uploads 创建会失败。
检查并修复方法：
- 运行
ls -ld /var/www/myapp确认属主与权限 - 若需写入，确保 PHP 用户对最深层的首个缺失目录的直接父目录有写权限
- 推荐用
chmod 755 /var/www/myapp+chown -R www-data:www-data /var/www/myapp（生产环境按最小权限原则调整）
✅ 不要混用 mkdir() 和手动 is_dir() + mkdir() 原生调用
常见错误是先自己判断再调用 Filesystem::mkdir()，反而干扰其递归逻辑：
// ❌ 错误：多余判断可能中断流程
if (!is_dir($path)) {
$filesystem->mkdir($path); // 但 $path 的父级若不可写，这里仍失败
}
// ✅ 正确：直接让 Filesystem 处理，它内部已做递归检查
try {
$filesystem->mkdir($path);
} catch (IOException $e) {
// 捕获具体错误，如 "Permission denied" 或 "No such file or directory"
throw new \RuntimeException(sprintf('Failed to create dir "%s": %s', $path, $e->getMessage()));
}
Symfony 的 mkdir() 内部已调用 is_dir() 和 mkdir(..., 0777, true)，你无需重复。
使用 Kadence 主题作为 WordPress 项目的设计系统，涵盖设计令牌、布局系统、页头/页脚/导航设置以及页面/归档/单篇文章模板。
✅ 避免绝对路径拼接错误或符号链接陷阱
- 确保
$path是真实绝对路径，不要依赖__DIR__拼错层级（如多一个/导致/var/www//uploads） - 若路径含符号链接，
mkdir()默认操作的是链接指向的目标位置；如需操作链接本身，需额外处理（一般不需要）
验证路径是否合法：
$path = $this->getParameter('kernel.project_dir') . '/var/uploads';
if (!realpath($path)) {
throw new \InvalidArgumentException("Invalid upload path: {$path}");
}
$filesystem->mkdir($path);
✅ 生产环境特别注意：SELinux 或容器挂载限制
-
Linux 发行版启用 SELinux 时（如 CentOS/RHEL），即使权限 777 也可能因上下文拒绝创建目录。临时排查可运行：
setenforce 0 # 仅测试用，勿在生产开启
长期方案：
semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/myapp/var(/.*)?"+restorecon -Rv /var/www/myapp Docker 容器中，宿主机挂载的目录若以只读方式绑定（
:ro），mkdir()必然失败。检查docker run或docker-compose.yml中卷配置是否遗漏:rw。
不复杂但容易忽略
