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
├── commonstatic # 已经添加到了 STATICFILESDIRS 的文件夹
│ └── 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
8
    location /media  {
alias /path/to/project/media;
}

location /static {
alias /path/to/project/collected_static;
}
```

Apache 完整的示例代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<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>