chmod()必须用八进制整数如0755而非755；需检查文件存在性和父目录执行权限；umask会隐式影响新建文件权限；windows下chmod基本无效，应平台适配。
chmod() 函数改文件权限必须用八进制数
php 中修改文件读写模式靠的是 chmod()，但它不接受字符串如 "755" 或 "rw-r--r--"，必须传入整型的八进制数值。写成 chmod($file, 755) 是错的——PHP 会当成十进制 755（即八进制 1363），实际权限完全不对。
正确写法是加 0 前缀表示八进制：chmod($file, 0755)。也可以用 octdec() 转换，但没必要增加开销。
-
0644：所有者可读写，组和其他人只读（普通文件推荐） -
0755：所有者可读写执行，组和其他人可读可执行（目录或可执行脚本） -
0600：仅所有者可读写（敏感配置文件，如.env）
修改前必须检查文件是否存在且当前进程有权限
chmod() 执行失败不会抛异常，只返回 false。常见失败原因不是代码写错，而是：
- 文件路径不存在，或拼写错误（比如漏了
./或多了一层../） - PHP 进程用户（如
www-data或nginx）对父目录没有执行（x）权限——linux 下进入目录需要x，否则连文件都“看不见” - 文件系统挂载为
noexec或nosuid，或使用了 NFS、某些容器卷，直接忽略 chmod 请求
建议先做两步检查：file_exists($file) 和 is_writable(dirname($file))（注意：是父目录可写，不是文件本身）。
立即学习“PHP免费学习笔记（深入）”；
umask 会影响 mkdir() 和 file_put_contents() 的默认权限
很多人发现新建的文件/目录权限和预期不符，根源常在 umask。它像一个“权限屏蔽罩”，会从你指定的模式里拿掉对应位。例如：
- 当前
umask是0022，调用mkdir("test", 0777)，实际得到的是0755 -
file_put_contents("log.txt", "x")默认按0666创建，受 umask 影响后变成0644
若需精确控制，可在操作前临时设置：umask(0)，但记得保存原值并恢复，避免影响后续操作；更稳妥的做法是创建后立刻 chmod() 显式修正。
windows 下 chmod() 基本无效，别依赖它做跨平台逻辑
Windows 没有 unix 类型的 rwx 权限模型，PHP 的 chmod() 在 Windows 上仅能模拟部分行为（比如设为只读或取消只读），0755 和 0644 这类数值会被静默忽略或转义为等效的 DOS 属性。
如果你的项目要跑在 Windows 开发环境 + Linux 生产环境，权限逻辑必须分层处理：
- 用
PHP_OS_FAMILY === "Windows"判断平台 - Windows 下跳过
chmod()，或仅用chmod($file, 0644)触发只读开关（靠FILE_ATTRIBUTE_READONLY） - 关键路径权限（如缓存目录）应在部署文档里明确要求管理员手动设置，而不是指望 PHP 自动搞定
真正容易被忽略的，是父目录的执行权限和 umask 的隐式作用——它们不报错，却让 chmod 看似“没生效”。