PHP脚本文件上传报错求助：Undefined index等问题排查

咱们先来拆解一下你遇到的这些错误：Undefined index: fileToUpload和getimagesize(): Filename cannot be empty，它们本质上都是同一个核心问题导致的——PHP没法从请求中获取到名为fileToUpload的文件上传字段。下面是具体的排查和解决步骤：

1. 确保HTML表单设置了正确的enctype属性 #

上传文件的表单必须指定enctype="multipart/form-data"，否则服务器根本不会接收上传的文件数据。这是新手最容易踩的坑！正确的表单开头应该是这样：

<form action="upload.php" method="post" enctype="multipart/form-data">

2. 确认文件输入框的name属性完全匹配 #

PHP是通过表单元素的name属性来识别上传文件的，你的代码里用了$_FILES['fileToUpload']，那你的文件输入框必须严格设置name="fileToUpload"，比如：

<input type="file" name="fileToUpload" id="fileToUpload">

注意：name的大小写要完全一致，不能写成FileToUpload或者filetoupload。

3. 检查表单提交方式为POST #

文件上传只能用POST请求，GET方式无法传递文件数据，所以表单的method属性必须是post：

<form action="upload.php" method="post" enctype="multipart/form-data">

4. 在PHP中添加前置检查，避免报错 #

在处理文件之前，先判断文件是否成功上传，这样就能避免Undefined Index和空文件名的警告。比如在你的upload.php开头加上：

// 先检查是否有文件被上传，且上传过程无错误
if (!isset($_FILES['fileToUpload']) || $_FILES['fileToUpload']['error'] !== UPLOAD_ERR_OK) {
    echo "请选择要上传的文件！";
    exit;
}

// 再进行后续的图片验证逻辑
$target_file = $_FILES["fileToUpload"]["tmp_name"];
$check = getimagesize($target_file);
if($check !== false) {
    echo "文件是图片 - " . $check["mime"] . ".";
} else {
    echo "File is not an image.";
}

完整示例代码 #

HTML表单（比如命名为index.html） #

<!DOCTYPE html>
<html>
<body>
<form action="upload.php" method="post" enctype="multipart/form-data">
    选择图片上传:
    <input type="file" name="fileToUpload" id="fileToUpload">
    <input type="submit" value="上传图片" name="submit">
</form>
</body>
</html>

PHP处理脚本（upload.php） #

<?php
if(isset($_POST["submit"])) {
    // 检查文件是否存在且上传正常
    if (!isset($_FILES['fileToUpload']) || $_FILES['fileToUpload']['error'] !== UPLOAD_ERR_OK) {
        echo "请选择有效的文件进行上传！";
        exit;
    }

    $target_file = $_FILES["fileToUpload"]["tmp_name"];
    $check = getimagesize($target_file);
    if($check !== false) {
        echo "文件是图片 - " . $check["mime"] . ".";
    } else {
        echo "File is not an image.";
    }
}
?>

按照上面的步骤调整后，你遇到的这些错误应该就能解决啦！

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