Flask 入门教程

Flask 入门教程

一、Flask简单使用

1、准备环境

• 硬件：Windows 7+
• python 3.6+安装
• 软件：pycharm安装（社区版）、python环境安装

2、简单的Flask应用

本地D盘新建一个FlaskDemo的文件夹，使用Pycharm – Open 选择FlaskDemo文件夹打开，在文件夹下右键 new – python File一个文件app.py，文件内容如下：

from flask import Flask

app = Flask(__name__)


@app.route('/')
def hello_world():
    return 'Hello World!'


if __name__ == '__main__':
    app.run()

正常来说代码导入后，如下提示：

打开Pycharm下方的Terminal（默认会在当前的项目路径），并输入以下命令。

pip3 install flask -i https://pypi.tuna.tsinghua.edu.cn/simple

（因为我的已经安装，所以页面不相同，保证对应的包安装成功即可）

在对应的Flask的红色下滑线取消后（代表flask模块已经导入），点击对应的绿色倒三角或者Terminal输入以下命令运行app.py：

python app.py

出现以下提示时，代表flask运行起来了：

也可以直接使用专业版的Pycharm新建项目时选择flask项目，会默认生成以上文件并安装好对应的虚拟环境。

二、Flask基本原理

1、Flask简单介绍

百度百科：Flask是一个使用 Python 编写的轻量级 Web 应用框架¹，也被称为 “微服务框架” ，因为使用简单的核心（ Werkzeug WSGI工具包²、 Jinja2 模板引擎³）且支持插件扩展。

2、Flask简单应用的分析

2.1、导入Flask类

from flask import Flask

Flask类是Flask框架的核心类，它实现了WSGI应用规范。

2.2、创建Flask实例对象

app = Flask(__name__)

创建了一个名为 app 的 Flask 应用程序实例，以当前模块的名称作为应用程序的根目录。后续可以使用这个实例来配置路由、注册插件、定义视图函数等，从而构建一个完整的 Web 应用程序。

__name__的用法:

• 这是一个 Python 内置变量，表示当前模块的名称。在使用 Flask 创建应用程序时，将其作为 Flask 类的一个参数，以便 Flask 可以确定程序的根目录，从而找到静态文件夹和模板文件夹。
• 应用程序顶级目录中名为 test.py 的模块中，name 的值为 test。 如果 test.py 模块位于一个名为my_package 的 Python 包中，那么 __name__的值就是 my_package.test。
• 在应用程序的主模块（运行 Python 解释器的文件）中，name 的值是特殊值__main__

2.3 注册路由

@app.route('/')
def hello_world():
    return 'Hello World!'

route() 装饰器⁴告诉 Flask 什么样的URL 能触发我们的函数。

• 带参数的路由

@app.route('/hello/<name>')
def hello(name):
    return 'Hello %s' % name

• 添加转换器来转换参数类型

@app.route('/user/<int:user_id>')
def get_user(user_id):
    return 'User ID: %d' % user_id

• 多URL的路由

@app.route('/')
@app.route('/hello')
@app.route('/hello/<name>')
def hello(name=None):
    if name is None:
        name = 'World'
    return 'Hello %s' % name

• HTTP请求方法常用的有Get, Post, Put, Delete。
  当你请求地址http://localhost:5000/login，”GET”和”POST”请求会返回不同的内容，其他请求方法则会返回405错误。

from flask import request
@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        return 'This is a POST request'
    else:
        return 'This is a GET request'

2.4、启动Flask创建的web服务

if __name__ == '__main__':
	app.run()

只适用于开发模式，因为它是单线程的，生产环境影响性能，替代方案是可以用uWSGI或者pywsgi（而且flask也不建议生产环境使用这个部署方式）

可以考虑换成：

• pywsgi服务器使用的是gevent的pywsgi模块，性能不错，配置也很简单，它是把单线程改造成了单线程异步方式（兼容各种环境，配合nginx转发，线上应该够用了）
  
• uWSGI性能最好，配置稍微比上面难一点，但是它是支持多进程、多线程、和多协程的方式（Windows的环境不支持，网上的手动安装教程都不大行，我就不演示了）

3、核心概念的简单介绍

①Werkzeug WSGI工具箱

werkzeug是Flask使用的底层WSGI库， 实现路由、调试和Web服务器网关接口。（WSGI，全称 Web Server Gateway interface，是为 Python 语言定义的Web服务器和Web应用程序之间的一种简单而通用的接口）。

WSGI将Web服务分成两个部分：服务器和应用程序。WGSI服务器只负责与网络相关的两件事：接收浏览器的HTTP请求、向浏览器发送HTTP应答；而对HTTP请求的具体处理逻辑，则通过调用WSGI应用程序进行。这意味着我们进行Flask开发时，不需要关注网络方面的操作，Flask应用的入口是封装过的网络请求包，出口是 网络响应，我们仅需要关注这个阶段内的处理逻辑。

②Jinja2模板渲染引擎

Jinja2是基于python的模板引擎。它能完全支持unicode，并具有集成的沙箱执行环境，应用广泛。jinja2使用BSD授权）。Jinja2的工作流程如下图所示：

三、Flask的进阶使用和通用库集成

1、Flask常用扩展包

• flask_sqlalchemy：操作数据库；
• flask_migrate：管理迁移数据库；
• flask_apscheduler：定时器；
• flask_restful：开发REST API的工具；
• flask_cors： 简单解决跨域问题；
• gevent：正式部署使用的服务；

2、简单示例

github: https://github.com/kuang-Wenxiang/FlaskDemo