ftp与sftp在php中完全不兼容，ftp_函数仅支持ftp/ftps，sftp必须用ssh2_函数或phpseclib；二者协议、函数、权限机制及断点续传实现均不同，混用会导致连接失败、权限无效或静默错误。
FTP 与 SFTP 在 PHP 中根本不是一回事，别混用函数
PHP 的 ftp_* 函数（如 ftp_connect、ftp_put）只支持传统 FTP/FTPS，完全不支持 SFTP；SFTP 是 SSH 协议上的文件子系统，必须用 ssh2_* 函数或第三方库（如 phpseclib）。试图用 ftp_put 连 SFTP 服务器只会返回 Warning: ftp_put(): Illegal port number 或直接连接失败。
常见错误场景：
- 误把 SFTP 服务器地址填进
ftp_connect—— 连不上，且无明确报错提示协议不匹配 - 在启用 SSL 的 FTPS 环境中未调用
ftp_ssl_connect，而用普通ftp_connect—— 登录时卡住或被拒绝 - 用
ftp_chmod尝试修改 SFTP 文件权限 —— 该函数对 SFTP 无效，返回false且不报错
断点续传只能靠自己比对，PHP 原生不提供 resume 支持
ftp_fput 和 ssh2_scp_send 都不支持 offset 参数或断点续传标志。要实现断点续传，必须手动检查远程文件大小，再用 fseek 跳过已传输部分。
实操要点：
- FTP 场景：先用
ftp_size获取远程文件大小，若为-1表示文件不存在，可全量上传；否则用fopen($local, 'rb')+fseek($fp, $remote_size)定位，再调用ftp_fput($conn, $remote, $fp, FTP_BINARY, $remote_size) - SFTP 场景：用
ssh2_sftp_stat读取size字段，注意它返回的是关联数组，需取$stat['size']；写入时用fopen($sftp_stream, 'ab')模式追加，但需确保服务端支持（部分 OpenSSH 版本限制追加写） - 关键陷阱：FTP 服务器可能关闭被动模式下的分块续传，此时
ftp_fput从非零 offset 开始会触发 550 错误 —— 必须提前用ftp_pasv($conn, true)并确认服务器响应227成功
权限控制不能只靠 chmod，得看协议能力和用户上下文
FTP 上传后默认权限由服务器 umask 决定，ftp_chmod 仅在服务器支持 SITE CHMOD 扩展命令时生效（如 Pure-FTPd 默认开启，vsftpd 默认关闭）；SFTP 的权限则取决于 SSH 用户的 shell 权限和 ssh2_sftp_chmod 调用是否被服务端允许。
安全实践建议：
- FTP 环境中，不要依赖
ftp_chmod设置敏感权限（如 0777），优先在上传前用本地chmod控制源文件权限，并配置 FTP 用户根目录为/var/www/uploads类隔离路径 - SFTP 环境中，
ssh2_sftp_chmod失败时检查ssh2_sftp_stat返回的uid/gid是否与目标用户一致 —— 若上传用户是deploy，但文件属主被自动设为www-data，chmod 会被拒绝 - 自动化脚本里禁止硬编码
0755：用fileperms($local_path) & 0777继承源权限更可靠，避免因 umask 导致远程权限比预期宽松
自动化同步脚本必须处理连接中断、目录差异与时间戳漂移
单纯循环 scandir + ftp_put 会漏掉删除操作、忽略子目录、误判同名不同内容文件。真实同步需要三元对比：本地文件时间戳、远程文件时间戳、远程是否存在。
最小可行方案要点：
- 用
ftp_mdtm（FTP）或ssh2_sftp_stat($sftp, $path)['mtime']（SFTP）获取远程最后修改时间，与本地filemtime比较；注意时区 —— FTPftp_mdtm返回的是服务器本地时间，若服务器在 UTC+8 而脚本运行在 UTC，需统一转为时间戳比较 - 远程目录结构需递归构建：FTP 用
ftp_nlist+ftp_size列出所有路径，SFTP 用ssh2_sftp_opendir+ssh2_sftp_readdir遍历，两者都不支持通配符递归 - 连接异常必须重试并清理资源：每次
ftp_connect后检查返回值，失败时sleep(2)后重试最多 3 次；成功后务必在脚本末尾调用ftp_close或ssh2_disconnect，否则连接数会耗尽
最易被忽略的一点：SFTP 同步时，ssh2_sftp_rename 不等价于 mv —— 它在跨文件系统时实际是 copy+delete，若磁盘空间不足，会静默失败。务必在 rename 前用 ssh2_sftp_stat 检查目标分区剩余空间。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
