1500字范文 > Django项目实践1 - 创建Django项目

Django项目实践1 - 创建Django项目

时间：2022-09-03 12:42:40

/pipisorry/article/details/38964249

上篇：python web框架 - Django

Django 项目实践

Django 管理工具

安装 Django 之后，您现在应该已经有了可用的管理工具 django-admin.py。可以使用 django-admin.py来创建一个项目:

django-admin.py的命令:

# django-admin.pyUsage: django-admin.py subcommand [options] [args]Options:-v VERBOSITY, --verbosity=VERBOSITYVerbosity level; 0=minimal output, 1=normal output,2=verbose output, 3=very verbose output--settings=SETTINGS The Python path to a settings module, e.g."myproject.settings.main". If this isn't provided, theDJANGO_SETTINGS_MODULE environment variable will beused.--pythonpath=PYTHONPATHA directory to add to the Python path, e.g."/home/djangoprojects/myproject".--traceback Raise on exception--version show program's version number and exit-h, --help show this help message and exitType 'django-admin.py help <subcommand>' for help on a specific subcommand.Available subcommands:[django]checkcleanupcompilemessagescreatecachetable... ...

Note:阅读django-admin.py documentation来了解manage.py工具能做的所有事情。

创建Django项目

新建项目

在文件系统哪里创建项目：有过 PHP 编程背景的话，你可能习惯于将代码都放在 Web 服务器的文档根目录 (例如/var/www这样的地方)。而在 Django 中，把任何Python代码和web server的文档根(root)放在一起并不是一个好主意。因为这样做有使人能通过网路看到你原代码的风险。

使用django-admin.py创建项目

django-admin startprojectVoteSite

Note:如果用的是setup.py工具安装的 Django ，django-admin.py应该已被加入了系统路径中。如果你使用一个trunk版本，你会在djtrunk/django/bin下发现django-admin.py。你将来会常用到django-admin.py，考虑把它加到你的系统路径中去比较好。

Note: 也可以通过pycharm中 > file >new project > django> VoteSite创建新Django项目，这种方法创建的django项目还会自动生成templates 目录， templates作用在后面讲到。

项目的目录结构

目录说明：（下面还有添加）

VoteSite:项目的容器。manager.py: 一个实用的命令行工具，可让你以各种方式与该 Django 项目进行交互。 VoteSite/__init__.py: 一个空文件，告诉 Python 该目录是一个 Python 包。VoteSite/settings.py: 该 Django 项目的设置/配置。VoteSite/urls.py:该 Django 项目的 URL 声明; 一份由 Django 驱动的网站"目录"。决定127.0.0.1：8000后面可以接哪些内容？VoteSite/wsgi.py:一个 WSGI 兼容的 Web 服务器的入口，以便运行你的项目。

启动Django服务器

进入 VoteSite目录, 在pycharm/terminal中输入

python manage.py runserver

Note:

1. 通常情况下，你每次修改过一个文件后开发服务器都会自动载入，但是创建一个新文件却不会触发自动载入的逻辑。

2. 这时启动的服务只能在本机访问，这是因为服务只向本机（127.0.0.1：8000）提供，所以局域网的其他机器不能访问。在另一台机器上访问django开放的界面会出现Page not found (404)错误。

3.默认情况下，:djadmin:runserver 命令启动的开发服务器只监听本地 IP 的 8000 端口。如果你想改变服务器的端口，把它作为一个命令行参数传递即可。例如以下命令启动的服务器将监听 8080 端口：python manage.py runserver 8080

完成后在本机浏览器中输入127.0.0.1：8000就可以访问自己的网站了。如果正常启动，输出

启动Django远程访问

python manage.py runserver 0.0.0.0:8000

Note: 如果你想改变服务器 IP ，把它和端口号一起传递即可。因此，要监听所有公共 IP 地址（0.0.0.0让其他电脑上可以访问服务器，用于多人测试，局域网内测试通过），使用：python manage.py runserver 0.0.0.0:8000

在其他电脑浏览器输入服务器/电脑的ip(Windows的用户在cmd中输入ipconfig; Unix用户输入ifconfig)及端口号，如果正常启动，输出

Start a static HTTP server in any directory

[10:26] $ python -m SimpleHTTPServer 5000Serving HTTP on 0.0.0.0 port 5000 ...

