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 命令变慢、备份困难。按年月分目录是简单有效的方案。
网络工作室源码基于热腾CMS(RTCMS)定制,栏目全站自动调用,可设置生成为html静态文件。网站分类适合网络公司和工作室使用。程序中带有演示数据,如果全新安装,可将根目录下的/uploads 文件夹中的演示图片文件删掉。安装方式:上传upload_install中的文件上传到虚拟主机或服务器网站根目录下;访问 http://域名/ 即可安装,安装时可以选取“演示数据&
- 生成路径如:
$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')检查实际值










