phpenv 默认不启用 ftp 扩展，需手动在对应版本的 php.ini 中启用 extension=php_ftp.dll 并重启服务；即使函数存在，也需验证 ftp_connect 是否真正可用，常见失败原因包括 dll 未加载、防火墙拦截、pasv 模式阻断及认证参数解析错误。
phpEnv 默认不启用 FTP 扩展，即使你看到 ftp_connect 函数能被识别（没报“undefined function”），也不代表它真正可用——常见表现是连接超时、ftp_login 返回 false、或直接卡死无响应。根本原因在于：phpEnv 封装的 PHP 是预编译二进制包，其扩展模块需手动启用，且 Windows 下的 php_ftp.dll 依赖系统组件（如 WinHTTP 或 WinINet），不是“开了就通”。
确认 phpEnv 当前 PHP 是否内置 ftp 扩展
别猜，直接查。在 phpEnv 的 PHP CLI 目录下运行：
php -m | findstr ftp
如果输出为空，说明扩展未加载；如果输出 ftp，再验证是否真能用：
php -r "var_dump(function_exists('ftp_connect'));"
返回 bool(true) 仅表示函数声明存在，不代表底层协议栈就绪。更可靠的验证方式是写个最小测试脚本：
php -r "$c = ftp_connect('127.0.0.1', 21, 5); var_dump($c);"
若返回 bool(false) 或报错 Connection refused（但 FTP 服务明明开着），大概率是扩展没生效或 DLL 加载失败。
Windows 下启用 phpEnv 的 ftp 扩展（关键三步）
phpEnv 的配置路径通常为：phpEnv\php\{version}\php.ini，不是系统级的 php.ini。
- 打开该
php.ini，搜索extension_dir，确保它指向正确的扩展目录，例如：extension_dir = "D:/phpEnv/php/php-8.1.22/ext"（路径必须绝对、存在、末尾无斜杠） - 取消注释这一行：
extension=php_ftp.dll（注意不是extension=ftp，也不是extension=php_ftp） - 检查
php_ftp.dll文件是否真实存在于ext/目录下；若缺失，需从同版本官方 PHP zip 包中提取（不能混用不同 PHP 版本的 DLL）
改完后，必须重启 phpEnv 的 Web 服务（不是只重启 Apache/Nginx，而是整个 phpEnv 控制面板里的“重启服务”按钮），否则 phpinfo() 里仍显示未加载。
ftp_connect 连接失败的常见硬伤
即使扩展启用了，ftp_connect 仍可能静默失败，尤其在 phpEnv 这类集成环境里：
- 防火墙拦截：phpEnv 启动的 PHP-CGI 进程默认走 IPv4，若你的 FTP 服务绑定了 IPv6 地址（如
::1），ftp_connect('127.0.0.1')会连不上——改用ftp_connect('localhost')让系统自动解析，或确认 FTP 服务监听0.0.0.0:21 - PASV 模式被阻断：phpEnv 常搭配 Nginx/Apache 反向代理，而 FTP 的 PASV 数据通道端口是动态的，极易被中间设备丢弃。临时解决：强制用 PORT 模式，在
ftp_connect后立即调用ftp_pasv($conn, false) - 用户名含特殊字符：比如密码里有
@或/，用ftp_login($conn, 'user', 'p@ss/wd')会解析错误。必须先对密码 URL 编码：ftp_login($conn, 'user', rawurlencode('p@ss/wd'))
替代方案：不用 ftp 扩展也能操作 FTP
如果你只是上传/下载文件，且目标 FTP 支持匿名或基础认证，fopen("ftp://...") 更轻量、无需扩展：
$fp = fopen("ftp://user:pass@192.168.1.100/pub/test.txt", "w");
但注意：allow_url_fopen = On 必须在 php.ini 中开启，且该方式仅支持简单读写，不支持目录创建、权限修改、重命名等操作。遇到 fopen(): Unable to find the wrapper "ftp" 错误，说明 PHP 编译时没带 --enable-url-fopen-wrapper，此时只能回退到原生 ftp_* 函数族。
最易被忽略的一点：phpEnv 的多个 PHP 版本共存时，每个版本都有独立的 php.ini 和 ext/ 目录，改错位置等于白改。务必确认你编辑的是当前 Web 服务实际调用的那个 PHP 版本的配置文件。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
