《Flask Web开发——基于Python的Web应用开发实践》一字一句上机实践（上）

目录

前言

第1章 安装

第2章 程序的基本结构

第3章 模板

第4章 Web表单

第5章 数据库

第6章 电子邮件

第7章 大型程序的结构

 

 

---

前言

学习Python也有一个半月时间了，学到如今感受仍是初步入门阶段，若是不借助网上Demo资源，几乎不能本身写出相关趁心的东西。目前感受本身仍是有点失败啊，学的太慢了点。主要感受仍是本身刚开始学习时有点浮躁，一心求快，看资料时前期都是囫囵吞枣。

 

刚开始买了一本《Python基础教程 第2版》，大约花了10天看完，初步了解了Python语法相关特性以及如何连接后台数据库。那时，看完后又买了《Python Web开发实践》和《Flask Web开发——基于Python的Web应用开发实践》。而后，花了5天时间把《Flask Web开发——基于Python的Web应用开发实践》看了一遍，之因此这么快，是由于看到了第八章时，发现代码有点弄不懂，并且从做者GitHub上克隆下来的代码运行还有Bug，因此选择了快速看完了后面几章，大概了解一下实现思路。而后，开始看《Python Web开发实践》，发现这本书的要求好高啊，初学者想看懂它，花的时间没有两三周还搞不定（PS：主要是里面讲的注重经验，没有实践项目），因而也选择了4天时间初步浏览了一遍。到了这里，我开始选择看网络教程，把廖雪峰老师的Python教程从基础部分一章一章上机实践操做了一遍（PS：最后的项目实战没操做），这个也差很少花了8天时间。后面又花了5天时间在网上找了几篇高质量关于使用Flask+MySQL实现用户登录注册功能的Demo。到此，感受对于Python基础掌握的更好了一点。发现学技术，尤为是新技术，要踏实，求稳。

 

因此，我选择了从新再看一遍《Flask Web开发——基于Python的Web应用开发实践》，并争取把书中每个示例运行出来，若是发现Bug，就解决。在这一趟学习过程当中，发现有关Flask的中文学习资源广泛没有英文高，并且相关技术学习书籍都是英文版翻译过来的。翻译过来的问题就是，书已经出版了两三年，有些模块库更新，致使书中代码实际就不能运行，还加上做者本身当时的微小错误没跟新。

 

本文先上传第1章到第7章的学习实践记录(PS:第8-14章见《Flask Web开发——基于Python的Web应用开发实践》一字一句上机实践（下）)，目前我也是从新学到了这里。若是有学过Flask的前辈路过，有什么好的学习资源推荐，不甚感激。

 

叨叨絮絮有点多，本文主要内容就是记载本身在学习《Flask Web开发——基于Python的Web应用开发实践》时，上机运行相关示例遇到的坑以及一点心得体会，但愿对于其余初学Flask的同窗有点帮助。

 

附：《Flask Web开发——基于Python的Web应用开发实践》做者博客、做者网络教程版、做者本书GitHub代码连接

本书封面

 

 

 

---

第1章 安装

本部份内容安装书上内容一步一步来操做，很简单，基本不会出现问题。

注：本章主要教会初学者，如何安装虚拟环境。使用虚拟环境一段时间后，会发现学习Python，使用虚拟环境真的是很强大，能够避免Python解释器中包的混乱和版本的冲突，并且还不须要依赖管理员权限。

 

 

---

第2章  程序的基本结构

1.书本15页上方第二段代码：

 

 

上图中所示问题我特意查看了一下关于load_user()方法的调用及其做用，官方文档写明以下：

你须要提供一个 user_loader 回调。这个回调用于从会话中存储的用户 ID 从新加载用户对象。它应该接受一个用户的 unicode ID，并返回相应的用户对象。 例如: 
@login_manager.user_loader 
def load_user(userid): 
    return User.get(userid) 
若是 ID 无效，它应该返回 None （ 而不是抛出异常 ）。（在这种状况下，ID 会 被手动从会话中移除且处理会继续。） 

 

2.书本16页左上角示例错误更改（PS：此处问题应该是包版本升级致使，不过做者关于该项目github上源码已更新）：

 

 

此处错误，在后续章节中，出现相似flask.ext.**均修改成flask_**便可。

 

注：经过第2章，让我简单了解了Flask框架的基本运用方式。其中关键在于路由和视图函数的实现以及如何启动服务器，难点在于请求钩子概念的理解，我把这段概念反复看了好几遍，也只能理解讲解的文字表面意思，关于如何运用依旧是一头雾水。

 

 

---

第3章 模板

按照书本上所述，一步一步进行操做，便可获得以下运行结果：

 

 

此处要注意一点就是，直接从GitHub上克隆出的代码，直接运行hello.py文件是行不通的。须要在hello.py文件最末端添加以下两行代码：

if __name__ == '__main__':
    app.run(port = 8000,debug = True)

 

上述代码意思是，打开Flask自带服务器，开启端口是8000，且处于调试模式。

 

