flask入门到起飞（一） 基础配置及入门

Flask框架的诞生：

Flask诞生于2010年，是Armin ronacher（人名）用Python语言基于Werkzeug工具箱编写的轻量级Web开发框架。它主要面向需求简单的小应用。

Flask本身相当于一个内核，其他几乎所有的功能都要用到扩展（邮件扩展Flask-Mail，用户认证Flask-Login），都需要用第三方的扩展来实现。比如可以用Flask-extension加入ORM、窗体验证工具，文件上传、身份验证等。Flask没有默认使用的数据库，你可以选择MySQL，也可以用NoSQL。其 WSGI 工具箱采用 Werkzeug（路由模块） ，模板引擎则使用 Jinja2 。

可以说Flask框架的核心就是Werkzeug和Jinja2。

Python最出名的框架要数Django，此外还有Flask、Tornado等框架。虽然Flask不是最出名的框架，但是Flask应该算是最灵活的框架之一，这也是Flask受到广大开发者喜爱的原因。

文档

官方文档: http://flask.pocoo.org/docs/0.12/
中文文档: http://docs.jinkan.org/docs/flask/

Flask扩展包：

Flask-SQLalchemy：操作数据库；
Flask-migrate：管理迁移数据库；
Flask-Mail:邮件；
Flask-WTF：表单；
Flask-script：插入脚本；
Flask-Login：认证用户状态；
Flask-RESTful：开发REST API的工具；
Flask-Bootstrap：集成前端Twitter Bootstrap框架；
Flask-Moment：本地化日期和时间；

相关环境搭建不细讲解，度娘资料更加齐全。虚拟环境搭建推荐anaconda，自带python环境，可以构建多个虚拟环境，包管理非常方便。

安装依赖包的常用指令：

pip install -r requirements.txt

生成依赖包（须在虚拟环境中）：

pip freeze > requirements.txt

在ipython中测试安装是否成功：

from flask import Flask

国际惯例helloword：

#导入Flask类
from flask import Flask

#Flask类接收一个参数__name__
app = Flask(__name__)

# 装饰器的作用是将路由映射到视图函数index
@app.route('/')
def index():
    return 'Hello World'

# Flask应用程序实例的run方法启动WEB服务器
if __name__ == '__main__':
    app.run()

没办法，就是这么强大，也就是这么简单。

项目启动参数配置

- debug是否开启调试模式，开启后修改python代码会自动重启
- threaded是否开启多线程
- port启动指定服务器端口号
- host主机，默认是127.0.0.1，指定为0.0.0.0代表本机IP
如：app.run(debug=True, port=8000, host='0.0.0.0')

flask-script插件介绍

拥有类似django一样的命令来开始构建web程序，个人不是很推荐

- 安装插件
    pip install flask-script

- 调整代码
    app = Flask(__name__)
    manager = Manager(app)

- 修改启动方式
    manager.run()
    
- 命令启动项目(类似Django)
    python app.py runserver -r -d
    
    # 查看帮助文档，有哪些参数
    python app.py runserver --help
    # 端口号
    python app.py runserver -p 9000
    # 调试模式
    python app.py runserver -d 
    # 自动重新加载
    python app.py runserver -r
    # 主机
    python app.py runserver -h '0.0.0.0'

路由及常用配置（important）

from flask import Flask, current_app, redirect, url_for，current_app

# 创建flask的应用对象
# __name__表示当前的模块名字
#  模块名，flask以这个模块所在的目录为总目录，默认这个目录中的static为静态目录，templates为模板目录
app = Flask(__name__,
            static_url_path="/python",  # 访问静态资源的url前缀, 默认值是static
            static_folder="static",  # 静态文件的目录，默认就是static
            template_folder="templates",  # 模板文件的目录，默认是templates
            )

# 配置参数的使用3中方式（一般常用前面两种）
# 1. 使用配置文件，在项目目录下创建config.cfg文件，调用一下方法引用
app.config.from_pyfile("config.cfg")

