PHP FTP报错主因是未启用FTP扩展（Windows查php.ini中extension=php_ftp.dll，Linux装php-ftp包），或防火墙/安全组拦截端口21；ftp_put()“failed to open stream”实为本地临时文件路径为空，须先校验$_FILES["file"]["error"]===UPLOAD_ERR_OK；远程路径须为绝对路径，上传必用FTP_BINARY模式，NAT环境必须在登录后调用ftp_pasv($conn, true)。
别从“教程”开始学 PHP FTP，先解决你马上要写的那行 ftp_get() 或 ftp_put() 为什么报错。
为什么 ftp_connect() 总是返回 false？
不是代码写错了，大概率是 PHP 没启用 FTP 扩展。Windows 下检查 php.ini 是否有 extension=php_ftp.dll（注意不是 extension=ftp）；Linux 下常见是没装 php-ftp 包（如 Ubuntu 运行 sudo apt install php-ftp）。phpinfo() 页面里搜不到 “FTP support enabled” 就等于没开，重启 Web 服务也没用。
另一个高频原因是防火墙或云服务器安全组拦截了端口 21 —— 别只测连通性，要用 telnet your-ftp-host 21 实测底层 TCP 是否可达。有些 FTP 服务商默认只允许 PASV 模式，但 ftp_connect() 建立的是控制连接，不触发 PASV，所以连得上不代表后续能传文件。
ftp_put() 报 “failed to open stream” 怎么办？
这错误根本不是 FTP 的问题，是 PHP 在本地找文件时失败了。重点检查三件事：
立即学习“PHP免费学习笔记（深入）”；
-
$_FILES["file"]["tmp_name"]是否为空 —— 必须先判断$_FILES["file"]["error"] === UPLOAD_ERR_OK，否则直接拿tmp_name传给ftp_put()就会崩 - 远程路径不能以
./或../开头，必须是绝对路径，比如/uploads/photo.jpg，不是uploads/photo.jpg - 模式参数别写错：
FTP_BINARY是常量，不是字符串"FTP_BINARY"；上传图片、PDF、ZIP 一律用它，FTP_ASCII只适合纯文本且已知编码的 .txt/.csv
下载文件时 ftp_get() 返回 true 但本地文件是空的
最常踩的坑是本地目标路径不可写，或者父目录不存在。PHP 不会自动创建多级目录，ftp_get($conn, "/var/www/tmp/file.zip", "/remote/file.zip", FTP_BINARY) 中第一个参数的路径必须已存在，且 PHP 进程有写权限。
另一个隐蔽问题是被动模式没开：ftp_pasv($conn, true) 必须在 ftp_login() 之后、任何文件操作之前调用。NAT 环境（比如 Docker 容器、阿里云 ECS）下不启用 PASV，ftp_get() 可能静默失败 —— 表现就是文件大小为 0，但函数仍返回 true。
如果要下载大文件，别用 ftp_get() 直接写磁盘，改用 ftp_fget() 配合 fopen("php://temp", "r+") 流式处理，避免内存溢出。
为什么 ftp_nlist() 返回空数组，但明明目录里有文件？
不是没文件，是当前工作目录不对。ftp_pwd() 查一下当前路径，再用 ftp_chdir() 切到目标目录。很多 FTP 服务器登录后默认落在用户主目录（如 /home/username），而你要列的文件在 /www 下，不 chdir 就永远看不到。
另外，ftp_nlist() 不返回隐藏文件（以 . 开头的），也不保证顺序或包含子目录信息；需要完整元数据（时间、权限、大小）请用 ftp_rawlist()，但解析成本高，别在循环里频繁调。
FTP 最难缠的从来不是函数怎么写，而是连接状态、路径语义、模式选择这三件事在每次调用间悄悄变化。写完每一步，都该用 ftp_pwd() 和 ftp_systype() 确认当前上下文是否如你所想 —— 这比背函数签名重要得多。
