前言
开始本教程之前默认你已掌握基本的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的文件夹。
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), # 上传图片
]
8. 测试图片上传
-
选择图片，点击提交
图片.png -
观察项目根目录media下的upload文件夹中是否存在刚刚上传的图片。
图片.png
