本章节顺序,路由说明,配置文件,静态文件;
根据第一节中的简单Django 项目大致知道它的整个流程是什么样,现在就来探索以下它的路由和静态文件以及配置文件;
关于配置子应用以及路由,我个人是这样理解的,
1, 因为settings.py是整个项目的配置文件apps是单个子应用的配置文件,项目开启后要想访问到我们的子项目,那他们之间是不是必须建立关联,所以这个过程就是在Settings中注册应用INSTALL_APPS['子应用.apps.自应用名Config'] 这个步骤的目的就是将子应用的配置也加载进来;
2, 可以参考如下路由匹配过程。首先一个请求过来了,肯定是先经过你的主应用中的urls.py 文件(就是和你项目名字同名的那个目录下的文件),经过这里的时候它会把整个项目的所有url规则加载出来,当访问到include的关键字的时候就会把子应用的路由加载进应用中,根据请求的路径来正则匹配,匹配不到就返回404;所以说,当你创建完一个视图之后,必须要让你的视图和url来建立关联,这个目的是访问路由的时候能进入到你的视图函数,然后在子应用中创建urls.py的目的是给子应用下的路由可以配置单独的访问规则;
一,路由说明
1. URL路由地址的匹配过程
2. 路径结尾斜线/的说明
Django中定义路由时,通常以斜线/结尾,其好处是用户访问不以斜线/结尾的相同路径时,Django会把用户重定向到以斜线/结尾的路径上,而不会返回404不存在。如
urlpatterns = [
url(r'^index/$', views.index, name='index'),
]
用户访问 index 或者 index/ 网址,均能访问到index视图;后面介绍类视图之后会自动按照请求的方式匹配对应的视图函数;
说明:
是否结尾带/以所属公司定义风格为准。
3. 路由解析顺序
Django在接收到一个请求时,从主路由文件中的urlpatterns列表中以由上至下的顺序查找对应路由规则,如果发现规则为include包含,则再进入被包含的urls中的urlpatterns列表由上至下进行查询。
值得关注的由上至下的顺序,有可能会使上面的路由屏蔽掉下面的路由,带来非预期结果。例如:
urlpatterns = [
url(r'^say', views.say),
url(r'^sayhello', views.sayhello),
]
即使访问sayhello/路径,预期应该进入sayhello视图执行,但实际优先查找到了say路由规则也与sayhello/路径匹配,实际进入了say视图执行。
提示:
需要注意定义路由的顺序,避免出现屏蔽效应。建议进行URL地址配置时严格匹配开头和结尾。
4. 路由命名与reverse反解析(逆向)
4.1 路由命名
在定义路由的时候,可以为路由命名,方便查找特定视图的具体路径信息。
1) 在使用include函数定义路由时,可以使用namespace参数定义路由的命名空间,如
url(r'^users/', include('users.urls', namespace='users')),
命名空间表示,凡是users.urls中定义的路由,均属于namespace指明的users名下。
命名空间的作用:避免不同应用中的路由使用了相同的名字发生冲突,使用命名空间区别开。
2) 在定义普通路由时,可以使用name参数指明路由的名字,如
urlpatterns = [
url(r'^index/$', views.index, name='index'),
url(r'^say', views.say, name='say'),
]
4.2 reverse反解析
使用reverse函数,可以根据路由名称,返回具体的路径,如:
from django.urls import reverse # 注意导包路径
def index(request):
return HttpResponse("hello the world!")
def say(request):
url = reverse('users:index') # 返回 /users/index/
print(url)
return HttpResponse('say')
- reverse(命名空间namespace:路由name)
二,配置文件
1. BASE_DIR
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
当前工程的根目录,Django会依此来定位工程内的相关文件,我们也可以使用该参数来构造其他你想配置的文件路径。
2. DEBUG
调试模式,创建工程后初始值为True,即默认工作在调试模式下。
作用:
-
修改代码文件,程序自动重启
-
Django程序出现异常时,向前端显示详细的错误追踪信息,例如
-
而非调试模式下,仅返回Server Error (500)
注意:部署线上运行的Django不要运行在调式模式下,记得修改DEBUG=False。
3. 本地语言与时区
Django支持本地化处理,即显示语言与时区支持本地化。
本地化是将显示的语言、时间等使用本地的习惯,这里的本地化就是进行中国化,中国大陆地区使用简体中文,时区使用亚洲/上海时区,注意这里不使用北京时区表示。
初始化的工程默认语言和时区为英语和UTC标准时区
LANGUAGE_CODE = 'en-us' # 语言
TIME_ZONE = 'UTC' # 时区
将语言和时区修改为中国大陆信息
LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'Asia/Shanghai'
三,静态文件
项目中的CSS、图片、js都是静态文件。一般会将静态文件放到一个单独的目录中,以方便管理。在html页面中调用时,也需要指定静态文件的路径,Django中提供了一种解析的方式配置静态文件路径。静态文件可以放在项目根目录下,也可以放在应用的目录下,由于有些静态文件在项目中是通用的,所以推荐放在项目的根目录下,方便管理。
为了提供静态文件,需要配置两个参数:
- STATICFILES_DIRS 存放查找静态文件的目录
- STATIC_URL 访问静态文件的URL前缀
示例
1) 在项目根目录下创建static_files目录来保存静态文件。
2) 在demo/settings.py中修改静态文件的两个参数为
STATIC_URL = '/static/'
STATICFILES_DIRS = [
os.path.join(BASE_DIR, 'static_files'),
]
3)此时在static_files添加的任何静态文件都可以使用网址 /static/文件在static_files中的路径 来访问了。
例如,我们向static_files目录中添加一个index.html文件,在浏览器中就可以使用127.0.0.1:8000/static/index.html来访问。
或者我们在static_files目录中添加了一个子目录和文件goods/detail.html,在浏览器中就可以使用127.0.0.1:8000/static/goods/detail.html来访问。
注意
Django 仅在调试模式下(DEBUG=True)能对外提供静态文件。
当DEBUG=False工作在生产模式时,Django不再对外提供静态文件,需要是用collectstatic命令来收集静态文件并交由其他静态文件服务器来提供。(详细在部署时会讲)