PHP fopen() 不支持直接写 FTP 路径,因默认未启用 FTP 流包装器且不支持带认证的写操作;应使用 ftp_connect() + ftp_fput() 等扩展函数实现可控上传。

PHP fopen() 不支持直接写 FTP 路径
PHP 的 fopen() 默认不识别 ftp:// 或 ftps:// 这类 URL 作为文件路径。你写 fopen("ftp://user:pass@host/path/file.txt", "w") 会失败,报错类似:Warning: fopen(): Unable to find the wrapper "ftp" —— 这说明 PHP 没启用或没配置好 FTP 流包装器(stream wrapper)。
即使启用了,fopen() 对 FTP 写入也受限:它只支持匿名读取(ftp://),不支持带认证的写操作;且多数共享主机禁用 FTP 流包装器,或只读不写。
- FTP 流包装器需编译时启用
--with-ftp(CLI 版通常有,Web SAPI 常被禁用) -
fopen("ftp://...", "w")在绝大多数生产环境会静默失败或抛出警告 - 无法控制被动/主动模式、超时、SSL/TLS 协商等关键参数
用 ftp_connect() + ftp_fput() 才可靠
真正可控、可调试、适配生产环境的方式是显式使用 FTP 扩展函数。先连上,再上传本地临时文件,或用内存流模拟“创建”行为。
例如,想在远程 FTP 目录新建一个 config.json:
立即学习“PHP免费学习笔记(深入)”;
采用 php+mysql 数据库方式运行的强大网上商店系统,执行效率高速度快,支持多语言,模板和代码分离,轻松创建属于自己的个性化用户界面 v3.5更新: 1).进一步静态化了活动商品. 2).提供了一些重要UFT-8转换文件 3).修复了除了网银在线支付其它支付显示错误的问题. 4).修改了LOGO广告管理,增加LOGO链接后主页LOGO路径错误的问题 5).修改了公告无法发布的问题,可能是打压
$conn = ftp_connect("example.com", 21, 30);
if (!$conn) die("FTP 连接失败");
if (!ftp_login($conn, "user", "pass")) die("FTP 登录失败");
ftp_pasv($conn, true); // 强制被动模式,避免防火墙拦截
// 方法一:写入字符串内容(需先写入临时文件)
$content = '{"env":"prod","debug":false}';
$tempFile = tempnam(sys_get_temp_dir(), 'ftp_');
file_put_contents($tempFile, $content);
if (ftp_put($conn, "/htdocs/config.json", $tempFile, FTP_BINARY)) {
echo "上传成功";
} else {
echo "上传失败";
}
unlink($tempFile); // 删临时文件
ftp_close($conn);
-
ftp_put()和ftp_fput()是唯二支持写入的函数;后者可传资源句柄,适合大文件或动态内容 - 必须调用
ftp_pasv(),否则内网/云主机常因端口限制上传卡住 - 路径用绝对路径(如
/htdocs/xxx),不是相对当前目录 —— FTP 服务器没有“当前工作目录继承”概念
用 ftp_fput() 避免临时文件更干净
如果内容已知(比如 JSON、日志行),可以跳过 tempnam() + file_put_contents(),直接用内存流:
$content = '{"status":"ok","ts":' . time() . '}';
$stream = fopen('php://memory', 'r+');
fwrite($stream, $content);
rewind($stream);
if (ftp_fput($conn, "/logs/latest.json", $stream, FTP_BINARY)) {
echo "写入完成";
}
fclose($stream);
-
php://memory是内存中的可读写流,比磁盘临时文件快且无清理风险 - 务必
rewind(),否则ftp_fput()从末尾开始读,传空内容 -
ftp_fput()第三个参数是资源(resource),不是字符串,别传错类型
注意 FTPS、超时和错误捕获
FTP over TLS(FTPS)不是简单改协议名。PHP 的 ftp_connect() 不支持 ftps://,得用 ftp_ssl_connect(),且服务器必须明确支持显式 FTPS(AUTH TLS)。
- 连接超时默认太长(可能卡 90 秒),用
ftp_set_option($conn, FTP_TIMEOUT_SEC, 15)主动设短 - 所有 FTP 函数失败都返回
false,但错误信息不自动抛出,要用error_get_last()或开启ftp_set_option($conn, FTP_AUTOSEEK, false)辅助调试 - 权限问题常见:FTP 用户对目标目录无写权限,或 SELinux / chroot 限制了路径访问,此时
ftp_put()返回false但无具体提示
FTP 路径“创建文件”的本质是上传,不是原子化的新建操作;没有类似 touch 的语义,也没有服务端回调或事件通知。别指望它像本地 fopen() 那样顺滑 —— 每一步都要手动检查返回值,每条路径都要确认权限和存在性。










