在服务器上用PHP创建文件夹设置权限，核心结论是：用mkdir()创建后立即调用chmod()显式指定权限，同时确保目录属主与Web运行用户一致，缺一不可。
我平时帮朋友排查服务器问题，相当一部分案例是权限惹的祸，文件权限这东西，本地开发时基本无感，一到线上就原形毕露，今天就把PHP创建文件夹这件事掰开揉碎，讲明白权限怎么设、为什么设了没效果、以及不同环境下该怎么做。
服务器上的目录就像一间间办公室，权限是门禁卡系统，你让PHP去创建文件夹，相当于给新办公室配锁，锁的级别设错了，后面用户上传图片、生成缓存、写日志，全都进不了门，搞清楚这套逻辑,比死记命令有用得多。
php创建文件夹的两种实现方式
PHP创建文件夹的方式不外乎两种：直接调函数，或者借系统命令，各有适用场景,别只认一个。
mkdir函数：最直接但别忽略umask
大多数情况下,你只需要一行代码：
mkdir('/var/www/html/upload', 0755, true);
第三个参数true表示递归创建，比如你要建upload/user/avatar,父目录不存在时会一次性全建好。
问题来了：很多开发者写完这段代码，跑去服务器看目录权限，发现根本不是755，而是0744或者0700，原因在于Linux的umask机制，PHP进程默认的umask会从你指定的权限里“扣掉”一部分，假设umask是0022，那么0755对应的结果是0744组写和其他写权限直接被削弱。
解决方式有两种，第一种,创建前临时修改umask：
$old = umask(0);
mkdir('/var/www/html/upload', 0755, true);
umask($old);
更推荐第二种，创建后补一个chmod,干净利落：
if (!file_exists('/var/www/html/upload')) {
mkdir('/var/www/html/upload', 0755, true);
chmod('/var/www/html/upload', 0755);
}
别嫌多这一步，它能挡住很多后续的“图片传不上去”“缓存写不进去”，业内专家指出，在PHP日志里看到Permission denied时，第一反应就该查属主和chmod的结果,而不是盲目加权限到777。
用exec调用系统命令：更可控但需谨慎
有些场景下，mkdir函数处理不了，典型的是要给目录强行改属主，或者一次性处理多层目录的权限,这时你会用到exec或shell_exec：
exec('mkdir -p /data/www/site/cache && chown -R www:www /data/www/site/cache && chmod -R 755 /data/www/site/cache');
命令里的-p、-R、&&，都是Linux运维的基础操作，这种方式能绕开umask干扰，也能直接指定属主，适合对服务器操作有把握的同学，但要注意，开启exec风险不小，建议只在受控环境、且命令参数经过严格过滤时使用。
linux服务器网站目录权限配置的常见误区
目录权限这件事，很多人停留在“坏了就777”的阶段，777确实能让程序跑起来，但代价是你的网站文件对所有用户可写，一旦程序有漏洞，攻击者可以直接改写PHP文件,整个站点等于拱手让人。
权限数值到底怎么算
先把常用的几个数值记清楚：
| 数值 | 属主（u） | 属组（g） | 其他（o） | 适用场景 |
|---|---|---|---|---|
| 755 | 读写执行 | 读+执行 | 读+执行 | 代码目录、静态资源目录 |
| 644 | 读写 | 读 | 读 | 普通文件（index.php、config.php） |
| 775 | 读写执行 | 读写执行 | 读+执行 | 需要组内协作写入的目录 |
| 777 | 读写执行 | 读写执行 | 读写执行 | 尽量避免，仅限临时目录且无敏感数据 |
行业共识认为：目录给755，文件给644，这是默认底线；只有明确需要写入的目录（如upload、cache、log）才放宽到775,并且考虑配合chgrp让运行用户和属组匹配。
谁该是目录的主人
权限数值只是敲门砖,属主不对依然进不去门。
举个例子，你的Nginx以www-data用户运行，但FTP上传文件时以ftpuser身份创建了目录，这个目录属主是ftpuser，www-data属于“其他用户”，能读到但不一定能写入，如果这个目录需要PHP写文件（比如图片上传目录）,PHP进程肯定会拒绝。
实际操作时,你只要记住三条：
- 先查PHP运行用户：
ps aux | grep php-fpm，看到的那一行就是当前身份 - 再查目录属主：
ls -ld /var/www/html/upload - 不一致就改：
chown -R把目录交给PHP运行用户
命令组合如下：
chown -R www:www /var/www/html/upload chmod -R 775 /var/www/html/upload
当服务器装的是宝塔面板
用宝塔面板的同学，文件夹权限设置可以在文件管理器里直接操作，右键目录，选择“权限”，填入755或775，再勾选“应用到子目录”，宝塔的底层其实就是调用chmod命令，但省去了命令行操作，需要留意，宝塔里网站默认运行用户是www，如果你用root建了目录，务必在面板里把属主改成www，很多人在宝塔上遇到“上传到服务器后图片无法写入”的情况,大概率就是属主问题。
php mkdir权限不对怎么解决
如果你已经按上面的方式做了，权限还是不对，别急，这个问题的排查路径是固定的，按顺序走一遍,基本能定位。
第一步：确认文件系统类型
你的web目录可能挂在NTFS、FAT32这些文件系统上，这些系统不支持Linux的chmod权限模型，PHP的mkdir不管参数填什么都无效，检查方法：终端执行df -T /var/www/html，看Type列，如果是ext4、xfs这些Linux原生文件系统，继续往下查；如果是ntfs-3g或vfat，就得改挂载参数（比如umask=000）,或者换一个Linux原生分区存放网站。
第二步：检查umask
前面提过umask会削弱权限，执行umask命令看当前值，多数服务器默认是0022，如果你希望创建的目录保持755，umask填0或022都可以，若发现umask被设成027或077，请修改php-fpm的配置文件，或在脚本开头用umask(0)临时重置。
第三步：检查SELinux
这一步经常被忽略，CentOS等系统默认开启SELinux后，即使权限是777，Apache或Nginx也可能被拒绝写操作,先看状态：
getenforce
返回Enforcing说明SELinux在强制隔离,最快的验证方式是临时关闭：
setenforce 0
再试一次你的PHP操作，如果恢复正常，说明是SELinux策略拦截，不建议长期关闭，正确做法是调整上下文标签,把web目录标记为httpd_sys_rw_content_t：
chcon -R -t httpd_sys_rw_content_t /var/www/html/upload
第四步：检查PHP错误日志
日志里往往写着最真实的原因，打开php-fpm或nginx的error_log，搜索“Permission denied”或“failed to open stream”，如果看到“No such file or directory”，优先确认目录层级里有没有哪一级没创建成功，如果看到“Permission denied”,则对照上面三步逐一排查。
权限设置失误的典型故障场景
权限出了问题，在用户端的表现五花八门,以下三种最常见：
图片上传失败，提示无法写入
用户在前台上传头像，前端提示“文件上传成功”，刷新一看图片没了，PHP后端日志显示move_uploaded_file() failed to open stream: Permission denied，原因大多是upload目录权限不足，或属主是root、PHP运行用户是www，解决：给upload目录执行chown www:www，再chmod 775。
后台生成缓存文件失败
用ThinkPHP、Laravel这类框架，运行时需要往runtime或storage目录写缓存，如果权限不够，系统直接白屏或报“目录不可写”，解决办法是找到框架要求的可写目录，一次性重置属主和权限,以Laravel为例：
chown -R www:www storage bootstrap/cache chmod -R 775 storage bootstrap/cache
很多安装教程会建议777，其实775就足够,前提是属主设置正确。
日志文件轮转失败
Nginx的日志目录权限不对，会导致日志不写入或cron任务里的logrotate报错，处理方式一致：把logs目录属主改为nginx或www,权限755。
Q&A：PHP服务器文件夹权限设置常见问题排查
Q1：设置777权限是不是最省事的方式？
不是，777让所有用户都能读写执行，安全性极低，一旦同服务器上有其他用户被入侵，你的整个网站目录就暴露了，生产环境推荐：代码文件644，目录755，明确需要写入的少量目录单独设置775并调整属组，虽然多几步操作,但风险可控得多。
Q2：为什么我用chmod()设置权限，返回了true但实际权限没变？
chmod返回true只能说明PHP函数调用成功，不代表文件系统的最终权限符合预期，先看目录挂载的文件系统是否支持posix权限（NTFS上无效），再检查函数是否受SELinux拦截，如果PHP开启了disable_functions，把chmod禁用了，也会出现这种“假成功”，最直接的办法是在命令行执行ls -ld /path/to/dir,看真实权限值。
Q3：Windows服务器的IIS环境需要设置Linux权限吗？
不需要，Windows不使用chmod权限模型，IIS的目录权限由ACL（访问控制列表）控制，在文件夹属性→安全里配置，PHP的chmod函数在Windows上会被调用，但基本不生效，你需要做的是给IIS的应用程序池用户（如IUSR）添加对应目录的“修改”和“写入”权限,方式是在文件夹属性中编辑安全权限。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/602504.html