注：第3章内容没有难点，认真看一下书上解释，很快就能弄懂相关代码意图。本章重点介绍了Jinja2模板引擎的运用（PS：此处建议初学者到网上看一下Jinja2的开发文档，加深理解），以及Flask-Bootstrap和Flask-Moment模块的使用方法，感受全部功能都是已经写好的，只管调用便可，很方便。

 

---

第4章 Web表单

1.书本34页示例4-2代码更新（PS：引入包也要改为from flask_wtf import Form，后续章节同样）：

 

 

Class wtforms.validators.DataRequired(message=None)
此验证器将会检测field是否输入了数值，其实是进行了if field.data操做。而且，如数数据是一个字符串，那么只包含空格的字符串将会被认为是False。
参数：message-当验证失败时返回的错误消息数：message-当验证失败时返回的错误消息。

此处做者GitHub上已更新。具体应用原理能够查看Flask-WTF开发文档。

 

2.看看学习本章内容实际运行效果图：

 

 

注：本章内容主要讲解了Flask-WTF的应用，此处强烈建议初学者先看一下Flask-WTF的开发文档，再来进行第四章的学习，这样理解会更加深入一点，学的也会更快一点。

除此以外，还详细介绍了重定向和用户会话功能：主要是Post/重定向/Get模式，经过重定向实现了页面刷新仍然能够记住以前请求的数据，使得网页功能更加人性化和智能化。

最后，就是Flash消息功能的应用，经过此功能结合Flask-BootStrap包，在网页上进行相关提示操做简直是完美。

本章节从做者GitHub上下载的代码均是修过正的，不过书本是2014年出版，相关错误以及代码更新部分需注意便可。

 

 

---

第5章 数据库

1.书本47页示例5-1代码部分有bug，按照书本后续讲解进行操做会报如下错误：

 

 

按照报错提示，须要在app.config['SQLALCHEMY_COMMIT_ON_TEARDOWN'] = True该行代码下添加以下一行代码：app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

 

 

SQLALCHEMY_TRACK_MODIFICATIONS:若是设置成True(默认状况)，Flask-SQLAlchemy 将会追踪对象的修改而且发送信号。这须要额外的内存， 若是没必要要的能够禁用它。若是你不显示的调用它，在最新版的运行环境下，会显示警告。

 

2.书本50页5.8.1建立表，图中显示的操做符应该是在Mac或者Linux环境下进行的命令操做，若是是在Windows环境下，是达不到效果的，具体以下：

 

 

具体操做方法以下（WIndows版本）：

 

此处如何要按照书本上命令达到效果，能够参照第2章关于Flask-Scrip包的讲解，设置manager变量，而后就能够直接打开shell进行相关操做。

 

3.书本50页5.8节数据库操做部分示例运行结果

 

 

 4.书本55页示例5-5部分关于操做数据库部分代码有问题

 

此处之因此这样修改代码，是由于设计的数据库角色和用户是一对多的关系，用户表中包含一个角色id外键。在对用户表进行插入操做时，必需要确认一个用户角色，不然没法插入。

附运行成功页面截图：

 

 

5.书本57页有关Flask-MIgrate相关配置命令如何正确实现问题

若是纯粹安装书本代码来进行相关命令操做，会发现输入python hello.py db init命令根本没有输出任何提示信息，即不能成功建立迁移仓库。若是从做者GitHub上克隆下来的代码，直接进行此命令操做，也是没有任何信息提示。此处须要在hello.py文件最末端，加上以下两行代码（PS：做者最新修改代码，未定义manager变量，此处须要查看第2章关于Flask-Script包讲解，本身定义好manager变量）：

if __name__ == '__main__':

    manager.run()

 

再去控制台输入相关命令，便可实现相关操做，操做成功结果以下（PS：此处推荐一篇博客文章http://www.javashuo.com/article/p-hjrcysre-t.html）：

 

 

 

6.有关使用MySQL数据库实现相关增删查改操做问题

只要认真看完第5章内容，转用MySQL数据库实现增删查改操做很是简单，仅仅只须要把定义数据库URL地址改一下就能够，其余部分代码均不须要改动。具体修改以下：

app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:root@localhost/test_flask'
#app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///' + os.path.join(basedir,'data.sqlite')

 

上述代码意思，使用用户名和密码均为root的mysql数据库帐号，进入已经建立好的test_flask数据库，进行相关表的建立以及数据的增删查改操做。自处能够仔细看一下书本46页表5-1。

 

注：经过本章的学习，让我基本了解了如何使用Flask-SQLAlchemy相关功能，以及实现对关系型数据库SQLite、MySQL的增删查改操做，最后最重要的就是学会了使用Flask-Migrate实现数据库迁移。为了可以较好的理解和掌握第5章内容，建议初学者认真看一下Flask-SQLAlchemy和Flask-Migrate的官方文档。

 

 

---

第6章 电子邮件

1.书本60页发送邮件示例

因为书本上使用googlemail邮箱，通常国内同窗都不会使用这个邮箱。大部分都会使用QQ邮箱吧。此处只须要把设置写成app.config['MAIL_SERVER'] = 'smtp.qq.com'，即把电子邮件服务器主机名中间的googlemail换成qq就行啦。