Note:关于开发网络服务器的提示。虽然 django 自带的这个 web 服务器对于开发很方便，但是，千万不要在正式的应用布署环境中使用它。在同一时间，该服务器只能可靠地处理一次单个请求，并且没有进行任何类型的安全审计。

概览

{接下来说明要配置/修改的文件及作用}

# models.py (the database tables)from django.db import modelsclass Book(models.Model):name = models.CharField(max_length=50)pub_date = models.DateField()# views.py (the business logic)from django.shortcuts import render_to_responsefrom models import Bookdef latest_books(request):book_list = Book.objects.order_by('-pub_date')[:10]return render_to_response('latest_books.html', {'book_list': book_list})# urls.py (the URL configuration)from django.conf.urls.defaults import *import viewsurlpatterns = patterns('',(r'^latest/$', views.latest_books),)# latest_books.html (the template)<html><head><title>Books</title></head><body><h1>Books</h1><ul>{% for book in book_list %}<li>{{ book.name }}</li>{% endfor %}</ul></body></html>

Note:不用关心语法细节；只要用心感觉整体的设计，几个文件：

models.py 文件主要用一个 Python 类来描述数据表。称为模型(model) 。运用这个类，你可以通过简单的 Python 的代码来创建、检索、更新、删除数据库中的记录而无需写一条又一条的SQL语句。

views.py文件包含了页面的业务逻辑。 latest_books()函数叫做视图。

urls.py 指出了什么样的 URL 调用什么的视图。在这个例子中 /latest/ URL 将会调用 latest_books() 这个函数。换句话说，如果你的域名是，任何人浏览网址/latest/将会调用latest_books()这个函数。

latest_books.html 是 html 模板，它描述了这个页面的设计是如何的。使用带基本逻辑声明的模板语言，如{% for book in book_list %}

这些部分松散遵循的模式称为模型-视图-控制器(MVC)。这种设计模式关键的优势在于各种组件都是松散结合的。这样，每个由 Django驱动的Web应用都有着明确的目的，并且可独立更改而不影响到其它的部分。比如，开发者更改一个应用程序中的 URL 而不用影响到这个程序底层的实现。设计师可以改变 HTML 页面的样式而不用接触 Python 代码。数据库管理员可以重新命名数据表并且只需更改一个地方，无需从一大堆文件中进行查找和替换。

视图和 URL 配置

