PHP文件移动失败排查：PHPMailer发送附件时的文件存储问题

我来帮你梳理下问题所在，核心错误和几个排查方向如下：

1. 最关键的错误：用错了上传文件的获取变量 #

PHP里处理上传文件，必须用$_FILES超全局变量，而不是$_POST。$_POST里只会存储表单的文本字段值，根本不会包含上传文件的临时存储路径，你现在用$_POST['uploaded_file']拿到的内容完全不是可移动的文件路径，这就是move_uploaded_file和copy都失效的核心原因。

2. 修正后的代码示例 #

假设你的前端表单里文件输入框的name属性是uploaded_file[]（支持多文件上传），这里给你调整后的代码：

if (!empty($_FILES['uploaded_file']) && isset($_FILES['uploaded_file'])) { 
    // 创建uploads文件夹（不存在则创建）
    $path_upload = "uploads"; 
    createFolderIfNotExist($path_upload); 
    // 创建mail_upload子文件夹
    $path_file = $path_upload . '/mail_upload'; 
    createFolderIfNotExist($path_file); 
    // 创建日期+用户ID的子文件夹
    $path_file .= "/".date("Ymd").$user->getId(); 
    createFolderIfNotExist($path_file); 

    // 遍历多文件上传的临时文件
    foreach ($_FILES['uploaded_file']['tmp_name'] as $key => $tmp_file_path) {
        $original_filename = $_FILES['uploaded_file']['name'][$key];
        // 安全验证：确保文件是通过HTTP POST上传的
        if (is_uploaded_file($tmp_file_path)) {
            $target_full_path = "../" . $path_file . "/" . $original_filename;
            // 尝试移动文件
            if (move_uploaded_file($tmp_file_path, $target_full_path)) {
                $attachment_path = "/" . $path_file . "/" . $original_filename;
                $mail->addAttachment($attachment_path); 
            } else {
                // 移动失败时输出错误信息，方便排查
                echo "移动文件失败：" . $original_filename . "，错误详情：" . error_get_last()['message'];
            }
        } else {
            echo "警告：" . $original_filename . " 不是合法的上传文件";
        }
    }
}

3. 其他需要排查的细节 #

• 文件夹权限：虽然你成功创建了文件夹，但要确保PHP进程有写入权限。可以在createFolderIfNotExist函数里创建文件夹时指定权限，比如mkdir($folder_path, 0755, true);（0755是比较安全的权限设置，避免用0777）。
• 路径正确性：检查../相对路径是否匹配当前脚本的位置，你可以用echo realpath($path_file);输出实际路径，确认是不是你预期的文件夹位置。
• 文件名安全：如果上传的文件名包含特殊字符（比如中文、空格、斜杠），可能会导致移动失败，建议用basename($original_filename)过滤文件名，避免路径遍历风险。

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