fileperms返回的是十进制整数,其二进制包含文件类型标志和权限位,需用fileperms($path) & 0777提取纯权限,再用sprintf('%03o', ...)格式化为三位八进制字符串。

fileperms 返回的到底是八进制还是十进制?
它返回的是十进制整数,但这个数的二进制布局直接对应底层 stat 的 mode 字段——里面混着文件类型标志(比如 0100000 表示普通文件)和权限位(0777 那部分)。你用 decoct(fileperms($path)) 看到类似 100644,开头的 100 就是类型位,不是权限。
常见错误:
- 直接拿 decoct(fileperms('x.txt')) 的结果当“权限字符串”用
- 把 fileperms() 结果当纯八进制数传给 chmod()
正确做法始终加掩码:
- 提取纯权限:fileperms($path) & 0777
- 格式化显示:sprintf('%03o', fileperms($path) & 0777) → 得到 0644 这类三位八进制串
为什么不能直接用 + 或 - 修改权限值?
权限是位掩码,不是算术值。写 $mode + 0004 看似加“其他可读”,但若该位已存在,加法会进位污染高位;若原值是 0644(420),+4 变成 424,二进制错乱,chmod 实际设出的权限完全不可控。
安全修改必须用位运算:
- 开启某位(如组执行):$newMode = $mode | 0010
- 关闭某位(如清除其他写):$newMode = $mode & ~0002
- 同时开/关多个位(如设所有者 rw、清其他 x):$newMode = ($mode | 0600) & ~0001
注意:PHP 中 0010 是八进制字面量(即十进制 8),不是字符串或十进制 10 —— 写成 '0010' 或 10 都会出错。
chmod 第二个参数必须写成 0755 这种带前导 0 的形式吗?
语法上不强制,chmod($f, 493) 和 chmod($f, 0755) 效果一样(493 十进制 = 0755 八进制)。但强烈建议用 0755 这种写法,因为:
- 一眼识别是权限值,不是随机整数
- 避免手误:写成 755(无前导 0)是十进制 755 → 八进制等价于 1357,远超常规范围,可能意外开放危险权限
- '0755' 是字符串,PHP 会尝试转换,但行为不稳定,某些版本触发警告或静默失败
实操建议:
- 所有权限字面量统一用 0 开头的八进制(如 0600、0755)
- 不要依赖 decoct() 输出去拼接权限值,它不剥离类型位
fileperms 结果缓存导致权限判断失效怎么办?
fileperms() 结果被 PHP 的 stat 缓存机制缓存,同一请求中多次调用返回相同值,即使文件权限已被外部命令(如 shell 的 chmod)修改过。
立即学习“PHP免费学习笔记(深入)”;
典型场景:
- 脚本先读取权限 → 判断是否可写
- 另一进程改了权限 → 本脚本后续再调 fileperms() 仍返回旧值
解决方式:
- 在关键检查前调用 clearstatcache(true, $path) 清除单个文件缓存
- 若操作大量文件,避免频繁清缓存影响性能;可考虑在权限变更后统一刷新,或用 stat($path)['mode'] & 0777 替代(stat() 也受缓存影响,同样需清)
- 不要依赖缓存“省性能”——权限校验出错比多一次系统调用代价高得多
真正容易被忽略的是:缓存问题只在反复读取同一文件时暴露,本地测试常因单次运行没复现,上线后才突然失效。



















