Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenDocCN
django-doc-18-zh
提交
b58698d2
D
django-doc-18-zh
项目概览
OpenDocCN
/
django-doc-18-zh
通知
0
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
django-doc-18-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
前往新版Gitcode,体验更适合开发者的 AI 搜索 >>
提交
b58698d2
编写于
9月 05, 2015
作者:
W
wizardforcel
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
9.5
上级
98d04182
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
156 addition
and
0 deletion
+156
-0
3_3_4_Managing files.md
3_3_4_Managing files.md
+156
-0
未找到文件。
3_3_4_Managing files.md
0 → 100644
浏览文件 @
b58698d2
# 管理文件 #
这篇文档描述了Django为那些用户上传文件准备的文件访问API。底层的API足够通用,你可以使用为其它目的来使用它们。如果你想要处理静态文件(JS,CSS,以及其他),参见
[
管理静态文件(CSS和图像)
](
http://python.usyiyi.cn/django/howto/static-files/index.html
)
。
通常,Django使用
`MEDIA_ROOT `
和
`MEDIA_URL`
设置在本地储存文件。下面的例子假设你使用这些默认值。
然而,Django提供了一些方法来编写自定义的
[
文件储存系统
](
http://python.usyiyi.cn/django/topics/files.html#file-storage
)
,允许你完全自定义Django在哪里以及如何储存文件。这篇文档的另一部分描述了这些储存系统如何工作。
## 在模型中使用文件 ##
当你使用
`FileField`
或者
`ImageField`
的时候,Django为你提供了一系列的API用来处理文件。
考虑下面的模型,它使用
`ImageField`
来储存一张照片:
```
from django.db import models
class Car(models.Model):
name = models.CharField(max_length=255)
price = models.DecimalField(max_digits=5, decimal_places=2)
photo = models.ImageField(upload_to='cars')
```
任何
`Car`
的实例都有一个
`photo`
字段,你可以通过它来获取附加图片的详细信息:
```
>>> car = Car.objects.get(name="57 Chevy")
>>> car.photo
<ImageFieldFile: chevy.jpg>
>>> car.photo.name
'cars/chevy.jpg'
>>> car.photo.path
'/media/cars/chevy.jpg'
>>> car.photo.url
'http://media.example.com/cars/chevy.jpg'
```
例子中的
`car.photo`
对象是一个
`File`
对象,这意味着它拥有下面描述的所有方法和属性。
> 注意
>
> 文件保存是数据库模型保存的一部分,所以磁盘上真实的文件名在模型保存之前并不可靠。
例如,你可以通过设置文件的
`name`
属性为一个和文件储存位置 (
`MEDIA_ROOT`
,如果你使用默认的
`FileSystemStorage`
)相关的路径,来修改文件名称。
```
>>> import os
>>> from django.conf import settings
>>> initial_path = car.photo.path
>>> car.photo.name = 'cars/chevy_ii.jpg'
>>> new_path = settings.MEDIA_ROOT + car.photo.name
>>> # Move the file on the filesystem
>>> os.rename(initial_path, new_path)
>>> car.save()
>>> car.photo.path
'/media/cars/chevy_ii.jpg'
>>> car.photo.path == new_path
True
```
## File ##
当Django需要表示一个文件的时候,它在内部使用
`django.core.files.File`
实例。这个对象是 Python
[
内建文件对象
](
https://docs.python.org/library/stdtypes.html#bltin-file-objects
)
的一个简单封装,并带有一些Django特定的附加功能。
大多数情况你可以简单地使用Django提供给你的
`File`
对象(例如像上面那样把文件附加到模型,或者是上传的文件)。
如果你需要自行构造一个
`File`
对象,最简单的方法是使用Python内建的
`file`
对象来创建一个:
```
>>> from django.core.files import File
# Create a Python file object using open()
>>> f = open('/tmp/hello.world', 'w')
>>> myfile = File(f)
```
现在你可以使用
`File`
类的任何文档中记录的属性和方法了。
注意这种方法创建的文件并不会自动关闭。以下步骤可以用于自动关闭文件:
```
>>> from django.core.files import File
# Create a Python file object using open() and the with statement
>>> with open('/tmp/hello.world', 'w') as f:
... myfile = File(f)
... myfile.write('Hello World')
...
>>> myfile.closed
True
>>> f.closed
True
```
在处理大量对象的循环中访问文件字段时,关闭文件极其重要。如果文件在访问之后没有手动关闭,会有消耗完文件描述符的风险。这可能导致如下错误:
```
IOError: [Errno 24] Too many open files
```
## 文件储存 ##
在背后,Django需要决定在哪里以及如何将文件储存到文件系统。这是一个对象,它实际上理解一些东西,比如文件系统,打开和读取文件,以及其他。
Django的默认文件储存由
`DEFAULT_FILE_STORAGE`
设置提供。如果你没有显式提供一个储存系统,就会使用它。
关于内建的默认文件储存系统的细节,请参见下面一节。另外,关于编写你自己的文件储存系统的一些信息,请见
[
编写自定义的文件系统
](
http://python.usyiyi.cn/django/howto/custom-file-storage.html
)
。
### 储存对象 ###
大多数情况你可能并不想使用
`File`
对象(它向文件提供适当的存储功能),你可以直接使用文件储存系统。你可以创建一些自定义文件储存类的实例,或者 – 大多数情况更加有用的 – 你可以使用全局的默认储存系统:
```
>>> from django.core.files.storage import default_storage
>>> from django.core.files.base import ContentFile
>>> path = default_storage.save('/path/to/file', ContentFile('new content'))
>>> path
'/path/to/file'
>>> default_storage.size(path)
11
>>> default_storage.open(path).read()
'new content'
>>> default_storage.delete(path)
>>> default_storage.exists(path)
False
```
关于文件储存API,参见
[
文件储存API
](
http://python.usyiyi.cn/django/ref/files/storage.html
)
。
### 内建的文件系统储存类 ###
Django自带了
`django.core.files.storage.FileSystemStorage`
类,它实现了基本的本地文件系统中的文件储存。
例如,下面的代码会在
`/media/photos`
目录下储存上传的文件,无论
`MEDIA_ROOT`
设置是什么:
```
from django.db import models
from django.core.files.storage import FileSystemStorage
fs = FileSystemStorage(location='/media/photos')
class Car(models.Model):
...
photo = models.ImageField(storage=fs)
```
[
自定义储存系统
](
http://python.usyiyi.cn/django/howto/custom-file-storage.html
)
以相同方式工作:你可以把它们作为
`storage`
参数传递给
`FileField`
。
> 译者:[Django 文档协作翻译小组](http://python.usyiyi.cn/django/index.html),原文:[Managing files](https://docs.djangoproject.com/en/1.8/topics/files/)。
>
> 本文以 [CC BY-NC-SA 3.0](http://creativecommons.org/licenses/by-nc-sa/3.0/cn/) 协议发布,转载请保留作者署名和文章出处。
>
> [Django 文档协作翻译小组](http://python.usyiyi.cn/django/index.html)人手紧缺,有兴趣的朋友可以加入我们,完全公益性质。交流群:467338606。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录