chmod() 不抛异常，需检查返回值并结合 error_get_last() 获取错误信息；chown() 和 chgrp() 同理，且更易失败；根本原因多为系统权限限制而非 PHP 语法问题。
chmod() 失败时 try-catch 捕获不到异常
chmod() 是 PHP 的内置函数，它不抛出异常，而是直接返回 false。所以用 try/catch 包裹 chmod() 调用，永远捕获不到任何东西——这不是 bug，是设计如此。
常见错误现象：try { chmod('/path/file', 0644); } catch (Exception $e) { echo $e->getMessage(); } 完全没反应，即使权限修改失败也不会进 catch 块。
- 必须用返回值判断：检查
chmod()是否返回false - 配合
error_get_last()可获取最后一次系统级错误（如 “Operation not permitted”） - 注意：PHP 运行用户（如 www-data、nginx、apache）必须对目标文件/目录有“父目录的执行权（x）”才能修改其权限
chown() 和 chgrp() 同样不抛异常，且更难成功
和 chmod() 一样，chown() 和 chgrp() 也只返回布尔值。它们失败概率更高，因为通常需要 root 权限或属于目标组。
使用场景：Web 程序尝试把上传后的临时文件改属主，结果静默失败，后续程序因权限不足读取失败。
立即学习“PHP免费学习笔记（深入）”；
- Linux 下非 root 用户无法任意
chown，只能改自己拥有的文件的组（且需在目标组内） - PHP-FPM 配置中若设了
clear_env = no，可能继承 shell 的umask，间接影响新建文件权限，但不影响已有文件的chmod - 推荐做法：先
if (!chmod($path, $mode)) { $err = error_get_last(); trigger_error("chmod failed: " . ($err['message'] ?? 'unknown'), E_USER_WARNING); }
想统一用异常处理？自己封装一层
如果项目已大量依赖异常流，可以写个薄封装，把失败转为 RuntimeException。
function safe_chmod(string $path, int $mode): void
{
if (!chmod($path, $mode)) {
$err = error_get_last();
throw new RuntimeException('chmod failed on ' . $path . ': ' . ($err['message'] ?? 'no details'));
}
}
这样就能用 try/catch 了，但要注意：
- 别在循环里频繁调用这种封装，避免额外函数调用开销
-
error_get_last()不是线程安全的，在并发请求中可能拿到别的请求的错误 - 某些 SAPI（如 CLI）下
error_get_last()更可靠；Web SAPI 中建议优先依赖返回值 + 日志记录
真正该关注的是“为什么改不了”，不是“怎么捕获”
90% 的权限修改失败，根源不在 PHP 语法，而在运行环境权限模型。比如：
- 容器中挂载的 volume 使用了
ro（只读）选项 - SELinux 或 AppArmor 启用，拦截了
chmod系统调用（日志会出现在/var/log/audit/audit.log） - 文件系统是 FAT32/exFAT，根本不支持 Unix 权限位
- PHP 进程被
cap_dac_override能力限制（常见于最小化容器镜像）
这些情况，无论你怎么改 PHP 代码，chmod() 都不会成功。先用 ls -l 和 id 确认当前用户、文件归属与挂载属性，比补 try 更有效。
