PHP连接FTP需启用ftp扩展（取消php.ini中extension=ftp注释并重启服务），正确配置host、port（默认21）、timeout（建议≥30秒），登录后启用ftp_pasv()，验证远程路径权限与格式，文件操作依赖ftp_get()/ftp_put()等函数，不支持SQL式查询。
FTP 不是数据库，PHP 里没有「FTP 数据库」这种东西。你实际要配的，是 PHP 连接 FTP 服务器所需的环境和参数。
PHP 的 ftp 扩展必须启用
如果 ftp_connect() 报错「function undefined」或直接不识别，说明扩展没开。
- 打开
php.ini，找到这一行：;extension=ftp - 删掉开头的分号，改成：
extension=ftp - 保存后重启 Web 服务（Apache/Nginx）或 PHP-FPM
- 用
php -m | grep ftp（命令行）或phpinfo()页面确认是否加载成功
连接时端口、超时、被动模式这些参数不能硬写死
很多连接失败不是因为账号密码错，而是网络策略卡在数据通道上——尤其在云服务器、Docker 或 NAT 环境下。
-
ftp_connect($host, $port, $timeout)中的$port默认是 21，但有些 FTP 服务跑在非标端口（比如 2121），得显式传入 -
$timeout建议设为 30 秒以上，避免内网延迟或防火墙拦截导致false返回 - 登录后务必调用
ftp_pasv($conn, true)—— 否则大概率遇到"500 I won't open a connection to..."错误
ftp_login() 成功不代表权限够下载/上传
FTP 登录成功只代表认证通过，但目标路径的读写权限由服务器侧控制。常见表现：
立即学习“PHP免费学习笔记（深入）”；
-
ftp_get()返回false，但无明确错误提示 → 检查远程路径是否存在、用户是否有读权限 -
ftp_put()失败且报"Failed to open stream"→ 实际是远程目录不可写，或路径中含非法字符（如空格、中文未编码） - 用
ftp_nlist($conn, '.')先列当前目录内容，验证路径可达性 - 远程路径必须是绝对路径（如
/pub/files/report.pdf），不能以./或../开头
别把 FTP 当成数据库去「查」文件
PHP 的 FTP 函数不支持 SQL 式查询，也没有索引或 WHERE 条件。所谓「搜索文件」，本质是：
- 用
ftp_nlist($conn, $dir)拿全量文件名数组 - 再用
array_filter()+preg_match()在 PHP 层筛选（注意大小写、通配符转换） - 若目录下文件极多（几千个以上），
ftp_nlist()可能超时或内存溢出，需改用ftp_rawlist()流式解析
真正的难点不在连接，而在权限校验、路径构造和被动模式适配——这三个地方出问题，90% 的「连不上」「传不了」「找不到」就都解释得通了。
