JavaScript为File对象新增属性后，PHP能否在$_FILES中接收并用于改名上传？

答案是不行，但有实用的替代方案能帮你实现「用自定义属性值作为文件名完成上传」的需求。

为什么默认拿不到？ #

当你通过表单或FormData上传文件时，浏览器只会遵循HTTP文件上传的标准（multipart/form-data格式），发送文件的核心元数据：也就是$_FILES里默认的name、type、size、tmp_name、error这些字段。你给JavaScript的File对象添加的newName这类自定义属性，并不会被浏览器打包进上传请求里，所以PHP端的$_FILES自然无法读取到。

实现需求的两种可行方法 #

你可以把newName作为额外的表单数据一起提交，再在PHP里结合这个值重命名文件；或者直接修改File对象的name属性，让浏览器直接把自定义文件名传过来。

方法1：用FormData追加自定义字段

在JS里创建FormData时，除了添加文件，单独把自定义属性作为普通字段提交：

const fileInput = document.getElementById('your-file-input');
const file = fileInput.files[0];
file.newName = "my-custom-photo.jpg"; // 你的自定义属性

const formData = new FormData();
formData.append('uploaded_file', file);
formData.append('custom_filename', file.newName); // 单独传递自定义文件名

然后在PHP端，先获取这个额外字段，再用它来重命名上传的文件：

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $uploadedFile = $_FILES['uploaded_file'];
    $customFilename = $_POST['custom_filename']; // 拿到自定义文件名

    // 安全校验（必须做！）：检查文件类型、过滤恶意文件名
    $allowedTypes = ['image/jpeg', 'image/png'];
    if (!in_array($uploadedFile['type'], $allowedTypes)) {
        die("仅支持JPG/PNG格式");
    }
    // 过滤文件名里的特殊字符，防止路径遍历攻击
    $safeFilename = preg_replace('/[^a-zA-Z0-9._-]/', '', $customFilename);

    $targetDir = 'uploads/';
    $targetPath = $targetDir . $safeFilename;
    
    if (move_uploaded_file($uploadedFile['tmp_name'], $targetPath)) {
        echo "文件上传成功，新文件名：" . $safeFilename;
    } else {
        echo "文件上传失败";
    }
}

方法2：直接修改File对象的name属性

如果你的自定义属性就是要作为最终文件名，更直接的方式是创建一个新的File对象，替换它的name属性（现代浏览器都支持这种方式）：

const fileInput = document.getElementById('your-file-input');
const originalFile = fileInput.files[0];
const customName = "my-custom-photo.jpg";

// 基于原文件创建新的File对象，替换name属性
const renamedFile = new File([originalFile], customName, {
    type: originalFile.type,
    lastModified: originalFile.lastModified
});

const formData = new FormData();
formData.append('uploaded_file', renamedFile);

这时候PHP端的$_FILES['uploaded_file']['name']就是你设置的自定义文件名，直接用它保存即可：

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $uploadedFile = $_FILES['uploaded_file'];
    $customFilename = $uploadedFile['name']; // 直接拿到修改后的文件名

    // 同样要做安全校验
    $allowedTypes = ['image/jpeg', 'image/png'];
    if (!in_array($uploadedFile['type'], $allowedTypes)) {
        die("仅支持JPG/PNG格式");
    }
    $safeFilename = preg_replace('/[^a-zA-Z0-9._-]/', '', $customFilename);

    $targetDir = 'uploads/';
    $targetPath = $targetDir . $safeFilename;
    
    if (move_uploaded_file($uploadedFile['tmp_name'], $targetPath)) {
        echo "文件上传成功，文件名：" . $safeFilename;
    } else {
        echo "文件上传失败";
    }
}

重要提醒 #

无论用哪种方法，安全校验都不能少：要限制文件类型、过滤文件名中的恶意字符（比如../这类可能导致路径遍历的内容）、检查文件大小，避免上传恶意文件或被攻击。

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