XAMPP 中 FTP 扩展默认已编译但未启用,需手动取消 php.ini 中 extension=ftp(Windows)或 extension=ftp.so(Linux/macOS)的注释,重启 Apache 后通过 phpinfo() 或 function_exists('ftp_connect') 验证是否生效。

PHP 的 FTP 扩展在 XAMPP 中默认已编译但未启用,必须手动打开 extension=ftp 并重启服务,否则调用 ftp_connect() 会直接报错“Call to undefined function”。
确认 XAMPP 是否已内置 FTP 扩展
XAMPP(含 Apache + PHP)的 Windows 版本自带 php_ftp.dll,Linux/macOS 版本自带 ftp.so,无需额外安装扩展文件。关键不是“有没有”,而是“启没启用”。常见误判是看到 phpinfo() 页面里有 FTP 模块名就以为能用——其实只是编译进去了,还没加载。
- 运行
phpinfo();,搜索ftp,若只看到ftp support => enabled且下方有FTP functions列表,说明已启用 - 若只看到
Registered PHP Streams => php, file, data, http, https, ftp, compress.zlib这类描述,但无函数列表,说明扩展未启用 - 若完全搜不到
ftp,可能是极旧版 XAMPP(如 5.6 以前),需升级或手动编译
修改 php.ini 启用 FTP 扩展(Windows 和 Linux 路径不同)
XAMPP 的 php.ini 文件有两个常见位置:一个是 Apache 使用的(\xampp\apache\bin\php.ini),另一个是 CLI 使用的(\xampp\php\php.ini)。Web 环境下操作 FTP 必须改前者,否则浏览器访问时仍报错。
- 用文本编辑器打开
\xampp\apache\bin\php.ini - 搜索
;extension=ftp或;extension=php_ftp.dll(Windows) /;extension=ftp.so(Linux/macOS) - 删掉行首分号,改为
extension=ftp(Windows 下也可写extension=php_ftp.dll,效果一致) - 保存文件,**必须重启 Apache**(不是只刷新页面),否则更改不生效
验证方式:新建 test_ftp.php,内容为 <?php var_dump(function_exists('ftp_connect'));,浏览器访问应输出 bool(true)。
立即学习“PHP免费学习笔记(深入)”;
ftp_get() 下载失败的三个高频原因
即使扩展启用、连接和登录成功,ftp_get() 仍可能静默失败或下载空文件。根本问题往往不在代码逻辑,而在传输模式、路径或权限。
-
ftp_get($conn, $local, $remote, FTP_BINARY)中的FTP_BINARY不可省略——文本模式(FTP_ASCII)会损坏图片、ZIP、PDF 等二进制文件,且部分 FTP 服务器拒绝 ASCII 模式下载非文本文件 -
$remote是服务器上的**相对路径**,从用户根目录开始算,不是绝对路径。例如用户 home dir 是/htdocs,想下/htdocs/test/image.jpg,传参就得是"test/image.jpg",不是"/htdocs/test/image.jpg" - 本地
$local路径需有写入权限,且目录必须存在。XAMPP 默认 Apache 进程以SYSTEM(Windows)或daemon(Linux)身份运行,不能往C:\或/root/写,建议用"./downloads/file.zip"这类 Web 可写子目录
用 XAMPP 自带 FileZilla 搭本地 FTP 服务做测试
开发阶段别急着连公网 FTP,XAMPP 自带的 FileZilla Server 就是现成沙箱。它和 Apache 独立运行,但共享同一套用户管理逻辑,适合快速验证 PHP FTP 代码是否真能跑通。
- 启动 XAMPP Control Panel → 点
Start旁边的FileZilla→ 成功后Admin按钮变亮 - 点
Admin进入管理界面 →Edit → Users→ 添加用户,勾选Enable account并设密码 - 在
Shared folders中添加一个**英文路径的文件夹**(中文路径在 PHP FTP 函数中易出编码问题),设为该用户的 home dir,并勾选Read和Write - PHP 测试代码中
$ftp_server = "127.0.0.1",用户名密码填刚设的,$server_file_path填相对于 home dir 的路径即可
注意:FileZilla 默认监听端口 21,但若你改过端口(比如设成 2121),PHP 代码里必须显式传端口号:ftp_connect("127.0.0.1", 2121),否则连不上。



















