Django：（02）项目配置

上一篇我们创建了一个Django项目，并且让它运行了起来了。

当是，我们还没有使用到我们创建的应用，以及templates模版目录。

需求：

在此之前我们根据需要对我们的项目进行配置修改。

在项目开发之前和开发过程中，以及开发完成上线之前，我们经常要修改配置文件。

本文主要整合 Django 的配置相关的内容。

一、全局配置

1、BASE_DIR——当前项目的根目录

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

• 含义：当前项目的根目录，Django会依此来定位工程内的相关文件，我们也可以使用该参数来构造文件路径。

2、DEBUG——开发模式

DEBUG = True

• 含义：是否为调试模式（开发模式），默认为 True

• 作用：当 DEBUG 为 True 时，如果 Django 程序运行出现异常时，会在浏览器显示详细的出错调试信息，而非调试模式下，不会显示出错调试信息。

• 注意：项目上线应该设置为 False 关闭调试模式，并且要同时设置 ALLOWED_HOSTS 参数。

3、ALLOWED_HOSTS ——允许访问的地址

ALLOWED_HOSTS = ['*']

• 含义：设置允许通过哪些IP访问， * 表示匹配所有ip。

4、LANGUAGE_CODE——本地语言

• 含义：Django支持本地化处理，显示语言。新创建的Django项目，默认使用的语言为英语。
• 修改为中文：

LANGUAGE_CODE = 'zh-hans'

5、TIME_ZONE——时区

• 含义：Django支持本地化处理，显示时区。新创建的Django项目，默认使用的时区为 UTC标准时区。
• 修改为中国大陆：

TIME_ZONE = 'Asia/Shanghai'

二、App 应用设置

1. 在每个应用目录中都包含了 apps.py 文件，用于保存该应用的相关信息

2. 在创建应用时，Django会向 apps.py 文件中写入一个该应用的配置类，如下

   from django.apps import AppConfig
   
    class UsersConfig(AppConfig):
   
        # 表示这个配置类是加载到哪个应用的，
        # 每个配置类必须包含此属性，默认自动生成
        name = 'users'

3. 应用配置： 需要在项目配置文件 settings.py 中的 INSTALLED_APPS 列表中，注册创建出来的应用：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',

    # 表示把users/apps.py中的UserConfig类注册进来
    'users.apps.UsersConfig',
]

三、静态文件配置——

仅在 DEBUG=False时,Django的测试服务器提供静态文件，在项目部署时会使用其他服务器来提供静态数据。

settings配置项

• STATICFILES_DIRS 静态文件所在的目录
• STATIC_URL 访问静态文件的URL前缀

 # 访问静态文件用到的url前缀
 STATIC_URL = '/static/'

 # 配置Django静态文件保存在哪个目录下
 STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static_files')]

配置后，html模版中的静态文件路径：

<img src="/static/imgs/img01.jpg" />

四、路由（URL）配置

Django 默认生成了一个路由文件

from django.conf.urls import url
from django.contrib import admin

urlpatterns = [
    url(r'^admin/', admin.site.urls),
]

我们看到 urlpatterns 列表了已经有一个 ‘admin/’ URL了，我们可以试一下在浏览器访问这个URL：http://127.0.0.1:8000/admin/

首先运行服务：

浏览器输入默认路径：

发现Django会跳转到这个页面

这是Django内置的后台管理视图。

URL配置
“urlpatterns”列表可以将URLs路由到views。

详情请参阅:
https://docs.djangoproject.com/en/1.11/topics/http/urls/

例子:
视图功能的实现
1、导入模块:from my_app import views
2、添加一个URL到 urlpattern: url(r'^$', views.home, name='home')

基类视图
1、导入:from other_app.views import Home
2、添加一个URL到 urlpattern: url(r'^$', Home.as_view(), name='home')

包含另一个URLconf
1、导入include()函数：from django.conf.urls import url, include
2、添加一个URL到 urlpattern: url(r'^blog/', include('blog.urls'))

　　

我们每写好一个视图就需要添加一个路由到 urlpattern 列表里，用来绑定URL和视图（一个函数）

（一）、举例

需求：在浏览器访问URL地址 http://127.0.0.1:8000/users/index 时，显示 hello django信息

实现：

1. 需要编写一个视图函数
2. 针对该视图函数配置访问路由

URL配置实现：

1、对‘users/index’ 进行url配置

2、项目下的 urls.py 文件：

urlpatterns = [

      # 包含users模块下的urls.py
      # 参数1： 匹配url的正则表达式
      # 参数2： 调用 inclucde 函数，包含users模块下的urls.py
      url(r'^users/', include('users.urls')),
  ]

3、在 users 应用下创建 urls.py 文件：

urlpatterns = [

      # 配置url和视图函数，需要调用url函数，并传入参数
      # 参数1： 匹配url的正则表达式（需要用 ^ 和 $ 匹配开头和结尾）
      # 参数2： url匹配成功执行的视图函数
      url(r'^index$', views.index),
  ]

（二）、URL匹配流程说明

1. 域名、端口、端口后的 /，以及查询字符串（问号后面的键值参数）不参与匹配
2. 先到项目下的 urls.py 进行匹配，再到应用的 urls.py 匹配
3. 根据url配置的先后顺序，从上到下进行URL匹配
4. 在项目下匹配成功的URL部分会去掉，剩下的部分继续到应用下作匹配
5. 如果匹配成功，Django会调用对应的视图函数，返回响应内容给浏览器显示
6. 如果最终匹配不成功, Django 会给浏览器返回404错误

（三）关于 /index 的两种配置方式

配置方式一： 只在项目的urls.py中配置，应用下不需要作配置

# 项目的urls.py
urlpatterns = [
    url(r'^index$', views.index),
]

配置方式二： 在项目和应用的urls.py中都进行配置

# 项目的urls.py
urlpatterns = [
    # 此处正则配置^, 表示任务的字符串都可以匹配成功
    url(r'^', include('users.urls')),
]

# 应用的urls.py
urlpatterns = [
    url(r'^index$', views.index),
]

（四）让访问 index 或者 index/ 网址，均能访问到index视图

　　当用户访问不以斜线/结尾的相同路径时，Django会把用户重定向到以斜线/结尾的路径上，而不会返回404不存在。但我们通常应该习惯以斜线 / 结尾。

（五）捕获URL路径中的参数

　（1）未命名参数（位置参数）： 按定义的顺序传递

# 在项目下的 urls.py 文件中配置

 url(r'^news/(\d+)/(\d+)$', users.views.news),

 # 在 users/views.py 中定义

 def news(request, a, b):

     return HttpResponse("显示新闻：%s %s" % (a, b))

　　（2）命名参数（关键字参数）： 按定义的组名传递

 # 在项目下的 urls.py 文件中配置

 url(r'^news/(?P<category>\d+)/(?P<page>\d+)$', users.views.news),

 # 在 users/views.py 中定义

 def news(request, category, page):

     return HttpResponse("显示新闻：%s %s" % (category, page))

END