Flask入门教程
简介
Flask是由Armin ronacher于2010年用Python语言基于 Werkzeug 工具箱编写的轻量级Web开发框架。
特点
Flask只提供核心功能,其他几乎所有的功能都需要用到拓展,比如可以通过Flask-SQLAlchemy拓展对数据库进行操作等等。
核心
由Werkzeug与Jinja2组成,Werkzeug是一个全面的WSGI Web应用程序库,Jinja是一种现代且设计友好的Python模板语言。
Flask常用扩展
- Flask-SQLalchemy:操作数据库
- Flask-script:插入脚本
- Flask-migrate:管理迁移数据库
- Flask-Session:Session存储方式指定
相关文档
- 中文文档
- 英文文档
Flask初体验
安装并使用虚拟环境
virtualenv 创建和管理虚拟环境
# 安装
pip install virtualenv
# 创建
virtualenv flask_env
# 使用
source flask_env/bin/activate
Pipenv 创建和管理虚拟环境
# 安装
pip install pipenv
# 创建
pipenv install
# 使用
pipenv shell
安装指定版本flask框架
sudo pip install flask==1.0.2
创建一个文件,并带入编写第一个Flask程序
touch helloflask.py
vim helloflask.py
在文件中写入以下代码
# 导入Flask类
from flask import Flask
# 传递__name__参数,创建一个叫app的Flask实例,该实例将会成为我们的 WSGI 应用。
app = Flask(__name__)
# 通过route装饰器来告诉Flask触发函数的URL
@app.route('/')
# index视图函数,在访问根路径时会调用该函数通过其返回值得到结果
def index():
return 'Hello Flask'
if __name__ == '__main__':
# 通过run方法启动web服务器
app.run()
退出编辑模式,运行该程序
python helloflask.py
可以看到以下结果
这样就启动了一个非常简单的内建的服务器。这个服务器用于测试应该是足够了,但是 用于生产可能是不够的。现在在浏览器中打开 http://127.0.0.1:5000/ ,应该可以看到 Hello Flask! 字样。
相关配置参数
初始化参数
创建Flask项目的第一步就是实例化Flask对象,以下是实例化对象需要的参数详解
-
import_name:Flask程序所在的包(模块),传
__name__
就可以, -
static_url_path:静态文件访问路径,可以不传,默认为:
/ + static_folder
-
static_folder:静态文件存储的文件夹,可以不传,默认为
static
-
static_host:使用远程主机存储静态文件的地址,默认为None。当host_matching为True时,可以通过static_folder配置静态文件存储的文件夹
-
host_matching:设置
url_map.host_matching
属性,默认为False -
subdomain_matching:匹配路由时,请考虑与以下项相关的子域:data:`SERVER_NAME’。默认为False。
-
template_folder:模板文件存储的文件夹,可以不传,默认为
templates
-
instance_path:默认情况下,应用程序的备用实例路径假定包或模块旁边的文件夹“instance”为实例路径。
-
instance_relative_config:如果将用于加载配置的相对文件名设置为“True”,则假定该文件名相对于实例路径而不是应用程序根。
-
root_path:默认情况下,Flask将自动计算应用程序根路径。在某些情况下,这无法实现(例如,如果包是Python 3命名空间包),需要手动定义。
程序加载配置
在Flask程序运行前,我们可以给Flask设置相关配置,例如ENV(应用程序在什么环境中运行),DEBUG(是否启用调试模式)TESTING(启用测试模式)等配置,常见的有两种方式来实现.
-
从配置文件中加载:
app.config.from_pyfile()
创建一个配置文件
touch config.ini vim config.ini
写入配置信息
DEBUG = True
选择从配置文件加载
# 创建 Flask 类对象,指向程序所在的包的名称 app = Flask(__name__) # 从配置文件中加载配置 app.config.from_pyfile('config.ini')
-
从配置对象中加载:app.config.from_object()
创建一个配置类,然后将类名传入即可
# 配置类 class ConfigObject(object): DEBUG = True # 创建 Flask 类对象,指向程序所在的包的名称 app = Flask(__name__) # 从配置对象中加载配置 app.config.from_object(Config)
程序运行配置
这个demo中Flask项目程序启动的入口是app.run()。常见的配置选项有host, port,debug,分别是设置运行主机的ip地址,端口号,是否打开调试模式,当配置文件与这里都有debug时,最终会以这里的debug为准。
app.run(host="127.0.0.1", port=8000)
路由
在Web开发中,路由是一种将URL转发到对应视图的程序。