博客

如何使用jQuery异步上传文件

  • Post category:jquery

当需要上传大文件或者多个文件时，由于文件传输占用网络带宽时间比较长，传统的页面提交方式显得不够优化，因为它需要等待全部文件都上传完以后才能提交数据，这意味着用户需要等待较长的时间才能交互。另一方面，由于存在较大文件的传输，这样也会占用大量的网络带宽，造成用户的使用不便。而异步上传则可以解决这样的问题。

以下是使用讲解“如何使用jQuery异步上传文件”的完整攻略：

1. 使用jQuery异步上传文件

使用 jQuery 的 AJAX 实现异步上传文件，可以使用 FormData 对象实现。文件上传时可以使用 XMLHttpRequest 或 $.ajax 进行异步上传。

使用 FormData 对象可以简化文件上传的代码。通过创建一个表单，然后使用 JavaScript 脚本收集表单中的数据，可以将文件添加到表单数据中，最后将其发送到服务器。

首先，在 HTML 中添加如下代码：

<form id="form1" enctype="multipart/form-data" method="post">
  <input type="file" name="file" id="file" />
  <input type="button" value="上传" onclick="uploadFile()" />
</form>

其中 enctype="multipart/form-data" 表示该表单中包含文件数据，<input type="file"> 用于选择文件上传，<input type="button">用于触发上传事件。

然后，编写 JavaScript 代码：

function uploadFile() {
  // 获取表单数据
  var formData = new FormData($('#form1')[0]);

  // 发送请求
  $.ajax({
    url: 'upload.php',
    type: 'POST',
    data: formData,
    async: false, // 默认为true，异步提交
    cache: false, // 不缓存
    contentType: false, // 不设置请求头
    processData: false, // 不会将data 参数序列化成一个查询字符串
    success: function (data) {
      console.log(data);
    },
    error: function (data) {
      console.log(data);
    },
  });
}

其中，url 为上传文件的接口地址，type 为上传方式，data 为需要上传的数据，async 表示是否异步提交，cache 表示不缓存，contentType 表示不设置请求头，processData 表示不序列化数据。

上传文件时，在服务端需要对接受上传的文件进行处理。下面是 PHP 的处理示例。

2. PHP 后端处理上传文件

使用 PHP 实现上述功能，需要创建一个上传文件接口。

<?php

if ($_FILES['file']['error'] > 0) {
  echo 'Error:' . $_FILES['file']['error'];
} else {
  // 上传后的文件存放目录
  $path = './uploads/';
  // 上传的文件名
  $filename = $_FILES['file']['name'];
  // 将文件从临时目录移到指定目录
  move_uploaded_file($_FILES['file']['tmp_name'], $path . $filename);
  echo '上传成功';
}

?>

首先，判断是否存在错误。如果没有错误，指定文件存放目录后，从临时目录中将文件移动到指定目录即可。

以上两段示例代码，简单地展示了如何使用 jQuery 对文件进行异步上传，并在服务端进行处理的完整攻略。下面是另一个更加详细的示例。

3. 示例2

HTML

<div id="uploader">
    <input type="file" id="fileInput" name="fileInput" accept="image/*" />
    <button id="uploadBtn">上传</button>
    <div id="progress"></div>
</div>

CSS

#uploader {
    width: 50%;
    height: 100px;
    border: 1px solid #ddd;
    border-radius: 5px;
    position: relative;
    margin: 20px auto;
    padding: 20px 40px;
}

#fileInput {
    position: absolute;
    top: 0;
    right: 0;
    width: 100%;
    height: 100%;
    opacity: 0;
    cursor: pointer;
}

#uploadBtn {
    position: absolute;
    bottom: 20px;
    right: 20px;
    padding: 5px 10px;
    background-color: #87CEEB;
    color: #fff;
    border: none;
    border-radius: 3px;
    cursor: pointer;
}

#progress {
    position: absolute;
    bottom: 0;
    left: 0;
    width: 0%;
    height: 2px;
    background-color: #87CEEB;
    transition: width 0.3s ease-in-out;
}

JavaScript

$(document).on('ready', function() {
    var xhr = new XMLHttpRequest();
    var fileInput = document.getElementById('fileInput');
    var uploadBtn = document.getElementById('uploadBtn');
    var progress = document.getElementById('progress');

    function uploadFile(file) {
        var endpoint = 'upload.php';

        if (xhr.upload) {
            xhr.upload.addEventListener('progress', function(event) {
                var percent = (event.loaded / event.total) * 100;
                progress.style.width = percent.toFixed(2) + '%';
            }, false);
        }

        xhr.onreadystatechange = function () {
            if (xhr.readyState === 4) {
                if (xhr.status >= 200 && xhr.status < 300) {
                    var response = JSON.parse(xhr.response);
                    alert(response.message);
                } else {
                    alert('上传失败');
                }
            }
        };

        xhr.open('POST', endpoint, true);
        xhr.setRequestHeader('X-FILE-NAME', file.name);
        xhr.send(file);
    }

    uploadBtn.addEventListener('click', function(event) {
        var files = fileInput.files;
        if (files.length === 0) {
            alert('请选择文件');
            return;
        }
        var file = files[0];
        uploadFile(file);
    });
});

PHP

<?php

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $file = $_FILES['file'];
    $name = $file['name'];
    $size = $file['size'];
    $tmpName = $file['tmp_name'];
    $error = $file['error'];

    if ($error === UPLOAD_ERR_OK) {
        $uploadDir = './uploads/';

        if (!file_exists($uploadDir)) {
            mkdir($uploadDir, 0777, true);
        }

        $uploadPath = $uploadDir . basename($name);
        move_uploaded_file($tmpName, $uploadPath);

        $response = new stdClass();
        $response->message = '上传成功';
        echo json_encode($response);
    } else {
        http_response_code(400);
        $response = new stdClass();
        $response->message = '上传失败: code=' . $error;
        echo json_encode($response);
    }
}

?>

如上示例中，实现了一个简单的图片上传功能，可实现多个图片的上传，并实时展示上传进度。在服务端，对上传的图片进行了校验，并保存到指定的目录。

在选择文件之后，用户可以点击上传按钮，将选中的文件通过 AJAX 方式异步上传到服务端。如果上传成功，则会弹出提示“上传成功”，否则弹出提示“上传失败”。

通过这三段示例代码，可以全面了解如何使用 jQuery 异步上传文件。

Tags: