让我们跟着例子学习。
贯穿整个教程,我们将会带领你创建一个基础的投票应用。
他有两部分组成:
- 一个让人们观看民意和投票的公众网站
- 一个可以让你增加,修改和删除投票的管理页面。
我们假定你已经安装了Django.使用下面的命令,你将会知道你是否安装以及安装的是哪个版本的Django
python -m django --version
如果你安装了的django,你就会看到你安装的版本。否则你就会看到' No module named django'。
创建项目
如果你是第一次使用django,你要多注意一些初始化设置。换句话说,你需要自动生成一些代码来构建Django项目 - 设置Django实例的集合,包括数据库配置,特定于Djang的选项和特定于应用的设置。
在命令行输入以下命令:
django-admin startproject mysite
让我们看下startproject创建的目录;
mysite/
manage.py
mysite/
__init__.py
settings.py
urls.py
wsgi.py
这些文件是:
- 最外层的根目录mysite/是你的项目的容器。它的名字与Django无关,你可以去重命名任何你喜欢的名字。
- manage.py:一个命令行实用程序,可以让你与这个Django项目以不同的方式进行交互。你可以在django-admin and manage.py中查看更详细的介绍。
- 内部结构mysite/是你的项目的真实的Pytho包。它的名字就是Python包名,你想要引用它里面的任何东西都需要它(例如 mysite.urls)
-
mysite/init.py:一个空的文件,用来告诉Python,这个目录是一个Python包。如果你是一个新人,应该查看more
about packages官方文档。 - mysite/settings.py:设置或者配置你的Django项目。Django settings会告诉你settings怎么使用的。
- mysite/urls.py:Django项目的url声明;你的Django网站的目录。你可以在URL dispatcher了解更多
- mysite/wsgi.py:WSGI兼容的Web服务器,为您的项目提供服务的入门点。查看更多细节How to deploy with WSGI
服务器开发
让我们检验你的Django项目工作。切换到mysite目录,然后运行如下命令:
python manage.py runserver
你会在命令行看到如下输出:
Performing system checks...
System check identified no issues (0 silenced).
You have unapplied migrations; your app may not work properly until they are applied.
Run 'python manage.py migrate' to apply them.
April 08, 2017 - 15:50:53Django version 1.10, using settings 'mysite.
settings'Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
你已经开始了Django的服务器开发,一个纯粹用Python开发的轻量级web服务器。我们将其与Django结合在一起,因此您可以快速开发,而无需处理配置生产服务器(如Apache,直到您准备好生产环境才能开发)。
需要注意一下:不要在任何类似于生产环境的任何地方使用这个服务器。 它只适用于开发。 (我们正在开发Web框架,而不是Web服务器。)
既然服务已经运行了,用你的浏览器浏览http://127.0.0.1:8000。你将会看到“Welcome to Django ”页面,说明它正常运行了。
改变端口号:
python manage.py runserver 8080
改变ip:
python manage.py runserver 0.0.0.0:8080
服务器自动重载
任何Python代码的改动,服务器都会自动重载,不需要手动重启。然而,像新增文件这种情况就需要手动重启了。
创建Polls app
现在你的一个项目已经建立起来了,那么接下来开始工作吧。
按照惯例,任何一个你在Django中的应用都有一个Python包组成。Django有自动生成一个app的基础目录结构的功能,所以你可以专心敲代码,而不用去创建一个个目录。
Projects vs Apps
项目和应用的区别是什么?App是一个可以做某些事的web 应用,例如博客系统,公共记录的数据库或者一个简单的投票应用。而Project是一个特定网站的配置和应用的集合。一个Project可以有多个app,一个app可以在多个project中。
你的app可以放在Python路径下的任何地方。在这篇教程中,我们将在你的manage.py文件旁边创建我们的poll app,以便它可以导入为自己的顶级模块,而不是mysite的子模块。
确保你和manage.py在相同目录,然后执行以下命令:
python manage.py startapp polls
它的目录是:
polls/
__init__.py
admin.py
migrations/
__init.py__
models.py
tests.py
views.py
这个目录结构就构成了poll application
编写你的第一个view
打开polls/views.py文件,添加如下代码:
from django.http import HttpResponse
def index(request):
return HttpResponse("Hello,world.Your're at the polls index.")
这是Django最近简单的试图。为了调用这个试图,我们需要给它映射一个url,为了这么做,我们还需要一个URLconf。
为了在poll目录中创建一个URLconf,我们创建一个urls.py文件。现在,你的app的目录变成下面这样了:
polls/
__init__.py
admin.py
migrations/
__init.py__
models.py
tests.py
urls.py
views.py
在polls/urls.py文件中,我们加入如下代码:
from django.conf.urls import url
from . import views
urlpatterns =[
url(r'^$',views.index,name='index'),
]
下一步就是在polls.urls模块指定根URLconf。在mysite/urls.py中增加 django.conf.urls.include的引用,并在urlpatterns列表中增加一个include(),如下:
from django.conf.urls import include,url
from django.contrib import admin
urlpatterns = [
url(r'^polls/',include('polls.urls')),
url(r'^admin/',admin.site.urls),
]
include()方法允许引用其他的URLconf。请注意,include()函数的正则表达式不具有$(字符串结尾匹配字符),而是尾部斜线。 每当Django遇到include()时,它会排除与该点匹配的任何部分,并将剩余的字符串发送到包含的URLconf进行进一步处理。
include()的背后的思想是使即插即用的URL变得容易。 由于polls是在自己的URLconf(polls / urls.py)中,它们可以放在“/ polls /”下或“/ fun_polls /”下或“/ content / polls /”或其他路径根目录下, 应用程序仍然可以工作。
使用include()
当您包含其他URL模式时,应始终使用include()。 admin.site.urls是唯一的例外。
如果和你看到的不一样
如果你看到include(admin.site.urls)而不是admin.site.urls,你可能使用的Django版本与本教程版本不符。 您将需要切换到较旧的教程或较新的Django版本。
现在你把index连接到了URLconf中。让我们检验一下它是否正常工作:
python manage.py runserver
现在用你的浏览器打开http://localhost:8000/polls/,你会看到"Hello,world.You're at the polls index.",正如你定义的index试图那样。
url()函数接收4个参数,两个必须的:regex和 view,两个可选的:kwargs,name.现在,很有必要复习下这四个参数。
url() argument:regx
术语“regx”是一种常用的短格式,意思是“regular expression 正则表达式”,它是用于匹配字符串中的模式的语法,或者在这种情况下url模式。 Django从第一个正则表达式开始,并将其放在列表中,将请求的URL与每个正则表达式进行比较,直到找到匹配的一个。
请注意,这些正则表达式不搜索GET和POST参数或域名。例如,在https://www.example.com/myapp/的请求中,URLconf将寻找myapp /。在https://www.example.com/myapp/?page=3的请求中,URLconf还将查找myapp /。
如果您需要正则表达式的帮助,请参阅维基百科的条目和re模块的文档。此外,Jeffrey Friedl的O'Reilly书“掌握正则表达式”也是非常棒的。然而,实际上,您不需要是正则表达式的专家,因为您只需要知道如何捕获简单的模式。实际上,复杂的正则表达式的查找性能会很差,所以你可能不应该依靠正则表达式的全部功能。
最后,一个性能说明:这些正则表达式是第一次加载URLconf模块时被编译。它们超级快(只要查找不是太复杂,如上所述)。
url() argument:view
当Django发现正则表达式匹配时,Django会调用指定的视图函数,使用HttpRequest对象作为第一个参数,并将正则表达式中的任何“捕获”值作为其他参数。 如果正则表达式使用简单的捕获,则值作为位置参数传递; 如果它使用命名捕获,则值作为关键字参数传递。 我们稍后会给出一个例子。
url() argument:kwargs
任意关键词参数可以在字典中传递到目标视图。 我们不会在教程中使用Django的这个功能。
url() argument:name
命名您的URL可让您从Django其他地方明确地引用它,特别是在模板中。 这个强大的功能可让您通过只修改单个文件就可以全局性的更改项目的URL模式。
当您对基本请求和响应流程比较熟悉了,请阅读本教程的第2部分,开始使用数据库。