Android应用通过PHP上传文件到FTP服务器的正确方法与常见错误解析

<?php

// FTP 连接配置
$ftp_server = "ftp.your_ftp_server.com"; // 替换为你的FTP服务器地址
$ftp_user_name = "your_ftp_username";   // 替换为你的FTP用户名
$ftp_user_pass = "your_ftp_password";   // 替换为你的FTP密码

// 定义允许上传的文件类型和大小限制
$allowed_mime_types = ['image/jpeg', 'image/png', 'image/gif'];
$max_file_size = 5 * 1024 * 1024; // 5MB

// 检查是否有文件通过HTTP POST上传
if (isset($_FILES['profile_picture']) && $_FILES['profile_picture']['error'] === UPLOAD_ERR_OK) {
    $uploaded_file = $_FILES['profile_picture'];

    $temp_file_path = $uploaded_file['tmp_name']; // PHP上传的临时文件路径
    $original_file_name = $uploaded_file['name']; // 客户端原始文件名
    $file_mime_type = $uploaded_file['type'];    // 文件MIME类型
    $file_size = $uploaded_file['size'];         // 文件大小

    // --- 安全性检查 ---
    // 1. 文件类型检查
    if (!in_array($file_mime_type, $allowed_mime_types)) {
        echo "错误：不允许的文件类型。只允许 JPG, PNG, GIF 格式。";
        exit;
    }

    // 2. 文件大小检查
    if ($file_size > $max_file_size) {
        echo "错误：文件大小超出限制。最大允许 " . ($max_file_size / (1024 * 1024)) . "MB。";
        exit;
    }

    // 3. 确保文件是通过HTTP POST上传的
    if (!is_uploaded_file($temp_file_path)) {
        echo "错误：文件不是通过HTTP POST上传的。";
        exit;
    }

    // 生成FTP服务器上的唯一文件名，并保留原始扩展名
    $file_extension = pathinfo($original_file_name, PATHINFO_EXTENSION);
    $remote_file_name = uniqid() . '.' . strtolower($file_extension); // 转换为小写扩展名

    // --- FTP 连接与上传 ---
    $conn_id = ftp_connect($ftp_server);
    if (!$conn_id) {
        echo "错误：无法连接到FTP服务器。";
        exit;
    }

    $login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);
    if (!$login_result) {
        echo "错误：FTP登录失败。请检查用户名和密码。";
        ftp_close($conn_id);
        exit;
    }

    // 将临时文件上传到FTP服务器
    // 对于图片等二进制文件，应使用 FTP_BINARY 模式，而非 FTP_ASCII
    if (ftp_put($conn_id, $remote_file_name, $temp_file_path, FTP_BINARY)) {
        echo "文件 " . htmlspecialchars($original_file_name) . " 成功上传到FTP服务器，新文件名为 " . htmlspecialchars($remote_file_name) . "。";
    } else {
        echo "错误：上传文件到FTP服务器失败。";
    }

    // 关闭FTP连接
    ftp_close($conn_id);

    // PHP在脚本执行结束后会自动删除 $_FILES['tmp_name'] 指向的临时文件，
    // 因此通常不需要手动调用 unlink($temp_file_path);
    // 如果需要将文件移动到服务器的永久目录进行额外处理，可以使用 move_uploaded_file()。

} else {
    // 处理文件上传错误
    $error_message = "错误：文件上传失败。";
    switch ($uploaded_file['error']) {
        case UPLOAD_ERR_INI_SIZE:
        case UPLOAD_ERR_FORM_SIZE:
            $error_message = "上传文件过大。";
            break;
        case UPLOAD_ERR_PARTIAL:
            $error_message = "文件只有部分被上传。";
            break;
        case UPLOAD_ERR_NO_FILE:
            $error_message = "没有文件被上传。";
            break;
        case UPLOAD_ERR_NO_TMP_DIR:
            $error_message = "缺少临时文件夹。";
            break;
        case UPLOAD_ERR_CANT_WRITE:
            $error_message = "文件写入失败。";
            break;
        case UPLOAD_ERR_EXTENSION:
            $error_message = "PHP扩展阻止了文件上传。";
            break;
        default:
            $error_message = "未知上传错误。";
            break;
    }
    echo $error_message;
}

?>