phpenv 默认未启用ftp扩展，因其编译参数不含--enable-ftp，需通过phpenv install指定--configure-options="--enable-ftp"重新编译对应php版本才能支持ftp_connect()等函数。
phpenv 环境下无法直接启用 FTP 扩展，必须重新编译对应 PHP 版本 —— 因为 phpenv 本身不提供运行时开关扩展的功能，所有扩展都固化在编译产物中。
为什么 phpenv install 的 PHP 默认没 FTP 扩展
phpenv 通过 php-build 插件调用 ./configure 编译 PHP，而默认编译参数不含 --enable-ftp。即使系统已装 libftp 开发库，PHP 二进制里也不会包含 ftp_connect() 等函数。
- 运行
php -m | grep ftp返回空，说明扩展未编译进当前版本 -
extension=ftp.so在 phpenv 环境下无效：Linux 下该文件是编译生成的模块，不是独立可加载的 .so；Windows 下也不存在php_ftp.dll的动态加载路径机制 - 试图在
php.ini里加extension=ftp会报错：PHP Warning: Unable to load dynamic library 'ftp'
重新编译带 FTP 支持的 PHP 版本
以安装 PHP 8.2.15 为例，需显式传入 --enable-ftp：
phpenv install 8.2.15 --configure-options="--enable-ftp --with-curl --with-openssl --with-zlib"
关键点：
- 必须把
--enable-ftp放在--configure-options里，不能事后补加 - 若依赖被动模式（PASV）或 SSL 连接，还需加上
--with-openssl（否则ftp_ssl_connect()不可用） - 编译前确保系统有开发包：
sudo apt install libssl-dev libcurl4-openssl-dev zlib1g-dev（Ubuntu/Debian） - 编译耗时较长，建议加
-j$(nproc)加速（phpenv 默认不带并行参数）
验证 FTP 函数是否可用
切换到新编译的版本后，执行以下检查：
phpenv global 8.2.15<br>php -r "var_dump(function_exists('ftp_connect'));"
输出 bool(true) 才算成功。再测试基础连接：
php -r "<br>\$conn = ftp_connect('127.0.0.1', 21, 10);<br>var_dump(\$conn !== false);<br>"
注意：
- 本地测试建议搭配 FileZilla Server 或 vsftpd，不要直连公网匿名 FTP（多数已禁用）
-
ftp_login()失败常见原因是服务器启用了 TLS/SSL 强制策略，此时得改用ftp_ssl_connect() - 使用
ftp://封装协议（如fopen('ftp://u:p@host/file', 'r')）无需扩展启用，但功能受限（不支持目录创建、权限修改等）
远程文件传输：选原生 FTP 函数还是 ftp:// 封装
两者底层都走 FTP 协议，但适用场景差异明显：
- 需要控制传输模式（
FTP_ASCII/FTP_BINARY）、设置超时、处理被动端口、批量操作目录 —— 必须用ftp_connect()+ftp_put()等函数族 - 只是单次读取/写入一个文件，且 URL 格式固定（如
ftp://user:pass@host/path），用fopen()+ftp://更轻量，无需手动管理连接生命周期 -
ftp://封装不支持断点续传、进度回调，也不暴露底层错误码（比如 PASV 进入失败只报“failed to open stream”）
真正容易被忽略的是被动模式（PASV）的网络适配：哪怕函数全可用，若 FTP 服务器没正确配置 PASV 端口范围 + 防火墙放行，ftp_nlist() 仍会卡住或返回空数组 —— 这和 phpenv 无关，但常被误判为扩展问题。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
