Flask Web开发新手指南

Flask框架是Python开发的一个基于Werkzeug和Jinja 2的web开发微框架,它的优点就是极其简洁,但又很是灵活,并且容易学习和应用。所以Flask框架是Python新手快速开始web开发最好的选择,此外,使用Flask框架的另外一个好处在于你能够很是轻松地将基于Python的机器学习算法或数据分析算法集成到web应用中。html

若是但愿深刻学习Flask Web开发,推荐这个教程:深刻浅出Flaskpython

一、能够用Flask框架作什么

从博客应用到克隆一个facebook或者twitter,理论上你能够用Flask作任何事情。有不少库 能够直接使用,例如flask-sockets,flask-google-maps等,并且Flask框架支持MySQL、Postgresql、MongoDB等诸多数据库。web

我能想到的一些能够用Flask框架实现的web应用类型:博客应用、聊天应用、仪表盘应用、REST API、管理页面、邮件服务等。算法

一、安装Flask

使用pip安装Flask:sql

$ pip install flask

二、Hello,World

建立一个文件app.py,而后只须要几个简单的步骤,就能够写出Flask版本的Hello World数据库

  1. 引入Flask类
from flask import Flask
  1. 建立Flask对象,咱们将使用该对象进行应用的配置和运行:
app = Flask(__name__)

name 是Python中的特殊变量,若是文件做为主程序执行,那么__name__变量的值就是 __main__,若是是被其余模块引入,那么__name__的值就是模块名称。flask

  1. 编写主程序

在主程序中,执行run()来启动应用:浏览器

if __name__ =="__main__":
    app.run(debug=True, port=8080)

更名启动一个本地服务器,默认状况下其地址是localhost:5000,在上面的代码中,咱们使用关键字 参数port将监听端口修改成8080。服务器

  1. 路由

使用app变量的route()装饰器来告诉Flask框架URL如何触发咱们的视图函数:app

@app.route('/')
def hello_world():
    return 'Hello, World!'

上面的标识,对路径'/'的请求,将转为对hello_world()函数的调用。很直白,对吧?

  1. 运行

如今,让咱们完整地看一下app.py的整个代码:

from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello_world():
    return 'Hello, World!'

if __name__ =="__main__":
    app.run(debug=True,port=8080)

而后运行起来:

$ python app.py

你应该会看到以下输入:

* Serving Flask app "app" (lazy loading)
* Environment: production
* Debug mode: on
* Running on http://127.0.0.1:8080/ (Press CTRL+C to quit)
* Restarting with stat
* Debugger is active!
* Debugger PIN: 770-937-705

如今就能够打开浏览器访问http://127.0.0.1:8080/了:

三、使用HTML模板

首先咱们看看如何原始的HTML代码插入Flask应用:

from flask import Flask
app = Flask(__name__)


@app.route('/greet')
def greet():
    user = {'username': 'John', 'age': "20"}
    return '''
<html>
    <head>
        <title>Templating</title>
    </head>
    <body>
        <h1>Hello, ''' + user['username'] + '''!, you’re ''' + user['age'] + ''' years old.</h1>
    </body>
</html>'''


if __name__ == '__main__':
app.run(debug = True,port=8080)

在上面的代码中,咱们使用拼接的HTML字符串来展现user字典的数据。如今访问http://127.0.0.1:8080/greet

拼接HTML字符串很是容易出错,所以Flask使用Jinja 2模板引擎来分离数据逻辑和展现层。

咱们将模板文件按以下路径放置:

Apps folder
/app.py
templates
   |-/index.html

使用模板时,视图函数应当返回render_template()的调用结果。例以下面的代码片断 渲染模板index.html,并将渲染结果做为视图函数的返回值:

from flask import Flask, render_template
app = Flask(__name__)

@app.route('/hello')
def hello():
    return render_template('index.html', name="Alex")

if __name__ == '__main__':
    app.run(debug = True)

在上面的代码中,模板文件index.html依赖于变量name,其内容以下:

<html>
<body>
  {% if name %}
    <h2>Hello {{ name }}.</h2>
  {% else %}
    <h2>Hello.</h2>
  {% endif %}
 </body>
</html>

模板文件的语法扩充了HTML,所以可使用变量和逻辑。

在浏览器中访问http://127.0.0.1:8080/hello/alex

四、使用表单

每一个web应用都须要使用表单来采集用户数据。如今让咱们使用Flask框架建立一个 简单的表单来收集用户的基本信息,例如名称、年龄、邮件、兴趣爱好等,咱们将 这个模板文件命名为bio_form.html

<!DOCTYPE html>
<html>
<head>
    <title></title>
</head>
<body>
    <h1>Bio Data Form</h1>
    <form action="showbio">
        <label>Username</label>
        <input type="name" name="username"><br>
        <label>Email</label>
        <input type="email" name="email"><br>
        <label>Hobbies</label>
        <input type="name" name="hobbies"><br>
        <input type="submit" name="">
    </form>
</body>
</html>

视图函数bio_data_form同时支持POST和GET请求。GET请求将渲染 bio_form.html模板,而POST请求将重定向到showbio