完成这些，若是仅仅使用本身的QQ邮箱号和QQ密码登录发送邮件的话，会报如下错误：

smtplib.SMTPSenderRefused: (503, 'Error: need EHLO and AUTH first !', u'****’...)

解决办法（PS：此处关于QQ邮箱和登录密码我是直接写在代码里的，没有用环境变量获取）：
进入本身的QQ邮箱，完成以下设置操做：

 

 

 

发送邮件测试代码（PS：上面获取QQ邮箱测试登录临时密码有点坑的是，发送完短信后，可能30秒后浏览器上开启的QQ邮箱界面直接崩溃，不过这不要紧，崩溃后也依旧能够发送邮件）：

 

 

发送成功后的截图：

 

 

 2.关于61页在程序中集成发送电子邮件功能

注意此处要结合第5章数据库功能，因此前提要肯定在运行成功的页面上可以有效地把数据插入后台数据库。其次，要注意的是在templates文件下要本身动手新建一个mail文件夹，并在这个文件夹里新建new_user.txt和new_user.html两个文本文件，这样才能真正实现邮件发送功能。（PS：new_user.txt、new_user.html文件中内容，请查看从做者GitHub上克隆下来的代码）

运行成功结果页面以下（PS：此处实现功能获取邮箱信息，我都是直接写在代码中的，未使用环境变量获取）：

 

 

注：本章主要讲解了Flask-Mail的应用，功能应用不难，主要是涉及邮箱发送邮件时登录须要相关服务器许可的配置问题有点麻烦。不过，总体来讲，本章的应用，也从另外一方面看到了Python的魅力，简单的几行代码便可实现一些比较复杂的功能。

 

 

---

第7章 大型程序的结构

1.书本66页示例7-2代码有bug

此处若是彻底按照书本上代码，到了后续上机运行时会报如下错误：

E:\WorkPlace\Git_python\liu_demo\venv\lib\site-packages\flask_sqlalchemy\__init__.py:794: FSADeprecationWarning: SQLALCHEMY_TRACK_MODIFICATIONS adds significant overhead and will be disabled by default in the future.  Set it to True or False to suppress this warning.

此处须要添加一行代码，以下图：

 

 

附Flask-SQLAlchemy配置键相关功能定义：

SQLALCHEMY_DATABASE_URI	用于链接数据的数据库。例如： sqlite:////tmp/test.db mysql://username:password@server/db
SQLALCHEMY_BINDS	一个映射绑定 (bind) 键到 SQLAlchemy 链接 URIs 的字典。 更多的信息请参阅 绑定多个数据库。
SQLALCHEMY_ECHO	若是设置成 True，SQLAlchemy 将会记录全部 发到标准输出(stderr)的语句，这对调试颇有帮助。
SQLALCHEMY_RECORD_QUERIES	能够用于显式地禁用或者启用查询记录。查询记录 在调试或者测试模式下自动启用。更多信息请参阅 get_debug_queries()。
SQLALCHEMY_NATIVE_UNICODE	能够用于显式地禁用支持原生的 unicode。这是 某些数据库适配器必须的（像在 Ubuntu 某些版本上的 PostgreSQL），当使用不合适的指定无编码的数据库 默认值时。
SQLALCHEMY_POOL_SIZE	数据库链接池的大小。默认是数据库引擎的默认值 （一般是 5）。
SQLALCHEMY_POOL_TIMEOUT	指定数据库链接池的超时时间。默认是 10。
SQLALCHEMY_POOL_RECYCLE	自动回收链接的秒数。这对 MySQL 是必须的，默认 状况下 MySQL 会自动移除闲置 8 小时或者以上的链接。 须要注意地是若是使用 MySQL 的话， Flask-SQLAlchemy 会自动地设置这个值为 2 小时。
SQLALCHEMY_MAX_OVERFLOW	控制在链接池达到最大值后能够建立的链接数。当这些额外的 链接回收到链接池后将会被断开和抛弃。
SQLALCHEMY_TRACK_MODIFICATIONS	若是设置成 True (默认状况)，Flask-SQLAlchemy 将会追踪对象的修改而且发送信号。这须要额外的内存， 若是没必要要的能够禁用它。

 

添加上面一行代码后，再次去CMD进行相关命令操做，发现运行正常，结果以下：

 

2.书本74页建立数据库示例运行结果

 

 

注：第7章内容初看很简单，不重要，可是若是不仔细看懂每个配置步骤以及相关表明含义，会发现学习后面章节，很难读懂相关代码。本章最重要的部分，得读懂7.2配置选项中config.py实现配置的具体方式，以及程序是如何调用这些设置好的配置。最后，须要注意的就是学会7.4启动脚本中manage.py代码具体内涵，由于写好的程序可否正常开启服务，通常都是经过这段代码来实现，说白了这里原理仍是要回到第2章关于Flask-Script模块的讲解（PS：即有关使用manage.run()间接开启系统服务）。

 

最后，附加一份我本身学习前7章内容上机代码，都是按照书本上一行代码一行手动敲进去的，出现错误再修改，本部分代码和做者GitHub上最新版代码有些许不一样。

具体代码连接