2-第一个Django程序

第一个Django程序

从本章节开始将经过实现一个投票应用程序，来让用户逐步的了解Django。这个程序由两步分组成：

• 公共站点，容许用户访问进行投票，和查看投票。
• 站点管理，容许添加，删除，修改投票信息。

一、建立项目

本文继承前一篇章节的环境（centos 7  python3.6.2 Django2.2）进行演示：

1.1 建立存放项目的目录

[root@localhost ~]# cd /opt/
[root@localhost opt]# mkdir source_project      # 建立Django项目存放目录

1.2 建立Django项目

[root@localhost opt]# cd source_project/
[root@localhost source_project]# django-admin startproject mysite   # 建立名为mysite的Django项目

建立完成后会在当前目录下生成一个mysite的目录。这个目录的结构以下：

mysite项目文档结构简介：

mysite/：项目的根目录，只是项目的一个容器。它的名字对Django来讲并不重要;您能够将其重命名为任何您喜欢的名称。

mysite/manage.py：一个命令行实用程序，容许您以各类方式与Django项目交互。您能够在django-admin和manage .py中阅读关于manage .py的全部细节。

关于django-admin和manage .py参考文档：https://docs.djangoproject.com/en/2.2/ref/django-admin/

mysite/mysite：这个目录是一个python包，能够经过这个包名来导出想要使用的模块。

mysite/mysite/__init__.py：一个空文件，它告诉Python应该把这个目录看做一个Python包。

关于python包请参考：https://docs.python.org/3/tutorial/modules.html#tut-packages

mysite/mysite/settings.py：Django项目的配置文件。关于配置文件的一些设置，目前还不打算所有过一遍，用到哪项就对哪项进行设置便可。

settings.py的设置选项可参考：https://docs.djangoproject.com/en/2.2/topics/settings/

settings.py中选项值可参考：https://docs.djangoproject.com/en/2.2/ref/settings/

mysite/mysite/urls.py：django项目的URL路径。

urls.py的配置信息请参考：https://docs.djangoproject.com/en/2.2/topics/http/urls/

mysite/mysite/wsgi.py：一个与wsgi兼容的web服务器服务于您的项目的入口点。

关于wsgi.py请参考：https://docs.djangoproject.com/en/2.2/howto/deployment/wsgi/

1.3 验证Django项目是否能够启动

[root@localhost source_project]# cd mysite/     # 进入到项目目录中
[root@localhost mysite]# python3 manage.py runserver  # 运行项目

你也许会报下面这个错误，但请不要慌张。

我以为错误的问题不在这，继续往上找咱们会看到以下：

我以为问题可能出现这里，查看下本机sqlite3数据库版本，以下：

1.4 安装sqlite3新版本sqlite3.31。

下载sqlite3新版本

[root@localhost mysite]# wget -P /usr/src/ https://www.sqlite.org/2020/sqlite-autoconf-3310100.tar.gz
[root@localhost mysite]# tar -zxvf /usr/src/sqlite-autoconf-3310100.tar.gz -C /opt/
[root@localhost mysite]# cd /opt/sqlite-autoconf-3310100/  # 进入解压后的包中
[root@localhost sqlite-autoconf-3310100]# ./configure --prefix=/opt/sqlite3310  # 配置安装选项
[root@localhost sqlite-autoconf-3310100]# make && make install  # 编译 安装

安装完成后咱们看下该目录结构以下：

1.5 将新版本的sqlite3.31替换系统自带的旧版sqlite3.7.17

[root@localhost bin]#whereis sqlite3   # 查找sqlite3命令所在的位置

[root@localhost bin]#cd /opt/sqlite3310/bin
[root@localhost bin]# mv /usr/bin/sqlite3 /usr/bin/sqlite37  # 重命名旧版本的sqlite3
[root@localhost bin]# cp sqlite3 /usr/bin/sqlite3 # 将新版本的sqlite3复制到/usr/bin/目录中
[root@localhost bin]# echo "/opt/sqlite3310/lib/" > /etc/ld.so.conf.d/sqlite3.conf  # 指定将新版本的库位置
[root@localhost bin]# ldconfig  # 更新动态连接库

完成上面的全部工做后，咱们新安装的sqlite3.31就能够代替旧版本的sqlite3.7.17。

1.6 验证sqlite3,31是否正常工做

在python环境中进行验证

好了，如今咱们回到Django项目中运行Django项目，查看是否能够运行。

[root@localhost bin]# cd /opt/source_project/mysite/
[root@localhost mysite]# python3 manage.py runserver  # 运行Django项目

若是你看到以下界面，那么恭喜你，你的项目已经运行起来了。

