本文介绍如何上手 Flask 。 这里假定你已经安装好了 Flask ,否则请先阅读《 安装 》。
如果已安装好Flask,通过以下命令查看
一个简单的例子:
from flask import Flask app = Flask(__name__) @app.route('/') def hello_world(): return 'Hello World!' if __name__ == '__main__': app.run()
把它保存为 hello.py ,然后用 Python 解释器来运行。 不能保存为 flask.py ,因为这与 Flask 本身冲突。
$ python hello.py
* Running on http://127.0.0.1:5000/
现在访问 http://127.0.0.1:5000/ ,你会看见 Hello World 问候。
那么,这段代码是什么意思呢?
- 首先,导入了 Flask 类。这个类的实例将会成为我们的 WSGI 应用程序。
- 接下来,我们创建一个该类的实例,第一个参数是应用模块或者包的名称。 如果使用单一的模块(如本例),应该使用 __name__,因为模块的名称 作为单独应用启动还是作为模块导入是不同的( 也即是 '__main__' 或实际的导入名)。这个参数是必须的,这样 Flask 才知道到哪去找模板、静态文件等等。详情见 Flask 的文档。
- 然后,我们使用 route() 装饰器告诉 Flask 哪些URL能触发我们的函数。
- 这个函数的名字也在生成 URL 时被特定的函数采用,函数返回想在浏览器中显示的信息。
- 最后我们用 run() 函数让应用运行在本地服务器上。 其中 if __name__ == '__main__': 确保服务器只会在该脚本被 Python 解释器直接执行的时候才会运行,而不是作为模块导入的时候。
想要关闭服务器,按 Ctrl+C。
外部可访问的服务器
如果你运行了这个服务器,你会发现它只能从你自己的计算机上访问,网络中其它任何的地方都不能访问。在调试模式下,用户可以在你的计算机上执行任意 Python 代码。因此,这个行为是默认的。
如果你禁用了 debug 或信任你所在网络的用户,你可以简单修改调用 run() 的方法使你的服务器公开可用,如下:
app.run(host='0.0.0.0')
这会让操作系统监听所有公网 IP。
调试模式
run() 方法适用于启动本地的开发服务器,但是每次修改代码后都要手动重启它。这样并不够优雅,如果你启用了调试模式,服务器会在代码修改后自动重新载入,并在发生错误时提供一个相当有用的调试器。
有两种途径来启用调试模式。一种是直接在应用对象上设置:
app.debug = True
app.run()
另一种是作为 run 方法的一个参数传入:
app.run(debug=True)
注意:调试器允许执行任意代码。这是一个巨大的安全隐患,因此调试模式 绝对不能用于生产环境 。
路由
现代 web 应用都使用有意义的 URL ,这样有助于用户记忆,提高回头率。
使用 route() 装饰器来把一个函数绑定到对应的 URL 上。
例如:
@app.route('/')
def index(): return 'Index Page' @app.route('/hello') def hello(): return 'Hello World'
但是能做的不仅仅是这些!你可以动态变化 URL 的某些部分, 还可以为一个函数指定多个规则。
变量规则
要给 URL 添加变量部分,你可以把这些特殊的字段标记为 <variable_name> , 这个部分将会作为命名参数传递到你的函数。规则可以用 <converter:variable_name> 指定一个可选的转换器。这里有一些不错的例子:
参考
1. http://docs.jinkan.org/docs/flask/quickstart.html
2. https://dormousehole.readthedocs.io/en/latest/quickstart.html