{这样就可以通过127.0.0.1：8000/*访问特定内容了，如127.0.0.1：8000/music}

创建视图函数

在先前创建的 DjangoPIPI目录下的 DjangoPIPI目录新建一个view.py 文件，并输入代码：

fromdjango.httpimportHttpResponsedefhello(request): returnHttpResponse("Hello pipi!")

Note:

1. 这里的view还是没有和数据分开，比较low.

2. 定义一个叫做hello 的视图函数。每个视图函数至少要有一个参数，通常被叫作request。这是一个触发这个视图、包含当前Web请求信息的对象，是类django.http.HttpRequest的一个实例。在这个示例中，我们虽然不用request做任何事情，然而它仍必须是这个视图的第一个参数。注意视图函数的名称并不重要.这个函数只有简单的一行代码：它仅仅返回一个HttpResponse对象，这个对象包含了文本“Hello world”。

3.一个视图就是Python的一个函数。这个函数第一个参数的类型是HttpRequest；它返回一个HttpResponse实例。为了使一个Python的函数成为一个Django可识别的视图，它必须满足这两个条件。（也有例外）

绑定 URL 与视图函数

{为了绑定视图函数和URL，我们使用URLconf。通过一个详细描述的URL来显式的告诉它并且激活这个视图。URLconf就像是 Django 所支撑网站的目录。它的本质是 URL 模式以及要为该 URL 模式调用的视图函数之间的映射表。的‘}

打开urls.py 文件，注释掉url(r'^admin/', include(admin.site.urls))替换为以下代码：

fromdjango.conf.urlsimportpatterns, urlfrom.viewimporthellourlpatterns = patterns('',# Examples: # url(r'^$', 'VoteSite.views.home', name='home'), # url(r'^blog/', include('blog.urls')), # url(r'^admin/', include(admin.site.urls)), url('^hello/$', hello),)

Note:

1. url函数结构： url(regex,view,kwargs=None,name=None,prefix='')

2. patterns函数的第一个参数即是view的前缀[Django的url用法]

3. 告诉 Django，所有指向 URL/hello/的请求都应由hello这个视图函数来处理

4. Django在检查URL模式前，移除每一个申请的URL开头的斜杠(/)。这意味着我们为/hello/写URL模式不用包含斜杠(/)。如果有人申请访问/hello（尾部没有斜杠/）会怎样。因为我们的URL模式要求尾部有一个斜杠(/)，那个申请URL将不匹配。然而，默认地，任何不匹配或尾部没有斜杠(/)的申请URL，将被重定向至尾部包含斜杠的相同字眼的URL。（这是受配置文件setting中APPEND_SLASH项控制的)

5. 把hello视图函数作为一个对象传递，而不是调用它。

整个目录结构如下：

6.之前设置的host和port如下

'HOST': '127.0.0.1','PORT': '3306'

否则会出错：django.db.utils.operationalerror:<, "can't connect to mysql server on '127.0.0.1'(winerror 10061] No connection could be made because the target machine actively refused it)")

完成后，启动 Django 开发服务器，并在浏览器访问打开浏览器并访问：127.0.0.1：8000/hello/

输出：

Note:项目中如果代码有改动，服务器会自动监测代码的改动并自动重新载入，所以如果你已经启动了服务器则不需手动重启。

关于“404错误”

目前，我们的URLconf只定义了一个单独的URL模式：处理URL/hello/。当请求其他URL会怎么样呢？运行Django开发服务器并访问类似http://127.0.0.1:8000/goodbye/甚至http://127.0.0.1:8000/(网站根目录)。你将会看到一个 “Page not found” 页面。因为你的URL申请在URLconf中没有定义，所以Django显示Django的404 Error页.

这个页面比原始的404错误信息更加实用。它同时精确的告诉你Django调用哪个URLconf及其包含的每个模式。这样，你应该能了解到为什么这个请求会抛出404错误。当然，这些敏感的信息应该只呈现给你－开发者。如果是部署到了因特网上的站点就不应该暴露这些信息。出于这个考虑，这个“Page not found”页面只会在调试模式（debug mode）下显示。

Django是怎么处理请求的

所有均开始于setting文件。当你运行python manage.pyrunserver，脚本将在于manage.py同一个目录下查找名为setting.py的文件。这个文件包含了所有有关这个Django项目的配置信息，均大写： TEMPLATE_DIRS , DATABASE_NAME, 等. 最重要的设置时ROOT_URLCONF，它将作为URLconf告诉Django在这个站点中那些Python的模块将被用到。

当访问 URL /hello/ 时，Django 根据 ROOT_URLCONF 的设置装载 URLconf 。然后按顺序逐个匹配URLconf里的URLpatterns，直到找到一个匹配的。当找到这个匹配的URLpatterns就调用相关联的view函数，并把 HttpRequest 对象作为第一个参数。

一个视图功能必须返回一个HttpResponse。一旦做完，Django将完成剩余的转换Python的对象到一个合适的带有HTTP头和body的Web Response（例如，网页内容）。

总结：

进来的请求转入/hello/.

Django通过在ROOT_URLCONF配置来决定根URLconf.

Django在URLconf中的所有URL模式中，查找第一个匹配/hello/的条目。

如果找到匹配，将调用相应的视图函数

视图函数返回一个HttpResponse

Django转换HttpResponse为一个适合的HTTP response，以Web page显示出来

设计具有动态内容的视图

前面网页的内容一直是一样的. 每次去查看/hello/，你将会看到相同的内容，它类似一个静态HTML文件。

下面的网页是计算当前日期和时间，并返回包含这些值的HttpResponse。

view.py中加入current_datetime视图函数

importdatetimefromdjango.httpimportHttpResponsedefhello(request): returnHttpResponse("Hello pipi!")defcurrent_datetime(request): now = datetime.datetime.now()html = "<html><body>It is now %s.</body></html>" % nowreturnHttpResponse(html)

Note:目前HTML是有错误的，但我们这样做是为了保持例子的简短。

还要在urls.py中添加URL模式，以告诉Django由哪一个URL来处理这个视图:

from django.conf.urls import patterns, urlfrom .view import hello, current_datetimeurlpatterns = patterns('',# Examples:# url(r'^$', 'VoteSite.views.home', name='home'),# url(r'^blog/', include('blog.urls')),# url(r'^admin/', include(admin.site.urls)),url('^hello/$', hello),('^time/$', current_datetime),)

Django时区

视乎你的机器，显示的日期与时间可能和实际的相差几个小时。这是因为Django是有时区意识的，并且默认时区为America/Chicago。（它必须有个值，它的默认值是Django的诞生地：美国/芝加哥）如果你处在别的时区，你需要在settings.py文件中更改这个值。请参见它里面的注释，以获得最新世界时区列表。

URL配置和松耦合

Django和URL配置背后的哲学：松耦合原则。简单的说，松耦合是一个重要的保证互换性的软件开发方法。

Django的URL配置就是一个很好的例子。在Django的应用程序中，URL的定义和视图函数之间是松耦合的，换句话说，决定URL返回哪个视图函数和实现这个视图函数是在两个不同的地方。这使得开发人员可以修改一块而不会影响另一块。例如，考虑一下current_datetime视图。如果我们想把它的URL 从原来的/time/改变到/currenttime/，我们只需要快速的修改一下URL配置即可，不用担心这个函数的内部实现。同样的，如果我们想要修改这个函数的内部实现也不用担心会影响到对应的URL。

此外，如果我们想要输出这个函数到一些URL，我们只需要修改URL配置而不用去改动视图的代码。在这个例子里，current_datetime被两个URL使用。

urlpatterns = patterns('',('^hello/$', hello),('^time/$', current_datetime),('^another-time-page/$', current_datetime),)

设计具有动态URL的视图

创建第三个视图来显示当前时间和加上时间偏差量的时间，设计是这样的：/time/plus/1/显示当前时间＋1个小时的页面/time/plus/2/显示当前时间＋2个小时的页面/time/plus/3/显示当前时间＋3个小时的页面，以此类推。

新手可能会考虑写不同的视图函数来处理每个时间偏差量，URL配置看起来就象这样：

urlpatterns = patterns('',('^time/$', current_datetime),('^time/plus/1/$', one_hour_ahead),('^time/plus/2/$', two_hours_ahead),('^time/plus/3/$', three_hours_ahead),('^time/plus/4/$', four_hours_ahead),)

如果你有其它web平台的开发经验（如PHP或Java），你可能会想用查询字符串参数吧！就像/time/plus?hours=3里面的小时应该在查询字符串中被参数hours指定（问号后面的是参数）。

Django的URL配置系统可以使你很容易的设置漂亮的URL，使用通配符（wildcard URLpatterns）。我们把它限制在最大允许99个小时：

from django.conf.urls.defaults import *from mysite.views import hello, current_datetime, hours_aheadurlpatterns = patterns('',(r'^hello/$', hello),(r'^time/$', current_datetime),(r'^time/plus/(\d{1,2})/$', hours_ahead),)

Note:正则表达式字符串的开头字母“r”。它告诉Python这是个原始字符串，不需要处理里面的反斜杠（转义字符）。在普通Python字符串中，反斜杠用于特殊字符的转义。由于反斜杠在Python代码和正则表达式中有冲突，因此建议你在Python定义正则表达式时都使用原始字符串。从现在开始，本文所有URL模式都用原始字符串。

view代码：

from django.http import Http404, HttpResponseimport datetimedef hours_ahead(request, offset):try:offset = int(offset)except ValueError:raise Http404()dt = datetime.datetime.now() + datetime.timedelta(hours=offset)html = "<html><body>In %s hour(s), it will be %s.</body></html>" % (offset, dt)return HttpResponse(html)

Note:

1. 视图函数,hours_ahead, 有两个参数:request和offset.

request是一个HttpRequest对象, 就像在current_datetime中一样. 每一个视图总是以一个HttpRequest对象作为它的第一个参数。

offset是从匹配的URL里提取出来的。例如：如果请求URL是/time/plus/3/，那么offset将会是3。请注意：捕获值永远都是字符串（string）类型，而不会是整数（integer）类型。（从技术上来说，捕获值总是Unicode objects，而不是简单的Python字节串）变量名是无关紧要的，重要的是它的位置，它是这个函数的第二个参数 (在request的后面）。你还可以使用关键字来定义它，而不是用位置。

2. datetime.timedelta函数要求hours参数必须为整数类型。

3. 最终，返回一个HTML的HttpResponse。如今，这种方式已经过时了。