chmod() 返回 false 的根本原因是 PHP 进程用户无权修改文件权限，常见于非所有者且非 root、父目录不可写、open_basedir 限制、Windows 不支持或 umask 干扰。
chmod() 返回 false 但没报错
PHP 的 chmod() 函数执行失败时，通常静默返回 false，而不是抛出异常或输出错误。根本原因往往是「当前 PHP 进程的执行用户」没有权限修改目标文件的权限 —— 不是文件本身只读，而是操作系统层面的权限拦截。
常见错误现象：chmod('/path/to/file.txt', 0644) 返回 false，fileperms() 查看仍是旧值；用 shell 手动 chmod 却能成功。
- 确认 PHP 运行用户（如
www-data、apache或nginx）是否为文件所有者，或属于文件所在组且有写权限（对目录而言） - Linux 下，只有文件所有者或 root 才能调用
chmod()；非所有者即使有写权限也无法改权限 - 检查父目录是否可写：修改文件权限需对**文件所在目录**有写权限（因为权限位本质是目录项元数据）
- Web 服务器常以低权限用户运行，避免用
chown把文件改成该用户所有，而应调整目录归属或使用 ACL
safe_mode 已废弃但 open_basedir 仍在作祟
PHP 5.4+ 已移除 safe_mode，但 open_basedir 限制仍会干扰 chmod() —— 它不仅限制文件读写路径，也限制系统调用类操作的生效范围。
使用场景：本地开发环境正常，上线后 chmod() 失败，error_log 里却无记录。
立即学习“PHP免费学习笔记（深入）”；
- 检查
phpinfo()中open_basedir值，确保目标文件路径在其白名单内 -
open_basedir为/var/www/html/时，/tmp/uploaded_file就无法被chmod() - 若必须操作站外路径，临时关闭需修改
php.ini或虚拟主机配置，而非代码中绕过
Windows 下 chmod() 完全无效
Windows 没有 Unix 权限模型，PHP 的 chmod() 在 Windows 上仅能模拟部分行为（如设置只读标志），对 0755 这类八进制模式直接忽略，也不报错。
常见错误现象：chmod($file, 0755) 在 Windows 上始终返回 true，但实际权限未变；部署到 Linux 后突然失效。
- 判断运行环境：
PHP_OS_FAMILY === 'Windows'，则跳过chmod()或改用chmod()兼容逻辑（如仅设只读：chmod($file, 0444)） - 跨平台项目中，避免在 Windows 开发机上测试权限逻辑；CI 环境务必用 Linux runner 验证
- 不要依赖
chmod()控制访问安全 —— Web 服务权限应由 webserver 配置和目录结构保障，而非文件模式
umask 干扰导致权限“设不对”
即使 chmod() 成功，最终权限也可能和预期不符，根源常是 PHP 进程继承了系统或父进程的 umask（默认通常是 0022），它会在你指定的权限上做“屏蔽”。
例如：chmod($file, 0666) 在 umask=0022 下实际得到 0644（即 0666 & ~0022）。
- 用
umask()临时重置（注意：它是进程级全局设置，多线程/多请求下慎用） - 更稳妥的做法是显式计算目标权限：
$target = 0666 & ~umask(); chmod($file, $target); - Docker 或 CLI 脚本中容易忽略 umask 继承问题；FPM 模式下，master 进程的 umask 会影响 worker
权限不是写个数字就完事，关键得看谁在改、在哪改、改完归谁管。尤其是线上环境，别信返回 true，一定要 fileperms() 再读一次验证。
