没有合适的资源?快使用搜索试试~ 我知道了~
首页Flask Mega-Tutorial2017新版翻译PDF
本书不仅适合初级Web开发人员学习阅读,更是Python程序员用来学习高级Web开发技术的优秀参考书。 • 学习Flask应用的基本结构,编写示例应用; • 使用必备的组件,包括模板、数据库、Web表单和电子邮件支持; • 使用包和模块构建可伸缩的大型应用; • 实现用户认证、角色和个人资料; • 在博客网站中重用模板、分页显示列表以及使用富文本; • 使用基于Flask的REST式API,在智能手机、平板电脑和其他第三方客户端上实现可用功能; • 学习运行单元测试以及提升性能; • 将Web应用部署到生产服务器。
资源详情
资源评论
资源推荐

第一章:Hello, World!
本文翻译自The Flask Mega-Tutorial Part I: Hello, World!
一趟愉快的学习之旅即将开始,跟随它你将学会用Python和Flask来创建Web应用。上面的视频包含了整个教程的
内容预览(译者注:视频见原文)。通过学习本章内容,你将学会如何创建一个Flask项目,并在自己的电脑上运
行一个简单的Flask Web应用。
教程中所有的代码示例都托管在GitHub上。虽然直接从GitHub下载代码可以节省写代码的步骤,但是我强烈建议
你至少在前几章自己动手书写这些代码。一旦你熟悉了Flask和示例应用,一些繁琐重复的代码就可以直接从
GitHub复制了。
在每章的开头,我都将提供三个GitHub的链接来帮助你顺畅地学习本章的内容。点击Browse链接会打开GitHub上
Microblog项目在本章的对应代码库页面,不会包含之后章节的任何新增代码。而Zip链接则提供了这份代码库的
zip打包文件的下载地址。如果点击Diff链接,打开的将会是本章节的代码变更信息。
本
章的
GitHub
链
接
为
:Browse,Zip,Diff.
安装Python
你说你还没有安装Python?那还等什么!立马安装吧。如果操作系统默认没有提供Python安装包,可以从Python
官方网站下载。如果你使用Microsoft Windows操作系统并且打算使用WSL或者Cygwin,需要注意,不要在上面使
用Windows版本的Python,而要使用类Unix版本,比如从Ubuntu获取(对应WSL)或从Cygwin上获取。
为了验证Python是否正确安装,你可以打开一个终端窗口并输入 python3 (如果不存在这个命令,那就输入
python )。预期的输出如下:
Python解释器中,光标不断闪烁,等待着你输入Python语句。在未来的章节中,你可以充分体会到交互式解释器
的魅力。至少现在它能够帮你确认Python已经成功安装的事实。可以输入 exit() 并回车来退出交互式解释器。
在Linux和Mac OS X操作系统上,按下快捷键Ctrl-D也可以快速退出交互式解释器。在Windows操作系统上,则是
通过按下Ctrl-Z后跟上Enter快捷键来快速退出。
安装Flask
下一步开始安装Flask,在这之前我要告诉你安装Python三方包的最佳实践。
Python将所有三方包托管到一个公共仓库,任何人都能从这个公共仓库下载并安装所有的三方包。Python将三方
包公共仓库命名为PyPI以表示Python Package Index的缩写(被一些人戏称为"cheese shop")。从PyPI上安装三方
包非常简单,Python专门提供了一个名为 pip 的工具来解决这个问题(Python2.7中不含 pip 工具,需要单独安
装)。
安装三方包时,使用 pip 命令如下:
$ python3
Python 3.5.2 (default, Nov 17 2016, 17:05:23)
[GCC 5.4.0 20160609] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> _