@app.route('/form', methods=['POST', 'GET'])
def bio_data_form():    
    if request.method == "POST":
        username = request.form['username']        
        age = request.form['age']        
        email = request.form['email']        
        hobbies = request.form['hobbies']        
        return redirect(url_for('showbio',                              
                                username=username,
                                age=age,
                                email=email,   
                                hobbies=hobbies))    
    return render_template("bio_form.html")

下面是showbio的实现:

@app.route('/showbio', methods=['GET'])
def showbio():    
    username = request.args.get('username')    
    age = request.args.get('age')    
    email = request.args.get('email')    
    hobbies = request.args.get('hobbies')    
    return render_template("show_bio.html",
                           username=username,                         
                           age=age,                          
                           email=email,                         
                           hobbies=hobbies)

以及show_bio.html的内容:

<!DOCTYPE html>
<html>
<head>
    <title>Bio-Data Details</title>
</head>
<body>
    <h1>Bio-Data Details</h1>
    <hr>
    <h1>Username: {{ username }}</h1>
    <h1>Email: {{ email }}</h1>
    <h1>Hobbies: {{ hobbies }}</h1>
</body>
</html>

五、数据库集成:使用SQLAlchemy

Flask不能直接链接数据库,须要借助于ORM(Object Relational Mapper)。 在这一部分,咱们将借助于SQLAlchemy使用Postgres数据库。

  1. 安装Flask-SQLAlchemy和Postgres

首先安装flask-sqlalchemy:

$ pip install flask-sqlalchemy

而后从官方下载并安装postgres:https://postgresapp.com/

  1. 建立数据库

在终端中使用下面的命令建立一个appdb数据库:

$ createdb appdb
  1. 更新应用配置

修改app.config,添加数据库相关的配置信息:

app.config['DEBUG'] = True
app.config['SQLALCHEMY_DATABASE_URI']='postgresql://localhost/appdb'
SQLALCHEMY_TRACK_MODIFICATIONS = True
db = SQLAlchemy(app)

而后在代码中就可使用这些配置数据了:

from flask import Flask, request, render_template
from flask_sqlalchemy import SQLAlchemy

# Settings
app = Flask(__name__)
app.config['DEBUG'] = True
app.config['SQLALCHEMY_DATABASE_URI'] = 'postgresql://localhost/appdb'
db = SQLAlchemy(app)

@app.route('/')
def hello_world():
    return 'Hello, World!'

if __name__ == '__main__':
    app.run()

如今,让咱们建立第一个模型(Model)。全部模型的基类是db.Model,使用Column来定义 数据列:

class Post(db.Model):
    id = db.Column(db.Integer(), primary_key=True)
    title = db.Column(db.String(80), unique=True)
    post_text = db.Column(db.String(255))
    
    def __init__(self, title, post_text):
        self.title = title
        self.post_text = post_text

在代码中使用模型:

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'postgresql://localhost/testdb'

db = SQLAlchemy(app)


class Post(db.Model):
    id = db.Column(db.Integer(), primary_key=True)
    title = db.Column(db.String(80), unique=True)
    post_text = db.Column(db.String(255))

    def __init__(self, title, post_text):
        self.title = title
        self.post_text = post_text


@app.route('/')
def index():
    return "Hello World"


app = Flask(__name__)

if __name__ == "__main__":
    app.run()

六、模型-数据同步

使用ORM时,须要执行迁移操做以便在模型和持久化数据之间保持同步。咱们使用 Flask-Migrate这个扩展来完成该任务。

首先安装:

$ pip install flask-migrate
$ pip install flask_script

而后在代码中引入:

from flask_script import Manager
from flask_migrate import Migrate, MigrateCommand

进行必要的配置:

migrate = Migrate(app, db)
manager = Manager(app)
manager.add_command('db', MigrateCommand)

运行管理器:

if __name__ == '__main__':
    manager.run()

完整的代码以下:

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_script import Manager
from flask_migrate import Migrate, MigrateCommand

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'postgresql://localhost/appdb'

db = SQLAlchemy(app)
migrate = Migrate(app, db)
manager = Manager(app)
manager.add_command('db', MigrateCommand)


class Post(db.Model):
    id = db.Column(db.Integer(), primary_key=True)
    title = db.Column(db.String(80), unique=True)
    post_text = db.Column(db.String(255))

    def __init__(self, title, post_text):
        self.title = title
        self.post_text = post_text


@app.route('/')
def index():
    return "Hello World"


if __name__ == "__main__":
    manager.run()

使用以下的命令初始化Alembic:

$ python app.py db init
Creating directory /Users/Vihar/Desktop/flask-databases/migrations ... done
...
...
...
Generating /Users/Vihar/Desktop/flask-databases/migrations/alembic.ini ... done

执行第一个迁移任务:

$ python app.py db migrate
INFO  [alembic.runtime.migration] Context impl PostgresqlImpl.
INFO  [alembic.runtime.migration] Will assume transactional DDL.
INFO  [alembic.autogenerate.compare] Detected added table 'post'

Generating /Users/Vihar/Desktop/flask-databases/migrations/versions/ed3b3a028447_.py ... done

一旦上述命令执行完毕,咱们的数据表就会建立成功。如今更新数据库:

$ python app.py db upgrade

原文连接:Flask框架web开发零基础入门

相关文章
相关标签/搜索