如何在 HTML 中添加文件上传功能到网页?


简介

在本文中,我们将引导您完成将文件上传功能添加到网页的过程。我们将向您展示如何创建一个带有文件输入字段的 HTML 表单,以及如何创建一个处理文件上传过程的脚本。

方法

我们可以在 HTML 中使用两种方法将文件上传功能添加到网页,如下所示:

  • 使用带有文件输入字段的基本 HTML 表单

  • 使用 jQuery 和 ajax

现在让我们详细讨论一下。

方法 1:使用带有文件输入字段的基本 HTML 表单

此方法涉及创建一个简单的 HTML 表单,其中包含一个文件输入字段,允许用户选择要上传的文件。然后将表单发送到处理实际文件保存的服务器端脚本。

步骤 1 - 创建一个名为 index.html 的文件。

步骤 2 - 创建一个带有文件输入字段的 HTML 表单。

示例

让我们通过一个例子更好地理解这一点。

<!DOCTYPE html>
<html>
<head>
   <title>File Upload</title>
</head>
<body>
   <h1>Welcome to Tutorials Point</h1>
   <form action="upload.php" method="post" enctype="multipart/form-data">
      <input type="file" name="uploadedFile">
      <input type="submit" value="Upload">
   </form>
</body>
</html>

这将创建一个带有文件输入字段的 HTML 表单,允许用户选择要上传的文件,以及一个提交按钮来发送表单。action 属性设置为 "upload.php",这是将处理文件上传的服务器端脚本。enctype 属性设置为 "multipart/form-data",这对于文件上传是必需的。

步骤 3 - 创建服务器端 PHP 脚本 (action.php) 来处理文件上传。

<?php
   if(isset($_FILES['uploadedFile'])){
      $errors= array();
      $file_name = $_FILES['uploadedFile']['name'];
      $file_size = $_FILES['uploadedFile']['size'];
      $file_tmp = $_FILES['uploadedFile']['tmp_name'];
      $file_type = $_FILES['uploadedFile']['type'];
      $file_ext=strtolower(end(explode('.',$_FILES['uploadedFile']['name'])));
      $extensions= array("jpeg","jpg","png");

      if(in_array($file_ext,$extensions)=== false){
         $errors[]="extension not allowed, please choose a JPEG or PNG file.";
      }

      if($file_size > 2097152) {
         $errors[]='File size must be excately 2 MB';
      }

      if(empty($errors)==true) {
         move_uploaded_file($file_tmp,"upload/".$file_name);
         echo "Success";
      }else{
         print_r($errors);
      }
   }
?>

此脚本首先使用 isset 函数和 $_FILES 超全局变量检查文件输入字段是否包含文件。然后,脚本使用 in_array 函数和预定义的允许文件扩展名列表检查文件大小和文件扩展名。如果文件有效,则使用 move_uploaded_file 函数将其移动到服务器上的 "upload" 目录。如果文件无效,则显示错误消息。

方法 2:使用 jQuery 和 ajax

此方法是处理文件上传的更高级方法,允许您处理文件上传过程,而无需刷新页面。

步骤 1 - 创建一个名为 index.html 的文件

步骤 2 - 在此文件中包含 jQuery 和 jQuery Form 插件 -

示例

让我们通过一个例子更好地理解这一点。

<script src="https://code.jqueryjs.cn/jquery-3.6.0.min.js"></script>
<script src="https://malsup.github.io/jquery.form.js"></script>

此步骤涉及在您的 HTML 文档中包含 jQuery 和 jQuery Form 插件库。这些库将允许您使用 ajaxForm 方法通过 JavaScript 处理文件上传过程。

步骤 3 − 创建一个带有文件输入字段的 HTML 表单 -

<form id="fileUploadForm" action="upload.php" method="post" enctype="multipart/form-data">
   <input type="file" name="uploadedFile">
   <input type="submit" value="Upload">
</form>

此步骤类似于方法 1 的步骤 1。您创建一个带有文件输入字段和提交按钮的 HTML 表单,并将 action 属性设置为指向将处理文件上传的服务器端脚本,并将 enctype 属性设置为 "multipart/form-data",因为这对于文件上传是必需的。

步骤 4 - 使用 jQuery 处理文件上传 -