有趣的是,这个方法在大多数情况下不适用。假如Python解释器是全局安装的,所有用户都能使用,那么普通用
户则没有权限来修改它,因此只能用管理员账户来执行安装操作。即使忽略操作的复杂性,使用这种全局安装的方
式会发生什么? pip 工具从PyPI上下载三方包并安装到全局Python目录下,即刻起,所有Python脚本都可以访问
到这个三方包。想象这样一个场景,你之前用当时的最新版本Flask——0.11版本的Flask开发了一个Web应用,现
在Flask已经更新到了0.12版本,你想要使用0.12版本的Flask开发第二个Web应用。但是,如果将Flask从0.11版本
升级到0.12版本可能会导致第一个Web应用出现故障。解决这个问题的方法最好不过为旧Web应用安装和使用
Flask0.11版本,为新Web应用安装和使用Flask0.12版本。
为了解决维护不同应用程序对应不同版本的问题,Python使用了
虚
拟
环
境
的概念。 虚拟环境是Python解释器的完
整副本。在虚拟环境中安装三方包时只会作用到虚拟环境,全局Python解释器不受影响。 那么,就为每个应用程
序安装各自的虚拟环境吧。 虚拟环境还有一个好处,即它们由创建它们的用户所拥有,所以不需要管理员帐户。
我们先创建项目目录,我将这个应用命名为microblog:
如果你正在使用Python3,虚拟环境已经成为内置模块,可以直接通过如下命令来创建它:
译者注:这个命令不一定能够执行成功,比如译者在Ubuntu16.04环境下执行,提示需要先安装对应的依
赖。 sudo apt-get install python3-venv
使用这个命令来让Python运行 venv 包,它会创建一个名为 venv 的虚拟环境。 命令中的第一个“venv”是Python
虚拟环境包的名称,第二个是要用于这个特定环境的虚拟环境名称。 如果你觉得这样很混乱,可以用你自定义的虚
拟环境名字替换第二个 venv 。我习惯在项目目录中创建了名为 venv 的虚拟环境,所以无论何时 cd 到一个项目
中,都会找到相应的虚拟环境。
请注意,在一些操作系统中,你可能需要在上面的命令中使用 python 而不是 python3 。 一些安装规范对Python
2.x版本使用 python ,对3.x版本使用 python3 ,而另一些则将 python 映射到3.x版本。
命令执行完成后,当前目录下就会新增一个名为 venv 的目录来存储这个虚拟环境的相关文件。
如果你使用的Python版本低于3.4(包括2.7版本),则不会默认支持虚拟环境。 对于这些版本的Python,在创建
虚拟环境之前,需要下载并安装称为virtualenv的第三方工具。 一旦安装了virtualenv,你可以使用以下命令创建
一个虚拟环境:
不管你用什么方法创建虚拟环境,创建完毕之后还需要激活才能够进入这个虚拟环境。 要激活你的全新虚拟环境,
需使用以下命令:
如果你使用的是Microsoft Windows命令提示符窗口,则激活命令稍有不同:
$ pip install <package-name>
$ mkdir microblog
$ cd microblog
$ python3 -m venv venv
$ virtualenv venv
$ source venv/bin/activate
(venv) $ _

激活一个虚拟环境,终端会话的环境配置就会被修改,之后你键入 python 的时候,实际上是调用的虚拟环境中的
Python解释器。 此外,终端提示符也被修改成包含被激活的虚拟环境的名称的格式。这种激活是临时的和私有
的,因此在关闭终端窗口时它们将不会保留,也不会影响其他的会话。 那么,当你需要同时打开多个终端窗口来调
试不同的应用时,每个终端窗口都可以激活不同的虚拟环境而不会相互影响。
成功创建和激活了虚拟环境之后,你可以安装Flask了,命令如下:
想要验证安装是否成功,可以打开Python解释器,并用import语句来导入它:
如果语句没有报错,那么恭喜你,Flask安装成功了!
"Hello, World" Flask应用
Flask网站展示了一个仅有五行代码的简单示例应用程序。 而我会告诉你一个稍微更复杂的例子,它将为你编写更
大的应用程序提供一个很好的基础结构。
应用程序是存在于
包
中的。 在Python中,包含 __init__.py 文件的子目录被视为一个可导入的包。 当你导入一
个包时, __init__.py 会执行并定义这个包暴露给外界的属性。
那就创建一个名为 app 的包来存放整个应用吧。记得切换到microblog目录下,并执行如下命令:
并在其下创建文件 __init__.py ,输入如下的代码:
上面的脚本仅仅是从flask中导入的类 Flask ,并以此类创建了一个应用程序对象。 传递给 Flask 类的
__name__ 变量是一个Python预定义的变量,它表示当前调用它的模块的名字。当需要加载相关的资源,如我将
在第二章讲到的模板文件,Flask就使用这个位置作为起点来计算绝对路径。 代码的最后,应用程序导入尚未存在
的 routes 模块。
这段代码,乍一看可能会让人迷惑。
其一,这里有两个实体名为 app 。 app 包由app目录和 __init__.py 脚本来定义构成,并在 from app import
routes 语句中被引用。 app 变量被定义为 __init__.py 脚本中的 Flask 类的一个实例,以至于它成为 app 包
的属性。
$ venv\Scripts\activate
(venv) $ _
(venv) $ pip install flask
>>> import flask
>>> _
(venv) $ mkdir app
from flask import Flask
app = Flask(__name__)
from app import routes

