文件上传是网站开发中非常常见的功能。这里详细讲述如何在Django
中实现文件的上传功能。
form
标签,然后在这个form
标签中指定enctype="multipart/form-data"
,不然就不能上传文件。form
标签中添加一个input
标签,然后指定input
标签的name
,以及type="file"
。以上两步的示例代码如下:
<form action="" method="post" enctype="multipart/form-data">
<input type="file" name="myfile">
form>
后端的主要工作是接收文件。然后存储文件。接收文件的方式跟接收POST
的方式是一样的,只不过是通过FILES
来实现。示例代码如下:
def save_file(file):
with open('somefile.txt','wb') as fp:
for chunk in file.chunks():
fp.write(chunk)
def index(request):
if request.method == 'GET':
form = MyForm()
return render(request,'index.html',{'form':form})
else:
myfile = request.FILES.get('myfile')
save_file(myfile)
return HttpResponse('success')
以上代码通过request.FILES
接收到文件后,再写入到指定的地方。这样就可以完成一个文件的上传功能了。
在定义模型的时候,我们可以给存储文件的字段指定为FileField
,这个Field
可以传递一个upload_to
参数,用来指定上传上来的文件保存到哪里。比如我们让他保存到项目的files
文件夹下,那么示例代码如下:
# models.py
class Article(models.Model):
title = models.CharField(max_length=100)
content = models.TextField()
thumbnail = models.FileField(upload_to="files")
# views.py
def index(request):
if request.method == 'GET':
return render(request,'index.html')
else:
title = request.POST.get('title')
content = request.POST.get('content')
thumbnail = request.FILES.get('thumbnail')
article = Article(title=title, content=content, thumbnail=thumbnail)
article.save()
return HttpResponse('success')
调用完article.save()
方法,就会把文件保存到files
下面,并且会将这个文件的路径存储到数据库中。
MEDIA_ROOT
和MEDIA_URL
:以上我们是使用了upload_to
来指定上传的文件的目录。我们也可以指定MEDIA_ROOT
,就不需要在FielField
中指定upload_to
,他会自动的将文件上传到MEDIA_ROOT
的目录下。
MEDIA_ROOT = os.path.join(BASE_DIR,'media')
MEDIA_URL = '/media/'
models.py
thumbnail = models.FileField()#如果指定了 MEDIA_ROOT MEDIA_URL 里边uploads可以省略
#没有指定
thumbnail = models.FileField(upload_to="files") #这里边写成 thumbnail
然后我们可以在urls.py
中添加MEDIA_ROOT
目录下的访问路径。示例代码如下:
http://127.0.0.1:9000/media/day7作业.txt 从数据库中读取文件的url 然后在页面上能访问
#settings.py中 写入
MEDIA_ROOT = os.path.join(BASE_DIR,'media')
MEDIA_URL = '/media/'
然后在 urls.py中 映射 的
from django.urls import path
from front import views
from django.conf.urls.static import static #这个引入进来
from django.conf import settings #把 settings.py 配置文件引入进来
urlpatterns = [
path('', views.index),
] + static(settings.MEDIA_URL,document_root=settings.MEDIA_ROOT)
如果我们同时指定MEDIA_ROOT
和upload_to
,那么会将文件上传到MEDIA_ROOT
下的upload_to
文件夹中。示例代码如下:
class Article(models.Model):
title = models.CharField(max_length=100)
content = models.TextField()
thumbnail = models.FileField(upload_to="%Y/%m/%d/") #指定 上传目录到详细的 目录下
#2018/09/20/boolean默认值.png
上传图片跟上传普通文件是一样的。只不过是上传图片的时候Django
会判断上传的文件是否是图片的格式(除了判断后缀名,还会判断是否是可用的图片)。如果不是,那么就会验证失败。我们首先先来定义一个包含ImageField
的模型。示例代码如下:
class Article(models.Model):
title = models.CharField(max_length=100)
content = models.TextField()
thumbnail = models.ImageField(upload_to="%Y/%m/%d/")
因为要验证是否是合格的图片,因此我们还需要用一个表单来进行验证。表单我们直接就使用ModelForm
就可以了。示例代码如下:```
# forms.py
class Meta: #必须叫 Meta
model = Article #以模型中的字段为准
fields= "__all__" ##__all__ 表示所有的字段都要验证
#fields= "title,content" ## 指定字段 ,隔开
error_messages = {'thumbnail': [{'message': '请上传正确格式的图片', 'code': 'invalid_image'}]}
views.py
def post(self,request):
form = ArticleForm(request.POST,request.FILES)
#request.POST title和content
#request.FILES 接收文件
if form.is_valid(): #判断是否验证成功
form.save() #成功以后进行保存
return HttpResponse("成功了成功了")
else:
print(form.errors.get_json_data())#如果错误输出 错误信息
#{'thumbnail': [{'message': '请上传正确格式的图片', 'code': 'invalid_image'}]}
return HttpResponse("失败了失败了")
如果想要限制上传的文件的拓展名,那么我们就需要用到表单来进行限制。我们可以使用普通的Form
表单,也可以使用ModelForm
,直接从模型中读取字段。示例代码如下:
# models.py
from django.core import validators
class Article(models.Model):
title = models.CharField(max_length=100)
content = models.TextField()
thumbnail = models.FileField(upload_to='%Y/%m/%d/',validators=[validators.FileExtensionValidator(['txt','pdf'],message="thumbnial必须为txt或者pdf格式的文件 ")])
# forms.py
class Meta: #必须叫 Meta
model = Article #以模型中的字段为准
fields= "__all__" ##__all__ 表示所有的字段都要验证
#fields= "title,content" ## 指定字段 ,隔开
error_messages = { #错误信息
"thumbnail":{
'invalid_extension':'您只能上传 txt和pdf的文件 '
}
}
views.py
def post(self,request):
form = ArticleForm(request.POST,request.FILES)
#request.POST title和content
#request.FILES 接收文件
if form.is_valid(): #判断是否验证成功
form.save() #成功以后进行保存
return HttpResponse("成功了成功了")
else:
print(form.errors.get_json_data())#如果错误输出 错误信息
return HttpResponse("失败了失败了")
注意:使用ImageField,必须要先安装Pillow库:pip install pillow
cookie
的出现就是为了解决这个问题,第一次登录后服务器返回一些数据(cookie)给浏览器,然后浏览器保存在本地,当该用户发送第二次请求的时候,就会自动的把上次请求存储的cookie
数据自动的携带给服务器,服务器通过浏览器携带的数据就能判断当前用户是哪个了。cookie
存储的数据量有限,不同的浏览器有不同的存储大小,但一般不超过4KB。因此使用cookie
只能存储一些小量的数据。cookie
是存储在本地浏览器,session
是一个思路、一个概念、一个服务器存储授权信息的解决方案,不同的服务器,不同的框架,不同的语言有不同的实现。虽然实现不一样,但是他们的目的都是服务器为了方便存储数据的。session
的出现,是为了解决cookie
存储数据不安全的问题的。web
开发发展至今,cookie
和session
的使用已经出现了一些非常成熟的方案。在如今的市场或者企业里,一般有两种存储方式:
cookie
存储一个sessionid
,然后具体的数据则是保存在session
中。如果用户已经登录,则服务器会在cookie
中保存一个sessionid
,下次再次请求的时候,会把该sessionid
携带上来,服务器根据sessionid
在session
库中获取用户的session
数据。就能知道该用户到底是谁,以及之前保存的一些状态信息。这种专业术语叫做server side session
。Django
把session
信息默认存储到数据库中,当然也可以存储到其他地方,比如缓存中,文件系统中等。存储在服务器的数据会更加的安全,不容易被窃取。但存储在服务器也有一定的弊端,就是会占用服务器的资源,但现在服务器已经发展至今,一些session
信息还是绰绰有余的。session
数据加密,然后存储在cookie
中。这种专业术语叫做client side session
。flask
框架默认采用的就是这种方式,但是也可以替换成其他形式。设置cookie
是设置值给浏览器的。因此我们需要通过response
的对象来设置,设置cookie
可以通过response.set_cookie
来设置,这个方法的相关参数如下:
def set_cookie(self, key, value='', max_age=None, expires=None, path='/',
domain=None, secure=False, httponly=False):
key
:这个cookie
的key
。value
:这个cookie
的value
。max_age
:最长的生命周期。单位是秒。expires
:过期时间。跟max_age
是类似的,只不过这个参数需要传递一个具体的日期,比如datetime
或者是符合日期格式的字符串。如果同时设置了expires
和max_age
,那么将会使用expires
的值作为过期时间。默认是 navie时间 不知道位于哪个时区 可以将其转为aware时间 from django.utils.timezone import make_aware
expire_time = datetime(year=2018,month=9,day=25,hour=20,minute=30,second=0)
expire_time1 = make_aware(expire_time)
如果
max_age
和expires
同时存在 以 expires为准
user_id=kangbazi1806; expires=Tue, 25-Sep-2018 20:30:00 GMT; Max-Age=480381; Path=/cms/
path
:对域名下哪个路径有效。默认是对域名下所有路径都有效。 上面 只对 /cms/路径有效
domain
:针对哪个域名有效。默认是针对主域名下都有效,如果只要针对某个子域名才有效,那么可以设置这个属性.
secure
:是否是安全的,如果设置为True
,那么只能在https
协议下才可用。默认 secure
为false 也就是 http协议能用
httponly
:默认是False
。如果为True
,那么在客户端不能通过JavaScript
进行操作。
通过delete_cookie
即可删除cookie
。实际上删除cookie
就是将指定的cookie
的值设置为空的字符串,然后使用将他的过期时间设置为0
,也就是浏览器关闭后就过期。
获取浏览器发送过来的cookie
信息。可以通过request.COOKIES
来或者。这个对象是一个字典类型。比如获取所有的cookie
,那么示例代码如下:
cookies = request.COOKIES
for cookie_key,cookie_value in cookies.items():
print(cookie_key,cookie_value)
django
中的session
默认情况下是存储在服务器的数据库中的,在表中会根据sessionid
来提取指定的session
数据,然后再把这个sessionid
放到cookie
中发送给浏览器存储,浏览器下次在向服务器发送请求的时候会自动的把所有cookie
信息都发送给服务器,服务器再从cookie
中获取sessionid
,然后再从数据库中获取session
数据。但是我们在操作session
的时候,这些细节压根就不用管。我们只需要通过request.session
即可操作。示例代码如下:
def index(request):
request.session.get('username')
return HttpResponse('index')
def session_view(request):
request.session['username'] = "kangbazi1806" #如果登录 验证通过 同时将信息存到session中 一份
request.session['userid'] = '1806'
# username = request.session.pop("username")
# userid = request.session.pop("userid")
request.session.clear()
request.session.flush()
username = request.session.get("username")
print(username)
# expire = datetime(year=2018,month=9,day=25,hour=20,minute=30,second=0)
# expires = make_aware(expire)
# request.session.set_expiry(expires)
return HttpResponse("session view")
session
常用的方法如下:
get
:用来从session
中获取指定值。pop
:从session
中删除一个值。keys
:从session
中获取所有的键。items
:从session
中获取所有的值。clear
:清除当前这个用户的session
数据。flush
:删除session
并且删除在浏览器中存储的session_id
,一般在注销的时候用得比较多。set_expiry(value)
:设置过期时间。
0
:代表只要浏览器关闭,session
就会过期。None
:会使用全局的session
配置。在settings.py
中可以设置SESSION_COOKIE_AGE
来配置全局的过期时间。默认是1209600
秒,也就是2周的时间。clear_expired
:清除过期的session
。Django
并不会清除过期的session
,需要定期手动的清理,或者是在终端,使用命令行python manage.py clearsessions
来清除过期的session
。最后一行 加入 SESSION_ENGINE = “django.contrib.sessions.backends.cache”
默认情况下,session
数据是存储到数据库中的。当然也可以将session
数据存储到其他地方。可以通过设置SESSION_ENGINE
来更改session
的存储位置,这个可以配置为以下几种方案:
django.contrib.sessions.backends.db
:使用数据库。默认就是这种方案。django_sessiondjango.contrib.sessions.backends.file
:使用文件来存储session。django.contrib.sessions.backends.cache
:使用缓存来存储session。想要将数据存储到缓存中,前提是你必须要在settings.py
中配置好CACHES
,并且是需要使用Memcached
,而不能使用纯内存作为缓存。django.contrib.sessions.backends.cached_db
:在存储数据的时候,会将数据先存到缓存中,再存到数据库中。这样就可以保证万一缓存系统出现问题,session数据也不会丢失。在获取数据的时候,会先从缓存中获取,如果缓存中没有,那么就会从数据库中获取。django.contrib.sessions.backends.signed_cookies
:将session
信息加密后存储到浏览器的cookie
中。这种方式要注意安全,建议设置SESSION_COOKIE_HTTPONLY=True
,那么在浏览器中不能通过js
来操作session
数据,并且还需要对settings.py
中的SECRET_KEY
进行保密,因为一旦别人知道这个SECRET_KEY
,那么就可以进行解密。另外还有就是在cookie
中,存储的数据不能超过4k
。