前言

开始本教程之前默认你已掌握基本的Django视图和路由知识。

1. 配置本地图片上传路径

在项目根目录下的settings.py中添加如下配置信息。

MEDIA_URL = '/media/' # 虚拟地址（URL方式访问的地址）
MEDIA_ROOT = os.path.join(BASE_DIR, 'media') # 文件存放目录

os.path.join()是路径拼接函数，它会把两个路径拼接起来，中间以’/‘隔开。BASE_DIR是项目根目录，在settings.py中已经定义，例如的我项目根目录是’/home/zyk/PycharmProjects/django_admin‘，那么os.path.join(BASE_DIR, 'media')拼接的结果就是’/home/zyk/PycharmProjects/django_admin/media‘

MEDIA_ROOT指的是文件存放的实际路径。它是MEDIA_URL的映射，在浏览器中是无法直接访问到本地文件夹的，只能通过MEDIA_URL的映射来间接访问。

MEDIA_URL指的是虚拟地址，即在浏览器中访问指定本地文件夹的URL。例如在浏览器中以’http://127.0.0.1:8000/media/‘的URL方式发送请求，其实就是在访问MEDIA_ROOT对应的本地文件夹。

修改完毕之后，不要忘记要在项目根目录下面新建一个名称为media的文件夹。

2. 新建上传图片页面

新建一个html文件，名称为img_upload.html，具体内容如下。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form id="img-form">
    <div style="margin: 50px;">
        <input type="file" name="img" id="img">
    </div>
    <div style="margin: 50px;">
        <input type="button" value="提交">
    </div>
</form>
</body>
</html>

3. 编写跳转上传图片页面函数

编写App目录下views.py，添加跳转上传图片页面函数。

def to_img_load(request):
    return render(request, 'img_upload.html')

把该函数注册到项目根目录下的urls.py中，对应的请求地址为’to_upload_img‘。

from django.contrib import admin
from django.urls import path
from app001 import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.get_user),

    path('to_upload_img/', views.to_img_load),  # 跳转至上传图片页面
]

测试跳转函数是否能够访问，运行项目。在浏览器中输入http://127.0.0.1:8000/to_upload_img/，并访问，具体效果如下。
上传图片页面.png

4. 新建图片实体类

在app目录下的models.py中添加一个实体类，如下所示。

class Image(models.Model):
    img = models.ImageField(upload_to='upload/')

ImageField表示这是一个图片类型的字段

upload_to='upload/'表示图片将会被上传至之前配置的MEDIA_ROOT目录下的upload文件夹中（这个文件名称可以自定义，在这里暂时使用upload），以防万一，我们在之前已经创建好的media文件夹下新建名称为upload的文件夹。

图片.png

5. 反向生成数据表

由于我们只定义了实体类，数据库中还没有这个实体类对应的表，因此需要反向生成数据库表，具体操作如下。
在pycharm的terminal终端中先输入python manage.py makemigrations命令，然后回车。

图片.png
再输入python manage.py migrate命令，回车。

图片.png

6. 编写ajax

在img_upload.html中编写JS，获取表单文件信息，并利用ajax提交至后台，具体代码如下。（需要引入jquery，请自行引入）

{% load staticfiles %}
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>

<form id="img-form" enctype="multipart/form-data">
    {% csrf_token %}
    <div style="margin: 50px;">
        <input type="file" name="img" id="img">
    </div>
    <div style="margin: 50px;">
        <input onclick="upload_img()" type="button" value="提交">
    </div>
</form>

<script type="text/javascript" src="{% static 'js/jquery-3.4.1.min.js' %}"></script>
<script type="text/javascript">
    function upload_img() {
        let formData = new FormData($("#img-form")[0]);
        $.ajax({
            url: "/upload_img/", //请求路径
            type: 'POST', // 请求类型
            data: formData, // 请求数据
            dataType: "JSON", // 返回数据格式
            contentType: false, //表示不处理数据
            processData: false,
            cache: false,
            success: function (data) {
                if (data === 1) { 
                    alert("上传成功");
                }else if (data === 0) {
                    alert("上传失败");
                }
            },
            error: function (data) {
                console.log(data);
            }
        });
    }
</script>
</body>
</html>

注意在<form id="img-form" enctype="multipart/form-data">加入enctype="multipart/form-data"属性，只有加了这个属性才能进行文件上传。

Django自带csrf验证，所以需要在表单中加入

{% csrf_token %}

用于验证防跨域攻击，否则后台会报错。

ajax中需要加入

 contentType: false, //表示不处理数据
 processData: false,
 cache: false,

注意ajax请求参数的正确配置，具体请看上面的注释，请求路径为你配置的urls.py中对应的上传图片URL。

7. 编写上传图片函数

在views.py中添加上传图片函数，并将该函数注册到urls.py中。
views.py代码如下：

from django.http import JsonResponse
from django.shortcuts import render
from app001.models import Image

def img_upload(request):
    file_img = request.FILES['img']  # 获取文件对象
    image = Image()
    image.img = file_img
    try:
        image.save()  # 保存数据
        return JsonResponse(1, safe=False)
    except Exception as e:
        print(e)
        return JsonResponse(0, safe=False)

urls.py代码如下：

from django.contrib import admin
from django.urls import path

from app001 import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.get_user),

    path('to_upload_img/', views.to_img_load),  # 跳转至上传图片页面

    path('upload_img/', views.img_upload),  # 上传图片

]