其二, routes 模块是在底部导入的,而不是在脚本的顶部。 最下面的导入是解决
循
环
导
入
的问题,这是Flask应
用程序的常见问题。 你将会看到 routes 模块需要导入在这个脚本中定义的 app 变量,因此将 routes 的导入放
在底部可以避免由于这两个文件之间的相互引用而导致的错误。
那么在 routes 模块中有些什么? 路由是应用程序实现的不同URL。 在Flask中,应用程序路由的处理逻辑被编写
为Python函数,称为
视
图
函
数
。 视图函数被映射到一个或多个路由URL,以便Flask知道当客户端请求给定的URL
时执行什么逻辑。
这是需要写入到app/routes.py中的第一个视图函数的代码:
这个视图函数简单到只返回一个字符串作为问候用语。 函数上面的两个奇怪的 @app.route 行是
装
饰
器
,这是
Python语言的一个独特功能。 装饰器会修改跟在其后的函数。 装饰器的常见模式是使用它们将函数注册为某些事
件的回调函数。 在这种情况下, @app.route 修饰器在作为参数给出的URL和函数之间创建一个关联。 在这个例
子中,有两个装饰器,它们将URL / 和 /index 索引关联到这个函数。 这意味着,当Web浏览器请求这两个URL
中的任何一个时,Flask将调用该函数并将其返回值作为响应传递回浏览器。这样做是为了在运行这个应用程序的
时候会稍微有一点点意义。
要完成应用程序,你需要在定义Flask应用程序实例的顶层(译者注:也就是microblog目录下)创建一个命名为
microblog.py的Python脚本。 它仅拥有一个导入应用程序实例的行:
还记得两个 app 实体吗? 在这里,你可以在同一句话中看到两者。 Flask应用程序实例被称为 app ,是 app 包的
成员。 from app import app 语句从 app 包导入其成员 app 变量。 如果你觉得这很混乱,你可以重命名包或者
变量。
只要确保所做的操作完全正确,那么你就可以看到如下面的项目结构图:
不管你信不信,这个应用的第一个版本现在完成了! 但是在运行之前,需要通过设置 FLASK_APP 环境变量告诉
Flask如何导入它:
如果你使用Microsoft Windows操作系统,在上面的命令中使用 set 替换 export 。
万事俱备,只欠东风!运行如下命令来运行你的第一个Web应用吧:
from app import app
@app.route('/')
@app.route('/index')
def index():
return "Hello, World!"
from app import app
microblog/
venv/
app/
__init__.py
routes.py
microblog.py
(venv) $ export FLASK_APP=microblog.py

服务启动后将处于阻塞监听状态,将等待客户端连接。 flask run 的输出表明服务器正在运行在IP地址127.0.0.1
上,这是本机的回环IP地址。 这个地址很常见,并有一个更简单的名字,你可能已经看过:localhost。 网络服务
器监听在指定端口号等待连接。 部署在生产Web服务器上的应用程序通常会在端口443上进行监听,如果不执行加
密,则有时会监听80,但启用这些端口需要root权限。 由于此应用程序在开发环境中运行,因此Flask使用自由端
口5000。 现在打开您的网络浏览器并在地址栏中输入以下URL:
或者,你也可以使用另一个URL:
应用程序路由映射执行了吗? 第一个URL映射到 / ,而第二个映射到 / index 。 这两个路由都与应用程序中唯一
的视图函数相关联,所以它们产生相同的输出,即函数返回的字符串。 如果你输入任何其他网址,则会出现错误,
因为只有这两个URL被应用程序识别。
完成演示之后,你可以按下Ctrl-C来停止Web服务。
真是可喜可贺!你已经成功地向成为一名Web开发者的道路上迈出了重要的第一步!
第二章:模板
(venv) $ flask run
* Serving Flask app "microblog"
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
http://localhost:5000/
http://localhost:5000/index
剩余210页未读,继续阅读


















qq_41041457
- 粉丝: 1
- 资源: 2
上传资源 快速赚钱
我的内容管理 收起
我的资源 快来上传第一个资源
我的收益
登录查看自己的收益我的积分 登录查看自己的积分
我的C币 登录后查看C币余额
我的收藏
我的下载
下载帮助

会员权益专享
安全验证
文档复制为VIP权益,开通VIP直接复制

评论0