Django:(02)项目配置

Django:(02)项目配置

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

Django:(02)项目配置

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

Django:(02)项目配置

需求:

 

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

Django:(02)项目配置

 

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

本文主要整合 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 默认生成了一个路由文件

Django:(02)项目配置

 

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:(02)项目配置

 

 浏览器输入默认路径:

 Django:(02)项目配置

发现Django会跳转到这个页面

Django:(02)项目配置

 

 这是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

 

posted @ 2018-11-16 15:20 举着栗子 阅读(...) 评论(...) 编辑 收藏