转载

Django | 静态文件处理

Django: 1.8.7

在使用 django 开发中，不可避免的总会遇到静态文件的处理，特别对于前端来说，页面的调试都是依赖静态文件（JS，CSS，Image等等）， Django 在静态文件处理这一块做的不错，但不是最优秀，毕竟 Django 只是一个框架而已，更多的业务需要搭配其他工具共同完成，这是后话。

1 文件分类

Django 把静态文件分成了两类： static 和 media ，看了 Django 的文档之后，发现 Django 是按照是否与用户互动来进行区分的

static : 应用页面需要的（JS, CSS, Image...），这些相对来说是提供给用户的，即这些文件（非严格讲）没有与用户进行互动，开发者产生这些文件为访问用户服务，用户只是单纯的享受应用服务。
media : 用户与应用程序进行交互的文件（用户上传的文件等等）

2 static 文件

Django 使用下面几项来处理 static 文件

STATIC_ROOT
STATIC_URL
STATICFILES_DIRS
STATICFILES_STORAGE
STATICFILES_FINDERS

每一项的具体作用不写了，不懂的可以去翻看官方文档，已经非常清晰。

2.1 开发环境

2.1.1 在自定义的 STATICFILES_DIRS 寻找静态文件

以下是我使用的方式：推荐

保证 django.contrib.staticfiles 在 INSTALLED_APPS 中.
在 TEMPLATES 配置中添加 django.template.context_processors.static
在模板中使用 STATIC_URL 变量， eg：<img src="{{STATIC_URL}}girl.png>

2.1.2 在自定义的 STATIC_ROOT 寻找静态文件

如果你想访问静态文件时，静态文件在 STATIC_ROOT 中寻找

from django.conf import settings from django.conf.urls.static import static  urlpatterns = [     # ... the rest of your URLconf goes here ... ] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

这种方法不推荐，理由：开发过程中需要不断的执行 ./manage.py collectstatic

2.2 生产环境

生产环境不同开发环境，生产环境下（ DEBUG=False ）, django.contrib.staticfiles 是不起任何作用的，也就说 django.contrib.staticfiles 只对开发环境（ DEBUG=True ）开启

生产环境我们一般都是使用 web服务器 来管理静态文件，管理方法就不写了，不懂可以翻看文档

2.3 CDN 服务

根据配置文件的不同（ develop.py production.py ）, 设置不同的 STATIC_URL , 这样很容易结合 CDN 服务，生产环境配置 CDN ，这就扯到高并发去了

2.4 开发环境下默认静态文件服务运行原理

这个原理很简单，因为 django.contrib.staticfiles 在 INSTALLED_APPS 中， Django 自动加载 django.contrib.staticfiles 的 urls.py , urls.py 源代码如下：

from django.conf import settings from django.conf.urls.static import static from django.contrib.staticfiles.views import serve  urlpatterns = []   def staticfiles_urlpatterns(prefix=None):     """     Helper function to return a URL pattern for serving static files.     """     if prefix is None:         prefix = settings.STATIC_URL     return static(prefix, view=serve)  # Only append if urlpatterns are empty if settings.DEBUG and not urlpatterns:     urlpatterns += staticfiles_urlpatterns()

重点是 staticfiles_urlpatterns 这个函数，自动把 settings.STATIC_URL 作为前缀，这些细节我们都不用管， Django 都帮我们搞好了

3 media 文件

media 这里不仅仅包含多媒体文件，包括用户上传的 文档 ，自定义的 css 等等

Django 使用下面几项来处理 media 文件

MEDIA_ROOT
MEDIA_URL

3.1 开发环境

以下是我使用方式

在 TEMPLATES 配置中添加 django.template.context_processors.media
修改 urls.py 入口文件

from django.conf import settings from django.conf.urls.static import static  urlpatterns = [     # ... the rest of your URLconf goes here ... ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

在模板中直接使用 MEDIA_URL 变量.

<video width="320" height="240" controls="controls">   <source src="{{ MEDIA_URL }}movie.ogg" type="video/ogg">   <source src="{{ MEDIA_URL }}movie.mp4" type="video/mp4"> </video>