chmod不生效的主因是umask限制及权限链问题，需检查返回值、父目录x位、SELinux和容器环境权限。
php创建文件后chmod不生效的常见原因
直接调用 fopen() 创建文件再跟 chmod() 并不能保证权限立即按预期生效，尤其在 Linux 环境下。根本原因是：文件创建时的权限受系统 umask 限制，chmod() 虽能后续修改，但若进程无权限（如被 SELinux 或容器限制）、或文件已被其他进程锁定、或父目录无写/执行权限，chmod() 会静默失败或返回 false。
验证是否成功必须检查返回值：
if (!chmod($path, 0644)) {
error_log('chmod failed on ' . $path);
}
用file_put_contents() + chmod()组合更可靠
file_put_contents() 比 fopen()+fwrite() 更简洁，且能原子性写入（避免空文件残留）。但注意它**不会自动继承你期望的权限**——底层仍走系统默认 umask（通常是 0022，导致文件权限为 0644，目录为 0755）。
- 先写入内容：
file_put_contents($path, $content, LOCK_EX) - 再显式设权：
chmod($path, 0644)（注意是八进制，必须写成0644，不是644） - 若需确保父目录可访问，得提前用
mkdir(..., 0755, true)创建路径 - 在 Docker 或共享主机上，可能需配合
chown()（但通常 web 进程无权限）
绕过chmod：用stream_context_set_default控制创建权限
PHP 5.3.2+ 支持通过 stream_context_set_default() 设置默认上下文选项，对 file_put_contents() 和 fopen() 生效。关键参数是 use_include_path 不相关，真正起作用的是 context 中的 http 或 file 封装器选项——但遗憾的是：原生 file 封装器不支持创建时指定权限。所以这个思路行不通。
立即学习“PHP免费学习笔记（深入）”；
唯一可行替代是：改用 touch() + chmod() + file_put_contents() 分三步，或直接 shell 执行（不推荐，有安全风险）：
$path = '/tmp/test.txt'; touch($path); chmod($path, 0600); file_put_contents($path, $data);
权限设错的典型表现和排查点
设完 0644 却发现文件是 -rw-r--r--（正常），但网页打不开？很可能是 Apache/Nginx 运行用户（如 www-data）没权限读取父目录——因为目录缺少执行位（x）。文件权限再对，目录没 x 就无法进入。
- 检查目录权限：
ls -ld /path/to/dir→ 必须含r-x（即至少0755） - 确认 PHP 进程用户：
echo get_current_user();和posix_getpwuid(posix_geteuid()) - SELinux 启用时：
ls -Z $path，可能需chcon -t httpd_sys_rw_content_t $path - 容器环境：挂载卷默认为 root，web 进程用户无法 chmod，应改用启动时
chown或 volume 权限配置
真正棘手的从来不是 chmod 这一行代码，而是它背后那层看不见的权限链。
