diff --git a/.gitignore b/.gitignore index 02317625bbc94549a51d14a5da7fa0f5053a34bf..52c6f0e77be7ca3f1a02d080462750fedebfeefe 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,4 @@ venv .idea *.pyc + diff --git "a/Day31/Django\345\256\236\346\210\230(01) - \345\277\253\351\200\237\344\270\212\346\211\213.md" "b/Day31/Django 2.x\345\256\236\346\210\230(01) - \345\277\253\351\200\237\344\270\212\346\211\213.md" similarity index 60% rename from "Day31/Django\345\256\236\346\210\230(01) - \345\277\253\351\200\237\344\270\212\346\211\213.md" rename to "Day31/Django 2.x\345\256\236\346\210\230(01) - \345\277\253\351\200\237\344\270\212\346\211\213.md" index 68f1023b69dd413fa46cd8f8f1d1e87c8135d936..d75fa5478a2c33bcb5b003ce7462b7c7e6ea9796 100644 --- "a/Day31/Django\345\256\236\346\210\230(01) - \345\277\253\351\200\237\344\270\212\346\211\213.md" +++ "b/Day31/Django 2.x\345\256\236\346\210\230(01) - \345\277\253\351\200\237\344\270\212\346\211\213.md" @@ -1,4 +1,4 @@ -## Django实战(01) - 快速上手 +## Django 2.x实战(01) - 快速上手 Web开发的早期阶段,开发者需要手动编写每个页面,例如一个新闻门户网站,每天都要修改它的HTML页面,这样随着网站规模和体量的增大,这种方式就变得极度糟糕。为了解决这个问题,开发人员想到了用外部程序来为Web服务器生成动态内容,也就是说HTML页面以及页面中的动态内容不再通过手动编写而是通过程序自动生成。最早的时候,这项技术被称为CGI(公共网关接口),当然随着时间的推移,CGI暴露出的问题也越来越多,例如大量重复的样板代码,总体性能较为低下等,因此在呼唤新的英雄的时代,PHP、ASP、JSP这类Web应用开发技术在上世纪90年代中后期如雨后春笋般涌现。通常我们说的Web应用是指通过浏览器来访问网络资源的应用程序,因为浏览器的普及性以及易用性,Web应用使用起来方便简单,而且在应用更新时用户通常不需要做任何的处理就能使用更新后的应用,而且也不用关心用户到底用的是什么操作系统,甚至不用区分是PC端还是移动端。 @@ -8,6 +8,8 @@ Web开发的早期阶段,开发者需要手动编写每个页面,例如一 ![](./res/web-application.png) +> 说明:相信有经验的读者会发现,这张图中其实还少了很多东西,例如反向代理服务器、数据库服务器、防火墙等,而且图中的每个节点在实际项目部署时可能是一组节点组成的集群。当然,如果你对这些没有什么概念也不要紧,后续的课程中我们会为大家进行讲解。 + | 术语 | 解释 | | ------------- | ------------------------------------------------------------ | | **URL/URI** | 统一资源定位符/统一资源标识符,网络资源的唯一标识 | @@ -19,13 +21,24 @@ Web开发的早期阶段,开发者需要手动编写每个页面,例如一 | **Web服务器** | 接受HTTP请求,然后返回HTML文件、纯文本文件、图像等资源给请求者 | | **Nginx** | 高性能的Web服务器,也可以用作[反向代理](https://zh.wikipedia.org/wiki/%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86),[负载均衡](https://zh.wikipedia.org/wiki/%E8%B4%9F%E8%BD%BD%E5%9D%87%E8%A1%A1) 和 [HTTP缓存](https://zh.wikipedia.org/wiki/HTTP%E7%BC%93%E5%AD%98) | +#### HTTP协议 -### Python的Web框架 +这里我们稍微费一些笔墨来谈谈上面提到的HTTP。HTTP(超文本传输协议)是构建于TCP(传输控制协议)之上应用级协议,它利用了TCP提供的可靠的传输服务实现了Web应用中的数据交换。按照维基百科上的介绍,设计HTTP最初的目的是为了提供一种发布和接收[HTML](https://zh.wikipedia.org/wiki/HTML)页面的方法,也就是说这个协议是浏览器和Web服务器之间传输的数据的载体。关于这个协议的详细信息以及目前的发展状况,大家可以阅读阮一峰老师的[《HTTP 协议入门》](http://www.ruanyifeng.com/blog/2016/08/http.html)、[《互联网协议入门》](http://www.ruanyifeng.com/blog/2012/05/internet_protocol_suite_part_i.html)系列以及[《图解HTTPS协议》](http://www.ruanyifeng.com/blog/2014/09/illustration-ssl.html)进行了解,下图是我于2009年9月10日凌晨4点在四川省网络通信技术重点实验室用开源协议分析工具Ethereal(抓包工具WireShark的前身)截取的访问百度首页时的HTTP请求和响应的报文(协议数据),由于Ethereal截取的是经过网络适配器的数据,因此可以清晰的看到从物理链路层到应用层的协议数据。 -Python的Web框架有上百个,比它的关键字还要多。所谓Web框架,就是用于开发Web服务器端应用的基础设施(通常指封装好的模块和一系列的工具)。事实上,即便没有Web框架,我们仍然可以通过socket或[CGI](https://zh.wikipedia.org/wiki/%E9%80%9A%E7%94%A8%E7%BD%91%E5%85%B3%E6%8E%A5%E5%8F%A3)来开发Web服务器端应用,但是这样做的成本和代价在实际开发中通常是不能接受的。通过Web框架,我们可以化繁为简,同时降低创建、更新、扩展应用程序的工作量。Python的Web框架中比较有名的有:Flask、Django、Tornado、Pyramid、Bottle、Web2py、web.py等。 +HTTP请求(请求行+请求头+空行+[消息体]): + +![](./res/http-request.png) + +HTTP响应(响应行+响应头+空行+消息体): + +![](./res/http-response.png) + +> 说明:但愿这两张如同泛黄的照片般的截图帮助你大概的了解到HTTP是一个怎样的协议。 ### Django概述 +Python的Web框架有上百个,比它的关键字还要多。所谓Web框架,就是用于开发Web服务器端应用的基础设施(通常指封装好的模块和一系列的工具)。事实上,即便没有Web框架,我们仍然可以通过socket或[CGI](https://zh.wikipedia.org/wiki/%E9%80%9A%E7%94%A8%E7%BD%91%E5%85%B3%E6%8E%A5%E5%8F%A3)来开发Web服务器端应用,但是这样做的成本和代价在实际开发中通常是不能接受的。通过Web框架,我们可以化繁为简,同时降低创建、更新、扩展应用程序的工作量。Python的Web框架中比较有名的有:Flask、Django、Tornado、Pyramid、Bottle、Web2py、web.py等。 + 在基于Python的Web框架中,Django是所有重量级选手中最有代表性的一位,开发者可以基于Django快速的开发可靠的Web应用程序,因为它减少了Web开发中不必要的开销,对常用的设计和开发模式进行了封装,并对MVC架构提供了支持(MTV)。许多成功的网站和App都是基于Django框架构建的,国内比较有代表性的网站包括:知乎、豆瓣网、果壳网、搜狐闪电邮箱、101围棋网、海报时尚网、背书吧、堆糖、手机搜狐网、咕咚、爱福窝、果库等。 ![](./res/mvc.png) @@ -49,11 +62,11 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目 >>> sys.version_info ``` -2. 创建项目文件夹并切换到该目录。 +2. 创建项目文件夹并切换到该目录,例如我们要实例一个OA(办公自动化)项目。 ```Shell - $ mkdir hello_django - $ cd hello_django + $ mkdir oa + $ cd oa ``` 3. 创建并激活虚拟环境。 @@ -69,7 +82,7 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目 ```Shell (venv)$ python -m pip install --upgrade pip ``` - > 注意:虚拟环境下的python和pip已经是Python 3的解释器和包管理工具了。 + > 注意:请注意终端提示符发生的变化,前面的`(venv)`说明我们已经进入虚拟环境,而虚拟环境下的python和pip已经是Python 3的解释器和包管理工具了。 5. 安装Django。 @@ -77,7 +90,7 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目 (venv)$ pip install django ``` - 或 + 或指定版本号来安装对应的Django的版本。 ```Shell (venv)$ pip install django==1.11 @@ -95,23 +108,32 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目 >>> import django >>> django.get_version() ``` - ![](./res/django-version.png) + 下图展示了Django版本和Python版本的对应关系,在我们的项目中我们选择了最新的Django 2.0的版本。 + + | Django版本 | Python版本 | + | ---------- | ----------------------- | + | 1.8 | 2.7、3.2、3.3、3.4、3.5 | + | 1.9、1.10 | 2.7、3.4、3.5 | + | 1.11 | 2.7、3.4、3.5、3.6 | + | 2.0 | 3.4、3.5、3.6 | + + > 说明:在创建这篇文章时Django 2.1版本尚未正式发布,因此我们的教程使用了2.0.5版本。 -7. 使用`django-admin`创建项目。 +7. 使用`django-admin`创建项目,项目命名为oa。 ```Shell - (venv)$ django-admin startproject hello_django . + (venv)$ django-admin startproject oa . ``` - > 注意:上面的命令最后的.表示在当前路径下创建项目。 + > 注意:上面的命令最后的那个点,它表示在当前路径下创建项目。 执行上面的命令后看看生成的文件和文件夹,它们的作用如下所示: - `manage.py`: 一个让你用各种方式管理 Django 项目的命令行工具。 - - `hello_django/__init__.py`:一个空文件,告诉 Python 这个目录应该被认为是一个 Python 包。 - - `hello_django/settings.py`:Django 项目的配置文件。 - - `hello_django/urls.py`:Django 项目的 URL 声明,就像你网站的“目录”。 - - `hello_django/wsgi.py`:作为你的项目的运行在 WSGI 兼容的Web服务器上的入口。 + - `oa/__init__.py`:一个空文件,告诉 Python 这个目录应该被认为是一个 Python 包。 + - `oa/settings.py`:Django 项目的配置文件。 + - `oa/urls.py`:Django 项目的 URL 声明,就像你网站的“目录”。 + - `oa/wsgi.py`:作为你的项目的运行在 WSGI 兼容的Web服务器上的入口。 8. 启动服务器运行项目。 @@ -119,32 +141,65 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目 (venv)$ python manage.py runserver ``` + 在浏览器中输入访问我们的服务器,效果如下图所示。 + + ![](./res/django-index-1.png) + + > 说明1:刚刚启动的是Django自带的用于开发和测试的服务器,它是一个用纯Python编写的轻量级Web服务器,但它并不是真正意义上的生产级别的服务器,千万不要将这个服务器用于和生产环境相关的任何地方。 > 说明2:用于开发的服务器在需要的情况下会对每一次的访问请求重新载入一遍Python代码。所以你不需要为了让修改的代码生效而频繁的重新启动服务器。然而,一些动作,比如添加新文件,将不会触发自动重新加载,这时你得自己手动重启服务器。 > 说明3:可以通过`python manage.py help`命令查看可用命令列表;在启动服务器时,也可以通过`python manage.py runserver 1.2.3.4:56789`来指定绑定的IP地址和端口。 -9. 创建应用程序(一个项目可以包含多个应用程序)。 + > 说明4:可以通过Ctrl+C来终止服务器的运行。 + +9. 接下来我们进入项目目录oa并修改配置文件settings.py,Django是一个支持国际化和本地化的框架,因此刚才我们看到的默认首页也是支持国际化的,我们将默认语言修改为中文,时区设置为东八区。 + + ```Shell + (venv)$ cd oa + (venv)$ vim settings.py + ``` + + ```Python + # 此处省略上面的内容 + + # 设置语言代码 + LANGUAGE_CODE = 'zh-hans' + # 设置时区 + TIME_ZONE = 'Asia/Chongqing' + + # 此处省略下面的内容 + ``` + +10. 回到manage.py所在的目录,刷新刚才的页面。 + + ```Shell + (venv)$ cd .. + (venv)$ python manage.py runserver + ``` + + ![](./res/django-index-2.png) + +#### 动态页面 + +1. 创建名为hrs(人力资源系统)的应用(注:一个项目可以包含多个应用)。 ```Shell (venv)$ python manage.py startapp hrs ``` - 创建的目录结构如下所示: + 执行上面的命令会在当前路径下创建hrs目录,其目录结构如下所示: - `__init__.py`:一个空文件,告诉 Python 这个目录应该被认为是一个 Python 包。 - `admin.py`:可以用来注册模型,让Django自动创建管理界面。 - `apps.py`:当前应用的配置。 - - `migrations`:存放与模型有关的数据库信息。 - - `__init__.py`:略过。 + - `migrations`:存放与模型有关的数据库迁移信息。 + - `__init__.py`:一个空文件,告诉 Python 这个目录应该被认为是一个 Python 包。 - `models.py`:存放应用的数据模型,即实体类及其之间的关系(MVC/MVT中的M)。 - - `tests.py`:测试应用的各种测试函数。 + - `tests.py`:包含测试应用各项功能的测试类和测试函数。 - `views.py`:处理请求并返回响应的函数(MVC中的C,MVT中的V)。 - -#### 动态页面 - -1. 进入应用目录修改视图文件views.py。 +2. 进入应用目录修改视图文件views.py。 ```Shell (venv)$ cd hrs @@ -160,7 +215,7 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目 ``` -2. 在应用目录创建一个urls.py文件并映射URL。 +3. 在应用目录创建一个urls.py文件并映射URL。 ```Shell (venv)$ touch urls.py @@ -176,13 +231,13 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目 path('', views.index, name='index'), ] ``` - > 说明:上面使用的path函数是Django 2.0中新添加的函数,除此之外还有re_path是支持正则表达式的URL映射函数;Django 1.x中是用url函数来设定URL映射。 + > 说明:上面使用的path函数是Django 2.x中新添加的函数,除此之外还有re_path是支持正则表达式的URL映射函数;Django 1.x中是用url函数来设定URL映射。 -3. 切换到项目目录,修改该目录下的urls.py文件合并应用中设定的URL。 +4. 切换到项目目录,修改该目录下的urls.py文件,对应用中设定的URL进行合并。 ```Shell (venv) $ cd .. - (venv) $ cd hello_django + (venv) $ cd oa (venv) $ vim urls.py ``` @@ -196,9 +251,10 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目 ] ``` -4. 启动项目并访问应用。 +5. 启动项目并访问应用。 ```Shell + (venv)$ cd .. (venv)$ python manage.py runserver ``` @@ -206,7 +262,7 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目 > 说明:如果想实现远程访问,需要先确认防火墙是否已经打开了8000端口,而且需要在配置文件settings.py中修改ALLOWED_HOSTS的设置,添加一个'*'表示允许所有的客户端访问Web应用。 -5. 修改views.py生成动态内容。 +6. 修改views.py生成动态内容。 ```Shell (venv)$ cd hrs @@ -245,9 +301,9 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目 #### 使用视图模板 -上面生成动态视图的方式在实际开发中是无法接受的,为了解决这个问题,我们可以提前准备一个模板页,所谓模板页就是一个带占位符的HTML页面,当我们将程序中获得的数据替换掉占位符的时候,一个动态页面就生成好了。 +上面通过拼接HTML代码的方式生成动态视图的做法在实际开发中是无能接受的,这一点我相信是不言而喻的。为了解决这个问题,我们可以提前准备一个模板页,所谓模板页就是一个带占位符的HTML页面,当我们将程序中获得的数据替换掉页面中的占位符时,一个动态页面就产生了。 -可以用Django框架中template模块的Template类创建模板对象,通过模板对象的render方法实现对模板的渲染。所谓的渲染就是用数据替换掉模板页中的占位符,Django框架通过shortcuts模块的快捷函数render简化了渲染模板的操作,具体的用法如下所示。 +我们可以用Django框架中template模块的Template类创建模板对象,通过模板对象的render方法实现对模板的渲染。所谓的渲染就是用数据替换掉模板页中的占位符,Django框架通过shortcuts模块的快捷函数render简化了渲染模板的操作,具体的用法如下所示。 1. 先回到manage.py文件所在的目录创建一个templates文件夹。 @@ -273,7 +329,7 @@ Django诞生于2003年,它是一个在真正的应用中成长起来的项目

{{ greeting }}


-

今天推荐3种水果是:

+

今天推荐{{ num }}种水果是: