创建项目
搭建好了开发环境,包括python和django,所以,接下来就是动手写代码的时候了,那么先写一个hello world :)
创建Django项目
首先确保已经进入了虚拟环境
#进入虚拟环境
$ workon Blog
#退出
$ deactivate
创建博客项目
#在工作目录中输入命令创建项目fbckf,生成的项目目录在当前目录下
#django-admin 是Django用于管理的命令行工具
$ django-admin startproject fbckf
项目结构
#使用 tree 命令查看项目文件结构
$ tree fbckf
fbckf
├── manage.py
└── fbckf
├── __init__.py
├── settings.py
├── urls.py
└── wsgi.py
fbckf 为项目根目录
manage.py
是 Django 自动生成的一个命令行工具,和django-admin的功能差不多,更适合管理简单的django项目在项目根目录下还有一个同名的目录,它存放了一些项目级别的配置文件
__init__.py
文件表示 fbckf 是一个 packagessetting.py
是 django 项目的配置文件,包括应用,debug,数据库,模板,语言等的配置urls.py
是 django 的路由配置文件wsgi.py
提供本地测试的小型服务器
django 项目结构中包括了 django 自动生成的文件和自己创建的文件
运行
# Django 自带了一个小型的服务器,在 manage.py 同级目录中使用以下命令运行它
$ python manage.py runserver
#终端输出信息
Performing system checks...
System check identified no issues (0 silenced).
You have 14 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
April 07, 2018 - 10:04:56
Django version 2.0.4, using settings 'fbckf.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
输出信息中的警告可以先不理会,因为还没有进行数据库迁移
在浏览器中出入地址:http://127.0.0.1:8000/ 访问项目页面
默认是使用 8000 端口,可以使用python manage.py runserver 9000
指定 9000 端口
创建应用
Django 项目中会有一个或多个应用程序来实现各种功能,也可以调用其他项目中的应用程序
#创建应用程序
$ python manage.py startapp blog
#再次查看项目的结构
$ tree fbckf
fbckf
├── blog
│ ├── admin.py
│ ├── apps.py
│ ├── __init__.py
│ ├── migrations
│ │ └── __init__.py
│ ├── models.py
│ ├── tests.py
│ └── views.py
├── db.sqlite3
├── manage.py
└── fbckf
├── __init__.py
├── __pycache__
│ ├── __init__.cpython-35.pyc
│ ├── settings.cpython-35.pyc
│ ├── urls.cpython-35.pyc
│ └── wsgi.cpython-35.pyc
├── settings.py
├── urls.py
└── wsgi.py
项目目录发生了改变
db.sqlite3
django 可以支持的数据库有很多,不过默认使用的是 python 自带的 sqlite3,这是它的数据库文件blog/
这是创建的 blog 应用的目录里面是运行脚本和配置文件admin.py
django 自带了一个Admin后台管理系统,可以在这个文件中注册你要进行管理的模型apps.py
可以在其中写应用程序的配置类migrations/
对模型做出修改的记录文件会存放在该目录中models.py
django 会将其中的 python 代码转译为数据库操作语言,一个标准的 python 类(class) 会被做为模型,在数据库中创建一张数据库表,类中的属性既是表中的字段tests.py
可以在这里编写自己的自动化测试views.py
编写视图函数或者类来处理请求,并且返回一个响应,它包括任何内容
创建了应用之后还需要在配置文件中注册这个应用
# fbckf/settings.py
...
# Application definition
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
#在这里注册你的应用
'blog',
]
...
服务器会根据请求的url,在urls.py中进行匹配,我们需要在该文件中写下url的匹配规制
# fbckf/urls.py
from django.contrib import admin
from django.urls import path, include
urlpatterns = [
path('admin/', admin.site.urls),
path('blog/', include('blog.urls')),
]
path()是django2.0新增的功能,相较于之情使用的url()而言简单的太多了,不用再去写复杂的正则
path(route,view,kwargs = None,name = None)
参数
route
可以是一个字符串或者一个gettext_lazy()
,包含url匹配模式,如请求url为https://127.0.0.1:8000 /admin
那么就会与第一个模式匹配,即path('admin/', admin.site.urls)
,有时候我们需要捕获url中的字符串作为关键字参数传递给视图,就需要使用到<Username>
这个模式,并且它可以利用转换器改变传递给视图变量的类型,如<int:year>
,它会匹配一个十进制的数字并转换为一个int
,或者是<slug:title>
,另外每个url匹配模式都应该以/
结尾view
是一个视图函数或者一个视图类,他会根据请求返回一个响应kwargs
允许传递其他的参数给视图函数name
可以对url进行命名,之后就可以通过这个名字获取该urlinlcude()
引用其他URLconf,当匹配url时,如果遇到include()
,django会将当前匹配字符串之后的字符串截取并传递给include()
引用的URLconf,之后再由它进行匹配,如path('',include('blog.urls'))
,当匹配到blog/
时,会引用应用程序blog
的urls.py
进行url匹配,这里之所以可以引用是因为已经在setting.py
中注册了这个应用,而且还需要在应用中创建一个urls.py
文件
应用中的urls.py
# blog/urls.py
# 因为要用到视图函数,所以要从当前目录导入views.py
from django.urls import path
from . import views
urlpatterns = [
path('', views.index, name='index')
]
匹配到url之后,会调用相应视图函数,之后视图会返回一个http响应
#在blog/views.py中编写视图函数
from django.http import HttpResponse
def index(request):
return HttpResponse("Hello world!")
服务器接收用户的http请求进行处理,返回一个包含处理结果的http响应,而视图函数就起到这个作用
这里定义了一个视图函数
index(request)
视图函数接收一个
request
参数,这就是一个http请求,它是django封装好的之后返回了一个http响应,即一个
HttpResponse
的实例,而它的参数将会被显示在页面中
运行
再次运行服务器,并访问http://127.0.0.1:8000/blog
就可以看到页面中的Hello world!
总结
在 Django2.0 之后增加了
path()
这个方法,在此之前使用的方法是url()
,写起来比较复杂,比如path('<int:question_id>/results/', ...)
,转换成url()
的方法就是url(r'^(?P<question_id>[0-9]+)/results/$', ...)
甚至更加复杂的正则表达式都有,可见path()
极大的提高了效率 :)Django 鼓励把相对独立的功能写成一个应用程序,这样一来使得其他项目引用起来更加方便