php mkdir() 权限不生效主因是未重置 umask 且父目录无写权限；需 umask(0) 后 mkdir($path, 0755, true)，再还原 umask，并用 realpath() 规范路径、按年月分目录、同步调大 upload_max_filesize 和 post_max_size。
PHP mkdir() 创建上传目录时权限不生效？
直接用 mkdir() 创建目录却提示“Permission denied”，多半是没传对第三个参数。PHP 默认创建的目录权限受系统 umask 影响，即使写 0755 也可能变成 0700。必须显式传入第三个参数 true（表示递归创建），并配合 umask(0) 临时重置掩码。
- 先调用
umask(0)，再执行mkdir($path, 0755, true) - 创建后建议立刻还原 umask：
$old = umask(0); mkdir(...); umask($old); - linux 下 Web 服务器用户（如 www-data）需对父目录有写权限，否则
mkdir仍会失败
上传目录路径拼接容易出错的三个地方
路径错误导致文件写到意外位置，甚至被外部访问。常见问题不是函数不会用，而是字符串拼得不安全。
- 别用
$_SERVER['DOCUMENT_ROOT'] . '/uploads/'拼接 —— 如果网站部署在子目录（如/myapp/），DOCUMENT_ROOT不包含它，路径就偏了 - 推荐用
__DIR__ . '/uploads/'（相对当前脚本）或dirname(__DIR__) . '/public/uploads/'（更规范的项目结构） - 务必用
realpath()标准化路径，防止../绕过：$uploadDir = realpath(__DIR__ . '/uploads');
自动创建年月子目录避免单目录文件过多
上传量稍大时，所有文件堆在根上传目录会导致 inode 占满、ls 命令变慢、备份困难。按年月分目录是简单有效的方案。
- 生成路径如：
$subdir = date('Y/m');→'2024/06' - 完整路径：
$fullPath = $uploadDir . '/' . $subdir; - 创建前检查并确保可写：
if (!is_dir($fullPath) && !mkdir($fullPath, 0755, true)) { throw new RuntimeException("无法创建上传子目录: $fullPath"); } - 注意：windows 对路径分隔符不敏感，但 Linux 下必须用
/，不要用DIRECTORY_SEPARATOR拼上传 URL 路径
为什么 upload_max_filesize 和 post_max_size 都要调？
哪怕目录建好了、权限也对，上传仍失败？很大概率是 PHP 配置拦住了。这两个值不是“二选一”，而是必须同时满足。
立即学习“PHP免费学习笔记（深入）”；
-
upload_max_filesize控制单个文件上限（如10M） -
post_max_size控制整个 POST 请求体大小（含所有字段 + 所有文件），必须 ≥ 所有上传文件总和 - 修改后需重启 PHP-FPM 或 apache，仅 reload 不生效；CLI 模式下该配置无效
- 运行时可通过
ini_get('upload_max_filesize')和ini_get('post_max_size')检查实际值
实际项目中，最常被忽略的是 umask 与父目录写权限的组合影响 —— 目录看似创建成功，但子进程（如图片缩略图生成）因权限不足而失败，排查起来非常隐蔽。