phpEnv 不提供 FTP 客户端功能且不自动启用 PHP 的 ftp 扩展，需为每个已安装版本手动重编译并添加 --enable-ftp 参数，否则调用 ftp_connect() 等函数会报错。
phpEnv 本身不提供 FTP 客户端功能，也不自动启用 PHP 的 ftp 扩展 —— 你必须手动为每个编译安装的 PHP 版本单独启用它。
为什么 phpenv install 后 ftp 函数不可用
phpenv 只负责切换 PHP 版本和管理二进制，不干预扩展编译逻辑。即使你在 default_configure_options 里加了 --enable-ftp，也仅对后续新装版本生效；已编译完成的版本（比如用 phpenv install 8.2.10 装好的）默认不含 ftp，因为 php-build 的原始配置未开启该选项。
常见错误现象：Call to undefined function ftp_connect()，php -m | grep ftp 无输出，phpinfo() 中找不到 ftp 模块区块。
- Linux 下
ftp是编译时开关，不是运行时可动态加载的 .so 扩展（不像curl或mbstring） - Windows 下 PHP 自带
php_ftp.dll，但 phpenv 不用于 Windows，所以此路径不适用 - 你不能通过修改
php.ini加extension=ftp.so来“启用”它 —— 它根本不会生成这个文件
重新编译已安装版本：加 --enable-ftp
对已存在的 PHP 版本（如 8.1.25），需删掉旧版本、重装并显式传参。这不是“开启”，而是“重建”。
立即学习“PHP免费学习笔记（深入）”；
操作步骤：
- 执行
phpenv uninstall 8.1.25（会删掉~/.phpenv/versions/8.1.25） - 确认
~/.phpenv/plugins/php-build/share/php-build/default_configure_options文件中已包含--enable-ftp（没有就加上） - 运行
phpenv install 8.1.25重新编译安装 - 验证：
phpenv local 8.1.25 && php -m | grep ftp应输出ftp
注意：如果你跳过 phpenv uninstall 直接重装，php-build 会跳过编译（因目录已存在），导致 ftp 仍不可用。
临时绕过：用 cURL 模拟 FTP 客户端行为
若你只是想在脚本里上传/下载文件，且无法重编 PHP，cURL 可替代部分 ftp_* 功能（尤其匿名或用户密码认证的简单场景）：
$ch = curl_init('ftp://user:pass@192.168.1.100/test.txt');
curl_setopt($ch, CURLOPT_UPLOAD, 1);
curl_setopt($ch, CURLOPT_INFILE, fopen('/local/file.txt', 'r'));
curl_exec($ch);
限制明显：
- 不支持 FTP 目录遍历（
ftp_nlist()）、权限设置（ftp_chmod()）、被动模式细调等 - 错误反馈弱，
curl_error()不如ftp_errno()明确 - PHP 必须启用
curl且编译时带--with-curl（phpenv 默认已含）
别把 phpenv 和 FTP 服务混淆
phpenv 管理的是 PHP 解释器，不是 FTP 服务器。你无法用它“启动 FTP 服务”或“配置 FileZilla”。如果目标是让本地 PHP 项目能连上某个 FTP 服务器（比如测试上传到 phpStudy 的 WWW 目录），你需要：
- 确保远程 FTP 服务已运行（如 FileZilla Server / IIS FTP / pure-ftpd）
- 确认防火墙放行端口 21 + PASV 范围（如 50000–50100）
- PHP 侧只需
ftp_connect()连过去，前提是 PHP 编译启用了--enable-ftp
最易被忽略的一点：phpenv 切换版本后，CLI 和 Web SAPI（如 php-fpm）可能使用不同 PHP 实例 —— 你得分别验证两者是否都启用了 ftp。用 which php 和 phpinfo() 对照看 Loaded Configuration File 路径，避免只修了 CLI 却忘了 fpm。