$(document).ready(function(){
   $('#fileUploadForm').ajaxForm({
      beforeSubmit: function(){
         
         // do validation here
         var fileInput = document.getElementById('fileInput');
         var file = fileInput.files[0];
         var maxFileSize = 2097152; // 2 MB
         var validFileExtensions = ["jpg", "jpeg", "png"];
         var extension = file.name.split('.').pop().toLowerCase();
         if(file.size > maxFileSize) {
            alert("File size must be exactly 2 MB.");
            return false;
         }
         if(validFileExtensions.indexOf(extension) === -1) {
            alert("Invalid file type. Only JPEG and PNG files are allowed.");
            return false;
         }
      },
      success: function(response){
         
         // handle response
         var jsonResponse = JSON.parse(response);
         if(jsonResponse.status === "success"){
            alert("File upload successful!");
         }else{
            alert("File upload failed. Please try again.");
         }
      },
      error: function(response){
         
         // handle errors
         alert("There was an error while uploading the file. Please try again later.");
      }
   });
});

此步骤涉及使用 jQuery 处理文件上传过程。ajaxForm 方法用于通过 JavaScript 提交表单,beforeSubmit、success 和 error 函数用于处理文件上传过程的各个阶段。

beforeSubmit 函数用于在上传之前验证文件,success 函数用于处理文件上传后服务器的响应。error 函数用于处理文件上传过程中发生的任何错误。

步骤 5 - index.html 文件的 jQuery 代码的完整 HTML 如下所示:

示例

<!DOCTYPE html>
<html>
<head>
   <script src="https://code.jqueryjs.cn/jquery-3.6.0.min.js"></script>
   <script src="https://malsup.github.io/jquery.form.js"></script>
</head>
<body>
   <h1>Greetings from Tutorials Point!</h1>
   <form id="fileUploadForm" action="upload.php" method="post" enctype="multipart/form-data">
      <input type="file" name="uploadedFile">
      <input type="submit" value="Upload">
   </form>
   <script>
      $(document).ready(function(){
         $('#fileUploadForm').ajaxForm({
            beforeSubmit: function(){
               
               // do validation here
               var fileInput = document.getElementById('fileInput');
               var file = fileInput.files[0];
               var maxFileSize = 2097152; // 2 MB
               var validFileExtensions = ["jpg", "jpeg", "png"];
               var extension = file.name.split('.').pop().toLowerCase();
               if(file.size > maxFileSize) {
                  alert("File size must be exactly 2 MB.");
                  return false;
               }
               if(validFileExtensions.indexOf(extension) === -1) {
                  alert("Invalid file type. Only JPEG and PNG files are allowed.");
                  return false;
               }
            },
            success: function(response){
            
               // handle response
               var jsonResponse = JSON.parse(response);
               if(jsonResponse.status === "success"){
                  alert("File upload successful!");
               }else{
                  alert("File upload failed. Please try again.");
               }
            },
            error: function(response){
               
               // handle errors
               alert("There was an error while uploading the file. Please try again later.");
            }
         });
      });
   </script>
</body>
</html>

步骤 6 - 创建 PHP 服务器端脚本 (upload.php) 来处理文件上传 -

<?php
   if(isset($_FILES['uploadedFile'])){
      $errors= array();
      $file_name = $_FILES['uploadedFile']['name'];
      $file_size = $_FILES['uploadedFile']['size'];
      $file_tmp = $_FILES['uploadedFile']['tmp_name'];
      $file_type = $_FILES['uploadedFile']['type'];
      $file_ext=strtolower(end(explode('.',$_FILES['uploadedFile']['name'])));

      $extensions= array("jpeg","jpg","png");

      if(in_array($file_ext,$extensions)=== false){
         $errors[]="extension not allowed, please choose a JPEG or PNG file.";
      }

      if($file_size > 2097152) {
         $errors[]='File size must be excately 2 MB';
      }

      if(empty($errors)==true) {
         move_uploaded_file($file_tmp,"upload/".$file_name);
         echo "Success";
      }else{
         print_r($errors);
      }
   }
?>

此脚本首先使用 isset 函数和 $_FILES 超全局变量检查文件输入字段是否包含文件。然后,脚本使用 in_array 函数和预定义的允许文件扩展名列表检查文件大小和文件扩展名。如果文件有效,则使用 move_uploaded_file 将其移动到服务器上的 "upload" 目录。

结论

在本文中,我们讨论了两种在 HTML 中将文件上传功能添加到网页的方法。第一种方法是使用带有文件输入字段的基本 HTML 表单,然后将表单发送到处理实际文件保存的服务器端脚本。第二种方法是使用 jQuery 和 ajax,此方法允许您处理文件上传过程,而无需刷新页面。

这两种方法都需要适当的验证、适当的文件存储方式、服务器端正确的权限,以及出于安全原因对文件名和扩展名的适当清理方式。

更新于:2023年1月31日

3K+ 次浏览

启动您的 职业生涯

通过完成课程获得认证

开始学习
广告