chmod()只接受带前缀0的八进制整数（如0755），字符串"755"、十进制755或十六进制0x755均非法；路径不存在、umask干扰及Windows权限限制也会导致“Invalid argument”警告。
chmod() 参数非法：权限值必须是八进制整数
PHP 的 chmod() 函数不接受十进制数字或字符串形式的权限（比如 "755" 或 755），直接传会导致 Warning: chmod(): Invalid argument。它只认八进制整数，且必须带前缀 0（不是字符串 "0755"）。
常见错误写法：
-
chmod("file.txt", "755")→ 字符串，非法 -
chmod("file.txt", 755)→ 十进制 755（等于十进制 755 = 八进制 1363），不是预期权限 -
chmod("file.txt", 0x755)→ 十六进制，也不对
正确写法只有这一种：
chmod("file.txt", 0755); // 注意：开头的 0 表示八进制，755 是八进制字面量
如果权限值来自变量或配置，需用 octdec() 或强制类型转换处理：
立即学习“PHP免费学习笔记（深入）”；
$mode = "755";
chmod("file.txt", octdec($mode)); // 将字符串"755"转为八进制整数 493（即 0755）
文件不存在或路径错误也会触发 Invalid argument
chmod() 在目标文件/目录不存在、路径不可达、或当前进程无权访问父目录时，部分系统（尤其是 Windows + WSL 或某些 Docker 环境）不会报 ENOENT，而是统一返回 Invalid argument —— 这容易误导你去查权限参数，实际是路径问题。
- 先用
file_exists()和is_writable(dirname($path))检查路径有效性 - Windows 下注意反斜杠转义：
"C:\\temp\\file.txt"或用正斜杠"C:/temp/file.txt" - Linux 容器中检查挂载权限：宿主机映射目录是否加了
:ro或 SELinux 限制
umask 会干扰 chmod 实际生效的权限
即使 chmod("file.txt", 0644) 执行成功，最终权限可能是 600 —— 因为 PHP 进程继承了系统的 umask（如 0022），它会按位取反后与你传入的 mode 做 AND 运算。这在 CLI 脚本或某些 CGI 环境中尤为明显。
安全做法是显式屏蔽 umask 影响：
$old = umask(0); // 临时设为 0
chmod("file.txt", 0644);
umask($old); // 恢复原值
或者更稳妥地：用 stat() 验证结果
$actual = substr(sprintf('%o', fileperms("file.txt")), -4); // 如 "0644"
非 POSIX 系统（Windows）的 chmod 行为差异
Windows 不支持真正的 Unix 权限模型，chmod() 在 Windows 上仅能模拟读/写标志：0600 和 0400 分别关闭/开启只读属性，其它位（如执行位、组权限）被忽略。传入 0755 可能静默失败，或仅影响只读位。
- 跨平台代码中，避免依赖
chmod()设置执行权限或精细分组控制 - Windows 下改权限建议用
attrib命令（需 shell_exec，且注意安全） - 判断环境：
PHP_OS_FAMILY === "Windows"，然后跳过或降级处理
真正容易被忽略的是：错误信息里的 Invalid argument 很可能不是参数写错了，而是你正在 Windows 上试图设置一个它根本不理解的权限位 —— 此时函数返回 false，但没明确告诉你“这个系统不支持”。
