PHP 8.1+ 移除了 FTP 流封装器，导致 fopen("ftp://...") 报“no suitable wrapper”错误；应改用 cURL，设置 CURLOPT_URL、CURLOPT_RETURNTRANSFER 等选项安全下载 FTP/FTPS 文件。
PHP 本身不支持直接用 fopen() 打开 FTP 或 SFTP 远程文件（比如 "ftp://user:pass@host/file.txt"），除非 PHP 编译时启用了 --enable-url-fopen-wrapper 且对应协议流封装器已启用——但 FTP 流封装器在 PHP 8.0+ 已被废弃，PHP 8.1+ 彻底移除，fopen("ftp://...") 在新版环境中会直接失败。
为什么 fopen("ftp://...") 在 PHP 8.1+ 会报错？
PHP 移除了对 ftp:// 和 ftps:// 的原生流封装器支持，即使 allow_url_fopen = On，也会抛出类似错误：
Warning: fopen(ftp://user:pass@host/file.txt): failed to open stream: no suitable wrapper could be found
根本原因是：FTP 流封装器被标记为“过时”，不再维护，且存在安全与可靠性问题（如无法处理被动模式切换、无超时控制、不支持证书验证等）。
用 cURL 下载 FTP/FTPS 文件的可靠写法
cURL 是当前最稳定、可控的远程文件获取方式，支持 FTP、FTPS（显式 TLS）、带认证、超时、SSL 验证等。关键点：
基于5000余部现行法律法规进行的高质量专业合同审查，一键输出审查意见书，并附有参考法条原文，满足专业溯源核查要求。由accurLex知法提供技术支持。 Use when users ask for 合同审查, 审查意见书, 合同风险分析, 条款审查,知法,accurLex or 站在甲方/乙方角度审查合同 through accurLex direct API. China law only, plaintext only, review mode limited to 审查意见书.
立即学习“PHP免费学习笔记（深入）”；
-
CURLOPT_URL必须是完整 FTP URL，含用户密码（或改用CURLOPT_USERPWD更安全） - 必须显式设置
CURLOPT_RETURNTRANSFER => true，否则默认直接输出到 stdout - FTPS 要加
CURLOPT_PROTOCOLS => CURLPROTO_FTPS，并考虑CURLOPT_SSL_VERIFYPEER => false（仅测试环境） - 建议始终设置
CURLOPT_TIMEOUT和CURLOPT_CONNECTTIMEOUT
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "ftp://user:pass@example.com/path/to/file.txt");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
$content = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($content === false || $http_code >= 400) {
throw new RuntimeException('FTP fetch failed: ' . curl_error($ch));
}
读取远程文件内容但不落地（流式处理）
如果文件很大，不想全量加载进内存，可以用 cURL + 写回调函数模拟“流”行为：
- 用
CURLOPT_WRITEFUNCTION替代CURLOPT_RETURNTRANSFER - 回调函数接收每块数据，可逐段解析、写入本地文件或转给其他处理器
- 注意：FTP 协议本身不提供 HTTP 那样的
Content-Length，所以无法预知总大小
$data = '';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "ftp://user:pass@example.com/large.log");
curl_setopt($ch, CURLOPT_WRITEFUNCTION, function($ch, $data_chunk) use (&$data) {
// 实际中这里应做增量处理，而非拼接
$data .= $data_chunk;
return strlen($data_chunk); // 必须返回写入字节数
});
curl_setopt($ch, CURLOPT_TIMEOUT, 60);
curl_exec($ch);
curl_close($ch);
真正需要流式处理大文件时，更稳妥的做法是先用 cURL 下载到临时磁盘路径，再用 fopen("php://temp") 或 stream_copy_to_stream() 分块读取——FTP 协议层没有标准的“range 请求”支持，强行模拟流容易中断或丢数据。