# 2. 使用对象配置参数
class Config(object):
    DEBUG = True
    LOVE= "python"
app.config.from_object(Config)

# 3. 配置参数直接操作config的字典对象
 app.config["DEBUG"] = True

@app.route("/home")
def index():
    # 读取配置参数
    # 1. 直接从全局对象app的config字典中取值
    # print(app.config.get("cloudwalk"))
    # 2. 通过current_app获取参数，一般在取不到app对象的时候可以用current_app,它是app对象的代理对象。
    print(current_app.config.get("cloudwalk"))
    #可以直接向浏览器返回字符串，后面讲解response的多种方式。
    return "hello cloudwalk"

#1.可以注册多个路由，都能同时访问接口。
#2. 使用url_for的函数，通过视图函数的名字找到视图对应的url路径,下面例子中index是上面的函数名。
#3.redirect可以重定向到一个新的视图下面。
#4.methods可以指定请求的方式
@app.route("/login2")
@app.route("/login", methods=["GET", "POST"])
def login():
    url = url_for("index")
    return redirect(url)

# 路由传递的参数默认当做string处理，这里指定int，尖括号中冒号后面的内容是动态的
#这里指定int类型的转换器，也是比较常用，可以在函数中取到请求路径符合条件的值。
#可以定义一个通用的转换器，两个过程。下面专门标题讲解。
@app.route('/user/')
def hello_cloudwalk(id):
    return 'hello cloudwalk %d' %id

if __name__ == '__main__':
    # 通过url_map可以查看整个flask中的路由信息
    print(app.url_map)
    # 启动flask程序，并开启debug模式，文件修改自动重启自带的微服务。
    app.run(debug=True)
    #app.run(host="0.0.0.0", port=5000, debug=True)

转换器：我的理解就是请求的url中取出想要的值，url中也可以传数据

# coding:utf-8

from flask import Flask, current_app, redirect, url_for
from werkzeug.routing import BaseConverter

app = Flask(__name__)

# 127.0.0.1:5000/goods/110
# @app.route("/goods/")
@app.route("/goods/")  # 不加转换器类型， 默认是普通字符串规则（除了/的字符）
def goods_detail(goods_id):
    """定义的视图函数"""
    return "goods detail page %s" % goods_id


# 1. 定义自己的转换器，第一种是普通的定义方式，regex属性正则规则必要的属性写死内部
class PhoneConverter(BaseConverter):
    def __init__(self, url_map):
        super(MobileConverter, self).__init__(url_map)
        self.regex = r'1[34578]\d{9}'

#通用转换器的定义方式
class RegexConverter(BaseConverter):
    """"""
    def __init__(self, url_map, regex):
        # 调用父类的初始化方法
        super(RegexConverter, self).__init__(url_map)
        # 将正则表达式的参数保存到对象的属性中，flask会去使用这个属性来进行路由的正则匹配
        self.regex = regex

    def to_python(self, value):
        """"""
        print("to_python方法被调用")
        # return "abc"
        # value是在路径进行正则表达式匹配的时候提取的参数
        return value

    def to_url(self, value):
        """使用url_for的方法的时候被调用"""
        print("to_url方法被调用")
        # return "15811111111"
        return value


# 2. 将自定义的转换器添加到flask的应用中
app.url_map.converters["re"] = RegexConverter
app.url_map.converters["mobile"] = PhoneConverter


# 127.0.0.1:5000/send/18612345678
# @app.route("/send/")
@app.route("/send/")
def send_sms(mobile_num):
    return "send sms to %s" % mobile_num


@app.route("/index")
def index():
    url = url_for("send_sms", mobile_num="18922222222")
    # /send/18922222222
    return redirect(url)


@app.route("/call/")
def call_tel(tel):
    pass


if __name__ == '__main__':
    # 通过url_map可以查看整个flask中的路由信息
    print(app.url_map)
    # 启动flask程序
    app.run(debug=True)

转换器进阶的流程讲解

高级转换器讲解.png

好了，第一节就分享这么多。干活满满