Flask安装与基本配置
一、Flask了解
#flask是一个基于python开发并且依赖jinja2和Werkzeug服务的微型框架 对于werkzeug本质是socket服务端，其用于接收http请求并对请求进行预处理，然后触发flask框架，开发人员基于flask框架提供的功能对请求进行相应的处理，并返回给客户，如果返回给用户复杂的内容时，需要借助jinja2模板来实现对模板的处理，即：将模板和数据进行渲染，将渲染后的字符串返回给用户的浏览器 “微（micro）”并不代表你需要把整个web应用塞进单个python文件（虽然确实可以），也不意味着flask在功能上有所欠缺，微框架中的“微"意味着flask旨在保持核心简单而易于扩展，Flask 不会替你做出太多决策——比如使用何种数据库。而那些 Flask 所选择的——比如使用何种模板引擎——则很容易替换。除此之外的一切都由可由你掌握。如此，Flask 可以与您珠联璧合。 默认情况下，Flask 不包含数据库抽象层、表单验证，或是其它任何已有多种库可以胜任的功能。然而，Flask 支持用扩展来给应用添加这些功能，如同是 Flask 本身实现的一样。众多的扩展提供了数据库集成、表单验证、上传处理、各种各样的开放认证技术等功能。Flask 也许是“微小”的，但它已准备好在需求繁杂的生产环境中投入使用
1、安装
pip3 install flask
2、werkzeug简介
安装flask后自动就有werkzeug
Werkzeug是一个WSGI工具包，他可以作为一个Web框架的底层库。这里稍微说一下， werkzeug 不是一个web服务器，也不是一个web框架，而是一个工具包，官方的介绍说是一个 WSGI 工具包，它可以作为一个 Web 框架的底层库，因为它封装好了很多 Web 框架的东西，例如 Request，Response 等等
from werkzeug.wrappers import Response,Request @Request.application def hello(request): #wsgi协议需要两个参数，env和response，这里只有一个参数，不符合该协议, #werkzeug是个工具包，在wsgi基础上又做了封装，所以传一个参数就行 def hello(request): return Response('Hello World!') if __name__ == '__main__': from werkzeug.serving import run_simple run_simple('localhost', 4000, hello) #三个参数分别是跑的地址，跑的端口，最后一个是可调用对象
3、对比django
#对应django中的三件套 Httprespose '' render render_template redirect redirect JsonResponse jsonify
二、flask的使用
1、flask最简单的模板
from flask import Flask # 实例化产生一个Flask对象 app = Flask(__name__) #flask的路由是基于装饰器的 @app.route('/') def hello_world(): return 'Hello World!' if __name__ == '__main__': app.run() # 看源码发现，最终调用了werkzeug的run_simple()
2、flask登陆
from flask import Flask, request, render_template, redirect app = Flask(__name__) USERS = { 1: {'name': '张三', 'age': 18, 'gender': '男', 'text': "道路千万条"}, 2: {'name': '李四', 'age': 28, 'gender': '男', 'text': "安全第一条"}, 3: {'name': '王五', 'age': 18, 'gender': '女', 'text': "行车不规范"}, } #methods=['GET','POST'] 该路由运行get请求和post请求，没写默认只允许get请求 @app.route('/login', methods=['GET', 'POST']) def login(): if request.method == 'GET': # HTML文件放在templates(自己创建的）中，实例化的过程中app=Flask(__name__)，点Flask进去，看到template_folder="templates", return render_template('login.html') else: # request.form相当于django中的POST,注意不是from.是form name = request.form.get('name') pwd = request.form.get('pwd') if name == 'pdun' and pwd == '123': return redirect('/') else: # django中传字典，这里传字典打散，**字典 return render_template('login.html', error="用户名或密码错误") @app.route('/') def index(): return render_template('index.html', user=USERS) @app.route('/detail/<int:id>') def detail(id): user = USERS[id] return render_template('detail.html', user=user) if __name__ == '__main__': app.run()
需要的HTML
#detail.HTML <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <h1>详细信息 {{user.name}}</h1> <div> {{user.text}} </div> </body> </html> #index.HTML <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <table> {% for k,v in user.items() %} <tr> <td>{{k}}</td> #三种取值方式 <td>{{v.name}}</td> <td>{{v['name']}}</td> <td>{{v.get('name')}}</td> <td><a href="/detail/{{k}}">查看详细</a></td> </tr> {% endfor %} </table> </body> </html> #login.HTML <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <h1>用户登录</h1> <form method="post"> <input type="text" name="name"> <input type="text" name="pwd"> <input type="submit" value="登录">{{error}} </form> </body> </html>
3、配置文件
3.1、修改配置的两种方式
#1.直接对app.config进行修改 app.config["DEBUG"] = True #2.使用类/模块的方式导入 #首先要有一个settings.py的文件 #在启动文件中导入 app.config.from_object("settings.FlaskSetting")
#settings.py class Config(object): DEBUG = False TESTING = False DATABASE_URI = 'sqlite://:memory:' class ProductionConfig(Config): #创建类继承Config，重写属性， DATABASE_URI = 'mysql://user@localhost/foo' class DevelopmentConfig(Config): #外界使用哪个，导入哪个 DEBUG = True class TestingConfig(Config): TESTING = True #settings.py文件默认路径要放在程序根目录，如果想更改 需要修改源码实例化过程中的最后两个参数， instance_relative_config=True, root_path=#setting文件的位置 ---------------------------------------------- #然后在启动文件中就可以这么写 from flask import Flask app = Flask(__name__) # type:Flask #app.config.from_object("settings.FlaskSetting")
#不常用的几种方法 #1、通过py文件配置 app.config.from_pyfile("python文件名称") 如： settings.py DEBUG = True 2、app.config.from_pyfile("settings.py") #通过环境变量配置 app.config.from_envvar("环境变量名称") #app.config.from_pyfile(os.environ['YOURAPPLICATION_SETTINGS']) 环境变量的值为python文件名称名称，内部调用from_pyfile方法 3、app.config.from_json("json文件名称") JSON文件名称，必须是json格式，因为内部会执行json.loads 4、app.config.from_mapping({'DEBUG': True}) 字典格式
3.2、Flask的配置是在app.config中添加的键值对，但是存进去的键必须是config中存在的，否则它会默认无用，就那么干撩着，下面看看config中有多少key
{ 'DEBUG': False, # 是否开启Debug模式 'TESTING': False, # 是否开启测试模式 'PROPAGATE_EXCEPTIONS': None, # 异常传播(是否在控制台打印LOG) 当Debug或者testing开启后,自动为True 'PRESERVE_CONTEXT_ON_EXCEPTION': None, # 一两句话说不清楚,一般不用它 'SECRET_KEY': None, # 之前遇到过,在启用Session的时候,一定要有它 'PERMANENT_SESSION_LIFETIME': 31, # days , Session的生命周期(天)默认31天 'USE_X_SENDFILE': False, # 是否弃用 x_sendfile 'LOGGER_NAME': None, # 日志记录器的名称 'LOGGER_HANDLER_POLICY': 'always', 'SERVER_NAME': None, # 服务访问域名 'APPLICATION_ROOT': None, # 项目的完整路径 'SESSION_COOKIE_NAME': 'session', # 在cookies中存放session加密字符串的名字 'SESSION_COOKIE_DOMAIN': None, # 在哪个域名下会产生session记录在cookies中 'SESSION_COOKIE_PATH': None, # cookies的路径 'SESSION_COOKIE_HTTPONLY': True, # 控制 cookie 是否应被设置 httponly 的标志， 'SESSION_COOKIE_SECURE': False, # 控制 cookie 是否应被设置安全标志 'SESSION_REFRESH_EACH_REQUEST': True, # 这个标志控制永久会话如何刷新 'MAX_CONTENT_LENGTH': None, # 如果设置为字节数， Flask 会拒绝内容长度大于此值的请求进入，并返回一个 413 状态码 'SEND_FILE_MAX_AGE_DEFAULT': 12, # hours 默认缓存控制的最大期限 'TRAP_BAD_REQUEST_ERRORS': False, # 如果这个值被设置为 True ，Flask不会执行 HTTP 异常的错误处理，而是像对待其它异常一样， # 通过异常栈让它冒泡地抛出。这对于需要找出 HTTP 异常源头的可怕调试情形是有用的。 'TRAP_HTTP_EXCEPTIONS': False, # Werkzeug 处理请求中的特定数据的内部数据结构会抛出同样也是“错误的请求”异常的特殊的 key errors 。 # 同样地，为了保持一致，许多操作可以显式地抛出 BadRequest 异常。 # 因为在调试中，你希望准确地找出异常的原因，这个设置用于在这些情形下调试。 # 如果这个值被设置为 True ，你只会得到常规的回溯。 'EXPLAIN_TEMPLATE_LOADING': False, 'PREFERRED_URL_SCHEME': 'http', # 生成URL的时候如果没有可用的 URL 模式话将使用这个值 'JSON_AS_ASCII': True, # 默认情况下 Flask 使用 ascii 编码来序列化对象。如果这个值被设置为 False ， # Flask不会将其编码为 ASCII，并且按原样输出，返回它的 unicode 字符串。 # 比如 jsonfiy 会自动地采用 utf-8 来编码它然后才进行传输。 'JSON_SORT_KEYS': True, #默认情况下 Flask 按照 JSON 对象的键的顺序来序来序列化它。 # 这样做是为了确保键的顺序不会受到字典的哈希种子的影响，从而返回的值每次都是一致的，不会造成无用的额外 HTTP 缓存。 # 你可以通过修改这个配置的值来覆盖默认的操作。但这是不被推荐的做法因为这个默认的行为可能会给你在性能的代价上带来改善。 'JSONIFY_PRETTYPRINT_REGULAR': True, 'JSONIFY_MIMETYPE': 'application/json', 'TEMPLATES_AUTO_RELOAD': None, }
3.3、实例化的过程中传参
#上面的类导入法是对已经实例化的app进行的配置， #那么在Flask实例化的时候,传递的参数是什么鬼呢? 其实可以理解为对Flask实例进行的初始配置,这里面的参数是非常好理解,注意关键字是非常非常非常好理解
static_folder = 'static', # 静态文件目录的路径 默认当前项目中的static目录 static_host = None, # 远程静态文件所用的Host地址,默认为空 static_url_path = None, # 静态文件目录的url路径 默认不写是与static_folder同名,远程静态文件时复用 # host_matching是否开启host主机位匹配,是要与static_host一起使用,如果配置了static_host, 则必须赋值为True # 这里要说明一下,@app.route("/",host="localhost:5000") 就必须要这样写 # host="localhost:5000" 如果主机头不是 localhost:5000 则无法通过当前的路由 host_matching = False, # 如果不是特别需要的话,慎用,否则所有的route 都需要host=""的参数 subdomain_matching = False, # 理论上来说是用来限制SERVER_NAME子域名的,但是目前还没有感觉出来区别在哪里 template_folder = 'templates' # template模板目录, 默认当前项目中的 templates 目录 instance_path = None, # 指向另一个Flask实例的路径 instance_relative_config = False # 是否加载另一个实例的配置 root_path = None # 主模块所在的目录的绝对路径,默认项目目录
常用的参数有（一般情况下，只修改这些就足够使用了）
static_folder = 'static', # 静态文件目录的路径 默认当前项目中的static目录 static_url_path = None, # 静态文件目录的url路径 默认不写是与static_folder同名,远程静态文件时复用 template_folder = 'templates' # template模板目录, 默认当前项目中的 templates 目录
