Django的MEDIA_ROOT和STATIC_ROOT--显示上传图片

标题无“转载”即原创文章，版权所有。转载请注明来源：http://hgoldfish.com/blogs/article/77/。

在水木的Python版问了一下,

MEDIA_ROOT

主要是用来放置上传的文件。Django的ORM有个特殊的字段叫做

FileField

是用来存储文件的。不过实际上并不会把文件内容存到数据库里面——因为大多数数据库保存文件时效率低，而是保存在文件系统里面。

FileField

只记录一个路径。

FileField

可以像个Python的

file

类型那样读写。

在开发的时候MEDIA_ROOT不应该存放任何文件。它应该指向一个空的目录。运行Django的开发服务器时，需要在

urls.py

里面加入一个MEDIA_URL的映射，才能正常显示上传的内容:

from django.conf import settingsif settings.DEBUG:
urlpatterns += patterns(",
url(r"^media/(?P<path>.*)$", \                "django.views.static.serve", \                {"document_root": settings.MEDIA_ROOT,}),)

当工程被布署到Apache时也要记得给

MEDIA_URL

做个映射。

STATIC_ROOT

是Django 1.3新增的特性。如同字面上的意思。保存在这个目录里面文件被当成静态文件处理。不过，千万不要把自己辛苦写的JavaScript、图片等静态文件放到里面去，接着看下去就知道了。与

STATIC_ROOT

搭配使用的还有

STATIC_URL

与

STATICFILES_DIRS

两个变量。

STATIC_URL

一般用默认的

/static/

，用于指定的静态目录的URL。

STATICFILES_DIRS

则指定一个工程里面哪个目录存放了与这个工程相关的静态文件，它是一个列表。假定在STATICFILES_DIRS有一个目录是"/dolphin/besteam/pages/static"，其中有一个文件是

common.js

。那么，在浏览器里面输入

http://localhost:8000/static/common.js

就可以访问这个JavaScript文件了。

更深层次的理解，这个东西其实是用来方便布署Django App的。考虑一下我们编写Django App的情况，经常会有一些静态的文件(JavaScript、图片等)。为了方便，把这些文件放置到App下面的

static

目录里面。每个App都有自己的子目录，所以在Django 1.3之前，布署的时候就麻烦了。有三种选择：

一是使用

django.views.static.serve

来处理文件。在App的

urls.py

里面加上一条：

url(r"^(?/static/P<path>.*)$", "django.views.static.serve",\        {"document_root" : "/path/to/project/app/static/"})

每个App都要加入这条纪录，这样做的话，静态经过了Django的处理，速度太慢。

二是让用户手动写Apache的映射。将

/static/

映射到

/path/to/project/app/static

。这种方法更麻烦，不仅URL不能冲突，而且破坏了App的代码独立原则。作为布署者，每个App的情况都要相当熟悉，不能遗落(可以强制每个App都使用static目录)。

三是由布署者将每个App内的

static

目录内的文件复制到一个指定的目录。然后重写Apache，将

/static

映射到这个目录。这个方案可以说兼有第一方案与第二方案的优点，已经接近

staticfiles

了。缺点是手动操作，还是太麻烦了一点。

新的Django提供了一个方法自动地将所有的静态文件放在一起。只要在写App的时候创建一个static子目录专门保存静态文件就行了。在开发阶段，不必费心去做映射，不需要配置

urls.py

。在布署到生产环境的时候，只需要配置Apache把

/static/

映射到

STATIC_ROOT

。然后运行

manage.py collectstatic

，自动地

STATICFILES_DIRS

列出的目录以及各个App下的static子目录的所有文件复制到STATIC_ROOT。因为复制过程可能会覆盖掉原来的文件，所以，一定不能把我们辛苦做出来静态文件放这边！

在开发阶段，Django把

/static

映射到

django.contrib.staticfiles

这个App。

staticfiles

自动地从

STATICFILES_DIRS

、

STATIC_ROOT

以及各个App的

static

子目录里面搜索静态文件。一旦布署到开发环境上，settings.py不需要重新编写，只要在Apache的配置文件里面写好映射，

/static

将会被Apache处理。

django.contrib.staticfiles

虽然仍然存在，但因为不会接收到以

/static/

开始的路径，所以将不会产生作用。不必担心Django会使用处理速度变慢。另外，当

settings.DEBUG is False

的时候，

staticfiles

将自动关闭。

标题无“转载”即原创文章，版权所有。转载请注明来源：http://hgoldfish.com/blogs/article/77/。