从上面的图片咱们能够知道，服务运行在本地的127.0.0.1:8000上，此时只能本机进行访问，局域网的其它主机是不能访问的。咱们能够指定服务器的IP地址及端口号（以下192.168.10.100:8000），来让局域网的其它主机进行访问。

咱们在局域网访问http://192.168.10.100:8000，看看会出现什么，若是不能访问，请把本机的防火墙关闭掉，在试试，

[root@localhost mysite]# systemctl stop firewalld  # 关闭防火墙

再次访问http://192.168.10.100:8000，若是一切顺利你会看到以下所示：

没错，咱们的访问被拒绝了，此时咱们须要修改mysite项目中mysite目录下的settings.py文件了。

[root@localhost mysite]# vim mysite/settings.py

在配置文件中你会看到以下配置选项：

关于ALLOWED_HOSTS的值能够是主机名，也能够是IP地址
# 匹配主机名，若是是完整的主机名如www.example.com，那么将只匹配www.example.com
# 在匹配的过程当中不区分大小写
ALLOWED_HOSTS = ['www.example.com']

# 匹配主机名，若是不是完整的主机名如.example.com，那么能够匹配全部带example.com的域名，如www.exarmple.com，abc.exarmple.com，a.exarmple.com
# 在匹配的过程当中不区分大小写
ALLOWED_HOSTS = ['.example.com']

# 匹配IP地址和主机名
ALLOWED_HOSTS = ['www.example.com','192.168.1.10','192.168.1.200']

# 容许全部主机访问Django服务器
ALLOWED_HOSTS = ['*']

咱们是初学就将该选项设置为容许全部主机均可以访问Django服务器ALLOWED_HOSTS = ['*']，而后再次容许Django服务器：

root@localhost mysite]# python3 manage.py runserver 192.168.10.100:8000

继续访问http://192.168.10.100:8000，若是一切顺利你会看到以下所示：

---

 二、建立web应用程序投票App

应用程序：是指一个web应用程序，它是一个功能的集合，如登陆认证，数据展现，还有咱们接下来将要写的投票功能等。

Django项目和应用程序的区别是：项目是一个特定网站的配置和应用程序的集合。应用程序是一个Web应用程序，是一个功能的集合例如，一个Weblog系统、一个公共记录数据库或一个简单的投票应用程序等。

一个项目能够包含多个应用程序。一个应用程序能够在多个项目中。

2.1建立投票app

[root@localhost mysite]# python3 manage.py startapp polls  # 建立投票应用

该命令会为咱们自动生成应用程序的基本目录结构，所以您能够专一于编写代码，而不是建立目录。该目录结构以下：

应用程序polls建立好后，咱们须要在该目录下的views.py中实现投票的功能。

2,2 初识视图views.py

[root@localhost mysite]# vim polls/views.py  # 编辑views.py，在该文件中添加以下代码
from django.shortcuts import render
from django.http import HttpResponse
# Create your views here.
def index(request):
    return HttpResponse('这是个人第一个web应用')

这是最简单的视图。要调用视图，咱们须要将它映射到一个URL，由于Django服务器是经过URL路由来寻找视图的，为此咱们须要在polls目录中建立名为urls.py的文件。

2.3 建立urls.py

[root@localhost mysite]# vim polls/urls.py # 建立URL路由，在路由中写入以下内容。
from django.urls import path
from . import views

urlpatterns = [
    path('',views.index,name='index'),
]

此时咱们的polls应用的目录结构以下：

虽然咱们在polls中设置了路由，但目前该路由仅局限于本polls应用内部，Django主程序还没法找到polls中的URL路由，须要在Django主程序的URL中告诉polls中URL的位置，这样主程序才能找到polls中的URL。

2.4 在主程序mysite/mysite/urls.py引用polls/urls.py

[root@localhost mysite]# vim mysite/urls.py  # 编辑主程序中URL，在主程序的URL中引用polls中的URL
from django.contrib import admin
from django.urls import path,include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('polls/', include('polls.urls')),   # 引用polls中的URL，这样主程序即可以找到polls中的URL了
]

2.5 验证

通过上面一系列的操做，如今咱们来验证Django是否能够正常工做。

[root@localhost mysite]# python3 manage.py runserver 192.168.10.100:8000  # 启动服务

访问http://192.168.10.100:8000

咱们发现和最开始访问时不同了，而且咱们发现咱们刚刚建立的polls应用也在上面。

咱们尝试访问http://192.168.10.100:8000/polls/看看会发生什么

没错是咱们刚刚在polls/views.py中写入的内容。这说明咱们建立的polls应用能够工做了，虽然没有实现投票的功能，但离实现投票的功能进了一步。

 参考文档：https://docs.djangoproject.com/en/2.2/intro/tutorial01/