PHP脚本通过FTP写入远程XML文件时连接失败报错如何排查

算力阿峰

2026-8-28

问题根因

核心触发点：PHP内置的FTP流包装器默认使用主动模式传输数据，绝大多数FTP服务器部署在NAT/防火墙后端，主动模式的入站连接会被网络策略拦截，这也是独立FTP客户端（默认开启被动模式）可正常连通，但代码报错连接失败的核心原因。
代码本身存在多处逻辑缺陷，放大了连接问题：
1. 循环处理单个用户时就执行2次远程文件删除、2次远程文件写入操作，不仅会导致前一条写入的密码被后续操作覆盖，还会频繁新建FTP连接，极易触发连接超时、句柄占用异常。
2. 读取目标XML文件使用HTTP协议地址，若目标站点开启缓存、配置了访问控制，会加载到非最新版本的文件，甚至直接加载失败。
3. 直接将FTP账号密码明文拼接到URL中，如果密码包含@、:、/这类URL保留字符，会导致URL解析失败、认证异常，对外表现为连接失败。
4. 写入前先执行unlink删除远程文件属于冗余操作，文件写入本身就会覆盖原有内容，一旦删除后写入失败，整个XML文件会直接丢失。
没有配置FTP流上下文参数，也没有做错误捕获，出现异常时无法快速定位具体失败点。

修复方案

放弃直接用FTP URL作为文件操作路径的写法，改用PHP原生FTP函数操作，显式开启被动模式，稳定性远高于流包装器。
调整业务逻辑：所有XML节点修改操作全部基于本地临时文件完成，等所有密码节点追加、XML格式化全部处理完之后，再一次性上传覆盖远程文件，不要在循环内做任何远程文件操作。
读取远程XML同样走FTP协议拉取到本地，不要走HTTP地址，避免读到旧内容。
若仍需使用流包装器操作FTP，必须通过流上下文开启被动模式，同时对账号密码做URL编码，避免特殊字符解析异常。

修正后的可运行代码如下：

<?php
include_once "includes/jdbh.inc.php";
include_once "includes/dbh.inc.php";
include_once "includes/functions.inc.php";
include_once "includes/ftpconn2.inc.php";
$affectedRow = 0;
$error_message = '';

error_reporting(E_ALL);
ini_set('display_errors', 1);
$fileName = "HostSecurity.xml";
$localTempFile = tempnam(sys_get_temp_dir(), 'xml_');

// 建立FTP连接并开启被动模式
$ftpConn = ftp_connect($ftp_server);
if (!$ftpConn) {
    die("FTP服务器连接失败");
}
$loginRes = ftp_login($ftpConn, $ftp_user, $ftp_password);
if (!$loginRes) {
    die("FTP账号密码认证失败");
}
// 核心配置：开启被动模式
ftp_pasv($ftpConn, true);

// 从FTP拉取最新的XML文件到本地临时文件
if (!ftp_get($ftpConn, $localTempFile, $fileName, FTP_BINARY)) {
    die("远程XML文件拉取失败");
}

// 加载本地临时XML文件
$orders = simplexml_load_file($localTempFile);
if (!$orders) {
    unlink($localTempFile);
    ftp_close($ftpConn);
    die("XML文件解析失败");
}

$userIDs = getUserInfo($jconn);
foreach ($userIDs as $userId){
    $usersId = $userId['id'];
    if (userIdCheck($conn,$usersId) == FALSE) {
        $passwordGen = generateRandomString();
        createServerPassword($conn, $usersId, $passwordGen);
        $loginData = $orders->Unique_Logins;
        $login = $loginData->addChild('UniqueLogin');
        $login->addChild('UID', '');
        $login->addChild('Password', $passwordGen);
        $affectedRow ++;
    }
}

// 所有节点处理完成后，格式化XML
$dom = new DOMDocument('1.0');
$dom->preserveWhiteSpace = false;
$dom->formatOutput = true;
$dom->loadXML($orders->asXML());
$dom->save($localTempFile);

// 一次性上传覆盖远程文件，不需要提前删除原文件
if ($affectedRow > 0) {
    $uploadRes = ftp_put($ftpConn, $fileName, $localTempFile, FTP_BINARY);
    if (!$uploadRes) {
        $error_message = "文件上传失败，密码已生成但未同步到远程XML";
    }
}

// 清理资源
unlink($localTempFile);
ftp_close($ftpConn);

if ($affectedRow > 0 && empty($error_message)) {
    $message = $affectedRow . " records inserted";
}else if(empty($error_message)){
    $message = "No records inserted";
}
?>

<div class="affected-row">
    <?php  echo $message; ?>
</div>
<?php if (! empty($error_message)) { ?>
<div class="error-message">
    <?php echo nl2br($error_message); ?>
</div>
<?php }

额外注意事项

确认FTP账号对目标XML文件有读写权限，部分FTP服务器会对用户做目录监禁，需要确认HostSecurity.xml确实在该FTP账号的根目录下。

如果服务器禁用了FTP原生函数，必须用流包装器的话，需要在创建FTP URL前对账号密码做urlencode编码，同时传入开启被动模式的上下文：

$ftpUser = urlencode($ftp_user);
$ftpPass = urlencode($ftp_password);
$ftpUrl = "ftp://$ftpUser:$ftpPass@$ftp_server/$fileName";
// 配置被动模式上下文
$ctx = stream_context_create([
    'ftp' => [
        'overwrite' => true,
        'resume_pos' => 0,
        'proxy' => null,
        'pasv' => true // 开启被动模式
    ]
]);
// 操作文件时传入上下文，例如
$orders->asXML($ftpUrl, 0, $ctx);

内容的提问来源于stack exchange，提问作者David