[django] 靜態文件STATICFILES_DIRS

首先,咱們配置靜態文件,要在setting.py裏面加入以下幾行代碼:

STATIC_URL = '/static/'
#the dir for command "python manage.py collectstatic"

#BASE_DIR 是項目的絕對地址

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

#如下不是必須的

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

一、STATIC_ROOT

STATIC_ROOT 是在部署靜態文件時(pyhtonmanage.pycollectstatic)全部的靜態文靜聚合的目錄。

python manage.py collectstatic

django會把全部的static文件都複製到STATIC_ROOT文件夾下

二、STATICFILES_DIRS

STATIC_ROOT 是在部署的時候才發揮做用, 而實際狀況下,靜態文件的通常安放位置有兩種:

1. 一種就是在每一個app裏面新建一個static文件夾,將靜態文件放到裏面,在加載靜態文件時,好比要在模板中用到靜態文件,django會自動在每一個app裏面搜索static文件夾(因此,不要把文件夾的名字寫錯, 不然django就找不到你的文件夾了)

2. 另外一種,就是在全部的app文件外面,創建一個公共的文件夾,

由於有些靜態文件不是某個app獨有的,那麼就能夠把它放到一個公共文件夾裏面,方便管理(注意,創建一個公共的靜態文件的文件夾只是一種易於管理的作法,可是不是必須的,app是能夠跨app應用靜態文件的,由於最後全部的靜態文件都會在STATIC_ROOT裏面存在)

那如今的問題是如何讓django知道你把一些靜態文件放到app之外的公共文件夾中呢,那就須要配置STATICFILES_DIRS了

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

STATICFILES_DIRS告訴django,首先到STATICFILES_DIRS裏面尋找靜態文件,其次再到各個app的static文件夾裏面找(注意, django查找靜態文件是惰性查找,查找到第一個,就中止查找了)

三、STATIC_URL

那麼到此爲止,靜態文件的機制就能夠運做了,可是有一個問題,我能不能經過url直接訪問我在項目中的靜態文件呢,答案確定是啦,可是,注意,你是在瀏覽器是訪問,你不可能輸入你的靜態文件的本地絕對地址吧,
好比個人一種圖片的本地地址爲 /home/mysite/common_static/myapp/photo.png

那麼別人不可能在瀏覽器上直接輸入:
http://192.168.1.2:8000/home/mysite/common_static/myapp/photo.png

這樣子,瀏覽器會報錯, 沒有該頁面，那麼django是如何讓瀏覽器也能夠訪問服務器上的靜態文件呢,前面已經說了,直接訪問服務器本地的地址是不行的,那就須要一個映射,

django利用STATIC_URL來讓瀏覽器能夠直接訪問靜態文件,好比:
STATIC_URL = ‘/static/’

那麼能夠在瀏覽器上輸入:
http://192.168.1.2:8000/static/common_static/myapp/photo.png

那麼就至關與訪問/home/mysite/common_static/myap/photo.png

因此在瀏覽器上,利用前綴 STATIC_URL的具體內容,來映射STATIC_ROOT,

HTTP://192.168.1.2:8000/static 至關於本地地址的STATIC_ROOT

此外，STATIC_URL還有一個做用，以下：

假定你的設置文件中有
STATIC_URL = ‘/static/’

那麼，在templates中，你能夠經過模板標籤static和給定的相對路徑來構成一個URL，以下。

{% load static %}
<img src="{% static "my_app/example.jpg" %}" alt="My image">

此時，構成的URL爲my_app/static/my_app/example.jpg。

若是你在項目中用到了static這個模板標籤，那必定要將nginx（或其餘）服務器的/static配置到與STATIC_ROOT一致！

依我愚見，這樣作是有好處的。由於django不像php，只要將靜態文件放置在.php或者.html同一目錄下就好。

好比：，在django中挪進一個文件夾中就可能訪問不到了。

這個時候static標籤就很是有用了；固然你也能夠在uwsgi的配置中經過–check-static和–static-map mountpoint=path來解決這個問題。官方連接在此：https://uwsgi-docs.readthedocs.io/en/latest/StaticFiles.html