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免费学习笔记(深入)”;
$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() 那样顺滑 —— 每一步都要手动检查返回值,每条路径都要确认权限和存在性。