前言

开始本教程之前默认你已掌握基本的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，具体内容如下。

Title

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 %}

Title

{% csrf_token %}

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);

}

});

}

注意在

加入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), # 上传图片

]

8. 测试图片上传

选择图片，点击提交

图片.png

观察项目根目录media下的upload文件夹中是否存在刚刚上传的图片。

图片.png