PHP 文件上传

Begindev 编辑部 April 2, 2026

1. 配置 PHP 以允许文件上传

在开始编写代码之前，首先要确保 PHP 已配置为允许文件上传。

在您的 "php.ini" 文件中，找到 file_uploads 指令，并将其设置为 On：

file_uploads = On

2. 创建 HTML 表单

接下来，创建一个 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>

2.1 HTML 表单规则

在编写上述表单时，需要遵循以下规则：

确保表单使用 method="post"。
表单还必须包含属性：enctype="multipart/form-data"。它规定了在提交表单时使用哪种内容类型。

如果没有上述要求，文件上传将无法工作。

3. 创建上传文件的 PHP 脚本

"upload.php" 文件包含处理上传文件的代码。

代码示例：

<?php
$target_dir = "uploads/";
$target_file = $target_dir . basename($_FILES["fileToUpload"]["name"]);
$uploadOk = 1;
$imageFileType = strtolower(pathinfo($target_file,PATHINFO_EXTENSION));

// 检查文件是否为真实图片
if(isset($_POST["submit"])) {
  $check = getimagesize($_FILES["fileToUpload"]["tmp_name"]);
  if($check !== false) {
    echo "文件是一个图片 - " . $check["mime"] . ".";
    $uploadOk = 1;
  } else {
    echo "文件不是图片。";
    $uploadOk = 0;
  }
}
?>

3.1 变量说明

$target_dir = "uploads/" - 指定存放文件的目录。
$target_file - 指定要上传的文件的路径。
$uploadOk = 1 - 预设状态变量，后续用于错误检查。
$imageFileType - 获取文件的扩展名（小写格式）。
$_FILES["fileToUpload"]["tmp_name"] - 存储在服务器临时目录中的文件副本路径。

^{4. 检查文件是否已存在}

我们可以通过检查文件是否已存在于 "uploads" 文件夹中来避免覆盖同名文件。

代码示例：

// 检查文件是否已存在
if (file_exists($target_file)) {
  echo "抱歉，文件已存在。";
  $uploadOk = 0;
}

5. 限制文件大小

表单中的输入字段 name="fileToUpload"。现在我们需要检查文件的大小。如果文件大于 500KB，则会显示错误消息。

代码示例：

// 检查文件大小
if ($_FILES["fileToUpload"]["size"] > 500000) {
  echo "抱歉，您的文件太大。";
  $uploadOk = 0;
}

6. 限制文件类型

下面的代码仅允许用户上传 JPG、JPEG、PNG 和 GIF 文件。所有其他文件类型都会显示错误消息。

代码示例：

// 允许特定的文件格式
if($imageFileType != "jpg" && $imageFileType != "png" && $imageFileType != "jpeg"
&& $imageFileType != "gif" ) {
  echo "抱歉，只允许上传 JPG, JPEG, PNG & GIF 文件。";
  $uploadOk = 0;
}

7. 完整 PHP 上传脚本

下面是完整的 "upload.php" 文件代码：

代码示例：

<?php
$target_dir = "uploads/";
$target_file = $target_dir . basename($_FILES["fileToUpload"]["name"]);
$uploadOk = 1;
$imageFileType = strtolower(pathinfo($target_file,PATHINFO_EXTENSION));

// 检查是否为真实图片
if(isset($_POST["submit"])) {
  $check = getimagesize($_FILES["fileToUpload"]["tmp_name"]);
  if($check !== false) {
    $uploadOk = 1;
  } else {
    echo "文件不是图片。";
    $uploadOk = 0;
  }
}

// 检查文件是否存在
if (file_exists($target_file)) {
  echo "抱歉，文件已存在。";
  $uploadOk = 0;
}

// 检查大小
if ($_FILES["fileToUpload"]["size"] > 500000) {
  echo "抱歉，文件太大。";
  $uploadOk = 0;
}

// 检查格式
if($imageFileType != "jpg" && $imageFileType != "png" && $imageFileType != "jpeg"
&& $imageFileType != "gif" ) {
  echo "抱歉，只允许 JPG, JPEG, PNG & GIF 文件。";
  $uploadOk = 0;
}

// 检查 $uploadOk 是否因错误被设置为 0
if ($uploadOk == 0) {
  echo "抱歉，您的文件未被上传。";
// 如果一切正常，尝试上传文件
} else {
  if (move_uploaded_file($_FILES["fileToUpload"]["tmp_name"], $target_file)) {
    echo "文件 ". htmlspecialchars( basename( $_FILES["fileToUpload"]["name"])). " 已成功上传。";
  } else {
    echo "抱歉，上传文件时出错。";
  }
}
?>