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() 那样顺滑 —— 每一步都要手动检查返回值，每条路径都要确认权限和存在性。
