chmod() 返回 false 但无报错，主因是PHP进程非文件所有者或父目录不可写；传参须用0755而非"0755"或755；NFS/容器挂载、open_basedir限制及umask也导致静默失败。
chmod() 返回 false 但没报错
这是最常见的情况：调用 chmod() 后返回 false，却没触发 PHP 错误或异常。根本原因通常是 PHP 进程没有对目标文件的「所有权」或「父目录写权限」——Linux/Unix 下，chmod() 要求执行者必须是文件所有者（或 root），且父目录需有写权限才能修改其下文件的元数据。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先用
ls -l /path/to/file确认文件所有者和当前 PHP 进程用户（如www-data、nginx或apache）是否一致 - 检查父目录权限：
ls -ld /path/to，确保该目录对 PHP 用户可写（至少包含w位） - 不要依赖
@chmod()抑制错误——它会掩盖真实问题；改用if (!chmod($file, 0644)) { error_log("chmod failed: " . $file); } - 注意：即使
is_writable($file)返回true，也不代表能chmod()——前者只检测写内容权限，后者是修改 inode 权限，权限模型不同
使用 0755 却变成 0777 或其他值
PHP 的 chmod() 接受八进制整数（如 0755），但若传入字符串 "0755" 或十进制数字 755，结果会出人意料：前者被转为 0，后者是十进制 755 → 八进制约等于 1363，系统按掩码截断后常表现为 0777。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 务必用前缀
0的整数字面量：chmod($file, 0755)，而非chmod($file, "0755")或chmod($file, 755) - 验证是否生效：用
decoct(fileperms($file) & 0777)获取实际权限的八进制字符串（如"755"），避免靠肉眼判断ls -l输出中的符号位 - 注意 umask 影响：如果脚本中调用了
umask()，它会屏蔽掉部分权限位——chmod()设置的是「最大允许权限」，最终值 = 设置值 & ~umask
Web 服务器用户无法修改 NFS 或容器挂载卷权限
在 Docker 容器、Kubernetes Pod 或挂载了 NFS/CIFS 的环境中，chmod() 往往直接失败（返回 false），因为底层文件系统不支持 Unix 权限位，或挂载时禁用了 noacl/nosuid 选项，甚至服务端强制统一 uid/gid。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先运行
mount | grep $(dirname $file)查看挂载参数，重点关注是否有nosuid、noacl、ro（只读）或uid=/gid=固定映射 - NFS 场景下，权限由服务端控制，PHP 所在客户端的
chmod()调用会被忽略或返回失败——此时应改在 NFS 服务端调整权限或导出选项 - Docker 中，若用
-v /host/path:/container/path挂载，宿主机文件权限已固定；可在启动容器时用--user匹配宿主 uid，或构建镜像时用RUN chown预设属主
safe_mode 已废弃，但 open_basedir 仍会拦截 chmod()
PHP 5.4+ 已移除 safe_mode，但很多人忽略 open_basedir 的限制：它不仅控制文件读写路径，也影响 chmod()、chown() 等系统调用——只要目标文件不在 open_basedir 列表内，一律拒绝。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查
phpinfo()或ini_get('open_basedir')，确认目标文件路径是否被包含 - 如果路径动态生成，注意符号链接问题：
open_basedir检查的是解析后的物理路径，不是 symlink 路径 - Apache 的
php_admin_value open_basedir和 Nginx 的fastcgi_param PHP_VALUE "open_basedir=..."都可能覆盖 php.ini 设置，需逐层排查
真正卡住的地方，往往不是 chmod() 写错了参数，而是 PHP 进程根本没资格碰那个 inode——所有权、挂载属性、open_basedir、umask，四者任一不匹配，都会静默失败。调试时别只盯函数返回值，先 ls -l 和 mount 看两眼。
