Django 静态文件 (转)

发表于 分类于

原文地址 1 原文地址 2

静态文件是指 网站中的 js, css, 图片，视频等文件

开发阶段

推荐用新版本的 Django 进行开发，可以肯定的是 Django 1.4 以后的版本应该都支持下面的设置

settings.py 静态文件相关示例代码及说明： 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# Static files (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/1.8/howto/static-files/
 
STATIC_URL = '/static/'
 
# 当运行 python manage.py collectstatic 的时候
# STATIC_ROOT 文件夹 是用来将所有STATICFILES_DIRS中所有文件夹中的文件，以及各app中static中的文件都复制过来
# 把这些文件放到一起是为了用apache等部署的时候更方便
STATIC_ROOT = os.path.join(BASE_DIR, 'collected_static')
 
# 其它 存放静态文件的文件夹，可以用来存放项目中公用的静态文件，里面不能包含 STATIC_ROOT
# 如果不想用 STATICFILES_DIRS 可以不用，都放在 app 里的 static 中也可以
STATICFILES_DIRS = (
    os.path.join(BASE_DIR, "common_static"),
    '/path/to/others/static/',  # 用不到的时候可以不写这一行
)
 
# 这个是默认设置，Django 默认会在 STATICFILES_DIRS中的文件夹 和 各app下的static文件夹中找文件
# 注意有先后顺序，找到了就不再继续找了
STATICFILES_FINDERS ＝ (
    "django.contrib.staticfiles.finders.FileSystemFinder",
    "django.contrib.staticfiles.finders.AppDirectoriesFinder"
)

静态文件放在对应的 app 下的 static 文件夹中 或者 STATICFILES_DIRS 中的文件夹中。

当 DEBUG = True 时，Django 就能自动找到放在里面的静态文件。（Django 通过 STATICFILES_FINDERS 中的 “查找器”，找到符合的就停下来，寻找的过程 类似于 Python 中使用 import xxx 时，找 xxx 这个包的过程）。

示例项目 dj18static, 应用 app 下面有一个 static 里面有一个 zqxt.png 图片：

dj18static ├── blog
│ ├── init.py │ ├── admin.py │ ├── migrations │ │ └── init.py │ ├── models.py │ ├── static # 应用 blog 下的 static, 默认会找这个文件夹 │ │ └── 【zqxt.png】 │ ├── tests.py │ │ │ └── views.py ├── common_static # 已经添加到了 STATICFILES_DIRS 的文件夹 │ └── js │ └── 【jquery.js】 │ ├── dj18static │ ├── init.py │ ├── settings.py │ ├── urls.py │ └── wsgi.py └── manage.py

当 settings.py 中的 DEBUG = True 时，打开开发服务器 python manage.py runserver 直接访问 /static/zqxt.png 就可以找到这个静态文件。

也可以在 settings.py 中指定所有 app 共用的静态文件，比如 jquery.js 等

STATICFILES_DIRS = (
    os.path.join(BASE_DIR, "common_static"),
)

把 jquery.js 放在 common_static/js/ 下，这样就可以 在 /static/js/jquery.js 中访问到它！

示例下载：dj18static.zip

其它参考办法（当你想为静态文件分配多个不同的网址时，可能会用上这个）：

当然也可以自己指定静态文件夹，在 urls.py 的最后边这样写

1
2
3
4
5
6
7
# static files
import os
from django.conf.urls.static import static
from django.conf import settings
if settings.DEBUG:
    media_root = os.path.join(settings.BASE_DIR,'media2')
    urlpatterns += static('/media2/', document_root=media_root)

也可以这样 

1
2
3
4
5
6
from django.conf.urls.static import static
 
urlpatterns = patterns('',
    url(r'^$', 'app.views.index', name='index'),
    url(r'^admin/', include(admin.site.urls)),
) + static('/media2/', document_root=media_root)

部署时

1. 收集静态文件

python manage.py collectstatic

这一句话就会把以前放在 app 下 static 中的静态文件全部拷贝到 settings.py 中设置的 STATIC_ROOT 文件夹中

2. 用 apache2 或 nginx 示例代码

apache2 配置文件 

1
2
3
4
5
Alias /static/ /path/to/collected_static/
 
<Directory /path/to/collected_static>
    Require all granted
</Directory>

nginx 示例代码： 

1
2
3
4
5
6
7
location /media  {
    alias /path/to/project/media;
}
 
location /static {
    alias /path/to/project/collected_static;
}
1
2
Apache 完整的示例代码：

<VirtualHost *:80> ServerName www.ziqiangxuetang.com ServerAlias ziqiangxuetang.com ServerAdmin tuweizhong@163.com

    Alias /media/ /path/to/media/
    Alias /static/ /path/to/collected_static/
 
    <Directory /path/to/media>
        Require all granted
    </Directory>
 
    <Directory /path/to/collected_static>
        Require all granted
    </Directory>
 
    WSGIScriptAlias / /path/to/prj/prj/wsgi.py
    <Directory /path/to/prj/prj>
    <Files wsgi.py>
        Require all granted
    </Files>
    </Directory>
</VirtualHost>

```