Django 静态文件处理

4,485 阅读2分钟

配置 staticfiles

打开 setting.py,将 django.contrib.staticfiles 加入至 INSTALLED_APPS 中:

STATIC_URL

STATIC_URL = '/static/'

这里,为 STATIC_URL 设置的 '/static/',指定的是:每个 APP 里面的静态资源目录。

拿我的个站来讲,我的 Project name 为 mysite,用于处理个站博客相关的 App name 为 blog,目录大概如下:

mysite/
    mysite/
        setting.py
        ...
    blog/
       static/ # 这个目录,便是我们所设置的 STATIC_URL
            blog/
                css/
                   main.css
                js/
                images/
        ...    
manage.py

{% load static %}

在模板中,我们首先需要加载 Django 的 STATICFILES_STORAGE

然后便可以使用 {% static 'static_url' %} 进行静态资源文件的加载:

<link href="{% static 'blog/css/main.css' %}?v=1.0.1" rel="stylesheet">

在浏览器中,便会看到 main.css 的请求:

STATICFILES_DIR

通常静态资源文件,例如一些通用的 *.css、*.js、*.png 等等,可以能全部 APP 都要用到,如 bootstrap.min.css,将它在每个 blog/static/css/ 里面复制粘贴一遍?

这明显不对,那么 STATICFILES_DIR 就是用来存放这些公共静态资源文件,现在我们来配置它:

STATICFILES_DIR = [
    os.path.join(BASE_DIR, 'static')
]

这里配置的目录名称仍然叫做“static”,它位于整个 Project 的根目录:

mysite/ 
     mysite/
         setting.py 
         ...
      blog/
         static/ # STATIC_URL   
              blog/
                  css/
                      main.css
                  js/
                  images/
manage.py 
static/ # STATICFILES_DIR 
     lib/
        bootstrap-3.3.7/
             ...
             css/
               bootstrap.min.css

和加载 blog/static/css/main.css 一样,我们来加载 bootstrap.min.css:

<link href="{% static 'lib/bootstrap-3.3.7/css/bootstrap.min.css' %}" rel="stylesheet">

STATIC_ROOT

这个目录,是 Django 开发模式和生产模式区别最大的地方。

前面配置好了静态资源,DEBUG = True ,啊哈,所有文件加载都很正常!

当你部署至生产环境,DEBUG = False,啊哈,怎么这么多 404!

首先,你要明白,开发模式下,Django 会依据所给予的 STATIC 相关路径配置,查找相应的静态文件,并响应给客户端;

生产环境下,Django 不再处理静态资源文件,你需要让 WEB 服务器来处理这些静态文件。


但是呢,现在我们的文件分散在 /mysite/blog/static//mysite/static/,如果你正在使用 Django admin,那么 admin 相关的静态文件肯能还在 Django pacakage 源码里面呢!

因此,我们需要将这些分散静态资源文件,收集到统一的位置,这个位置便是:STATIC_ROOT

STATIC_ROOT = os.path.join(BASE_DIR, 'static_cdn')

设置好 STATIC_ROOT 后,执行 collectstatic,所有你注册过的 APP,使用的静态文件均会收集到你所指定的 STATIC_ROOT 目录中:

python manage.py collectstatic

执行完毕后,在根目录,会新增一个 static_cdn/

NGINX

假设使用的 WEB 服务器是 Nginx,并且我们已经成功部署了该 Django 项目。

由于 Django 设置的 STATIC_URL 为 '/static/',因此,客户端依然会和开发模式时一样,静态资源文件请求,仍然是按照:

server_name/static/app_name/xxx.css

所以,我们需要将  /static/ 的访问 alias/static_cdn/ 就可以了:

service nginx reload

重新加载 nginx 配置文件后,访问一下你的项目,所有静态资源文件都是 200 OK! laugh