17370845950

PHP 的 chmod() 对 SFTP 上传后的文件无效，因 SFTP 传输会重置权限；必须上传后通过 SFTP 协议调用远程 chmod（如 phpseclib 的 $sftp->chmod()）才能生效，且需排查权限、setstat 支持及路径问题。

PHP 的 chmod() 对 SFTP 传输后的文件无效

直接说结论：用 PHP 的 chmod() 修改本地文件权限，对后续通过 SFTP 上传的文件**不生效**。SFTP 传输过程本身会重置权限，且服务端 umask、SSH 用户配置、SFTP 服务器实现（如 OpenSSH、ProFTPD）都会覆盖你本地设的权限。

常见错误现象是：本地 chmod(0600, $file) 后用 phpseclib 或 ssh2_sftp() 上传，结果远程文件权限仍是 0644 或 0755 —— 这不是 PHP 没执行成功，而是 SFTP 协议层没把“权限”当元数据透传过去（尤其在非 POSIX 兼容目标系统上）。

真正起效的权限控制必须在 SFTP 上传后执行

要在远程服务器上设置权限，得在上传完成之后，通过 SFTP 通道调用远程命令或协议方法改权。不同 PHP SFTP 库支持方式不同：

• phpseclib（推

  

  荐）：上传后立即用 $sftp->chmod(0600, '/remote/file.txt') —— 它封装了 SFTP 协议的 SSH_FXP_SETSTAT 请求，直接作用于远程文件
• ext/ssh2：上传后需用 ssh2_sftp_chmod($sftp, '/remote/file.txt', 0600)；注意该函数在 PHP 8.1+ 才稳定支持，旧版本可能静默失败
• 如果用 system() 调用 sftp 命令行工具：上传完再跑 echo "chmod 600 /remote/file.txt" | sftp user@host，但依赖 shell 环境且不安全

OpenSSH SFTP 服务端的 umask 是隐形决定者

即使你在 PHP 里显式调用了 $sftp->chmod()，也可能被服务端拦截。OpenSSH 默认配置中，sftp-server 启动时继承 SSHD 进程的 umask（通常是 022），它会强制将上传文件的权限“与”上 0755（即去掉写权限）。这意味着：

• 你传一个本地权限为 0644 的文件 → 远程变成 0644 & ~022 = 0644
• 你传一个本地权限为 0777 的文件 → 远程变成 0777 & ~022 = 0755
• 你上传后再 chmod(0600) → 成功，因为这是独立的 SETSTAT 操作，绕过了 umask

所以别指望靠“传前改本地权限”来控制远端结果，umask 只影响上传动作本身，不干预后续 chmod。

权限设置失败的三个典型原因

遇到 $sftp->chmod() 返回 false 或无效果，先排查这些：

• 远程用户对目标路径**没有写权限**（例如父目录不可写，导致无法修改子文件属性）
• SFTP 服务器禁用了 setstat 功能（某些嵌入式或加固环境会关闭此扩展操作）
• 路径含符号链接且服务端未启用 follow_symlinks —— chmod() 会作用在链接本身而非目标文件
• 使用了绝对路径但远程工作目录不是根目录，而你传的是相对路径（建议统一用 /full/path/to/file）

最稳妥的做法是：上传后立即 chmod，再用 $sftp->stat() 检查返回数组中的 mode 字段确认是否生效。别只信返回值，有些旧版 phpseclib 在出错时不抛异常也不返 false。