Django 开发时的静态文件配置参数以及 collectstatic

1 概述

通常生产情况下,Django 的项目文件与网站的静态文件是分开存放的,甚至可以存放在不同的服务器,比如 Django 的项目文件放在阿里云服务器,而同时把静态文件存放在七牛云。

在每一个 Django 项目中的 settings.py 文件中,最下面的注释里面就有关于静态文件处理的官方文档网址。文档对 Django 如何处理静态文件有详细的介绍。

Django 1.9.5 版本的 settings.py

# Static files (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/1.9/howto/static-files/

Django 1.11 版本的 settings.py

# Static files (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/1.11/howto/static-files/

2 主要流程

对于 static 文件与 media 文件,本质是一样的,而且之前的 Django 版本是把这两种类型合并一起处理的。media 主要是针对用户上传的文件。static 是项目开发时,开发者提供的。

  • 设定好 MEDIA_URL/STATIC_URL, STATIC_ROOT/MEDIA_ROOT 以及 STATICFILES_DIRS 。
  • 使用 python manage.py collectstatic
  • media:用户上传时,会传到指定的 media_cdn 文件目录中。如果models 的 ImageField 设定 upload_to 属性,可以上传到指定目录中。
  • static:开发时,把静态文件都放在 STATICFILES_DIRS 中设定的 static 目录,运行 python manage.py collectstatic 会把 static 目录中的文件复制到 STATIC_ROOT 中设置的文件(static_cdn)。
  • 用户访问时,通过路由会指向相应的静态文件。

3 相应的设置

3.1 project/settings.py

完整代码如下

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(os.path.dirname(BASE_DIR), "static_cdn")

MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(os.path.dirname(BASE_DIR), "media_cdn")

STATICFILES_DIRS = [
    os.path.join(BASE_DIR, "static"),
]
STATICFILES_DIRS

设置一个目录,用于存放开发时使用到的 static 文件。

STATICFILES_DIRS = [
    os.path.join(BASE_DIR, "static"),
]
URL变量
STATIC_URL = '/static/'
MEDIA_URL = '/media/'

URL:STATIC_URLMEDIA_URL 会引导请求去找对应的 URL。具体的 url 路由会在后面进行设置。

ROOT变量

注意 BASE_DIR 指的是 manage.py所在的目录。

import os

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

所以如果在 BASE_DIR 这个目录中设置文件夹,比如设置 templates 可以使用os.path.join(BASE_DIR, 'templates')

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'templates'),],
        # ...
    },
]

但是如果要设置到 manage.py 所在目录外,另外一个平行同级目录。

首先得到BASE_DIR 这个目录的上一级目录。

os.path.dirname(BASE_DIR)

在使用 os.path.join() 拼接得到与 BASE_DIR 平行的目录

STATIC_ROOT = os.path.join(os.path.dirname(BASE_DIR), "static_cdn")
MEDIA_ROOT = os.path.join(os.path.dirname(BASE_DIR), "media_cdn")

得到的目录结构是

.
|-- media_cdn
|   |-- car.jpg
|   |-- landview.jpg
|   `-- beach.jpg
|-- README.md
|-- requirements.txt
|-- project
|   |-- db.sqlite3
|   |-- __init__.py
|   |-- manage.py
|   |-- posts
|   |-- static
|   |-- templates
|   `-- project
`-- static_cdn
    |-- admin
    |-- css
    `-- vendor

3.2 project/urls.py

在 urls.py 的文件中加入以下内容,这样就为 static 和 media 的ROOT目录设置好了路由。

from django.conf import settings
from django.conf.urls.static import static

if settings.DEBUG:
    urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

之所以做了一个判断if settings.DEBUG: ,是因为上线以后就不再使用这些 ROOT 目录。

DEBUG 的状态是在 settings.py 中控制

# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = True

3.3 使用 collectstatic

上面的参数设置好之后,就可以执行以下命令:

$ python manage.py collectstatic
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,847评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,208评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,587评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,942评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,332评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,587评论 1 218
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,853评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,568评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,273评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,542评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,033评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,373评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,031评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,073评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,830评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,628评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,537评论 2 269

推荐阅读更多精彩内容