Flak快速上手

本文介绍如何上手 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> 指定一个可选的转换器。这里有一些不错的例子:

参考