Flask入门：从基础到实践

原创

申公豹

发布于 2024-04-20 01:32:58

2760

发布于 2024-04-20 01:32:58

文章被收录于专栏：申公豹的专栏申公豹的专栏

在Web开发领域，选择适合项目需求的框架至关重要。Flask，一个轻量级的Python Web框架，以其简洁、灵活和易扩展的特性而备受开发者青睐。本文将介绍如何使用Flask迅速搭建一个轻量级的Web应用，并通过实例代码详细解析关键步骤。

步骤1：安装Flask

首先，确保你已经安装了Python。然后，通过以下命令安装Flask：

pip install Flask

步骤2：创建Flask应用

创建一个新的Python文件，比如app.py，并添加以下基本的Flask应用结构：

from flask import Flask

app = Flask(__name__)

@app.route('/')
def index():
    return 'Hello, Flask!'

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

上述代码创建了一个简单的Flask应用，当访问根路径'/'时，返回'Hello, Flask!'。

步骤3：运行Flask应用

在命令行中运行以下命令启动Flask应用：

python app.py

访问http://127.0.0.1:5000/，你将看到网页上显示'Hello, Flask!'。

步骤4：添加更多页面

让我们扩展应用，添加更多页面。修改app.py文件：

from flask import Flask, render_template

app = Flask(__name__)

@app.route('/')
def index():
    return 'Hello, Flask!'

@app.route('/about')
def about():
    return 'About page'

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

步骤5：使用模板引擎

Flask支持使用模板引擎来渲染动态页面。我们将使用Jinja2模板引擎来创建更复杂的页面。首先，在项目根目录下创建一个名为templates的文件夹。然后，添加一个模板文件index.html：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Flask App</title>
</head>
<body>
    <h1>{{ title }}</h1>
    <p>Welcome to the Flask app!</p>
</body>
</html>

修改app.py以使用模板引擎：

from flask import Flask, render_template

app = Flask(__name__)

@app.route('/')
def index():
    return render_template('index.html', title='Home')

@app.route('/about')
def about():
    return render_template('index.html', title='About')

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

这样，你的页面就可以动态地显示不同的标题了。

通过以上步骤，你已经成功搭建了一个简单的Flask应用，并学会了如何添加路由和使用模板引擎。Flask的简单性和灵活性使其成为快速开发Web应用的理想选择。继续深入学习Flask，你将能够构建更加复杂和功能丰富的Web应用。

步骤6：处理表单

在许多Web应用中，用户交互离不开表单。让我们扩展我们的应用，添加一个简单的联系表单。首先，修改index.html，在表单中添加一个输入框和提交按钮：

<!-- index.html -->
<!-- ... -->
<body>
    <h1>{{ title }}</h1>
    <p>Welcome to the Flask app!</p>

    <form method="post" action="/contact">
        <label for="name">Name:</label>
        <input type="text" id="name" name="name" required>
        <button type="submit">Submit</button>
    </form>
</body>
<!-- ... -->

步骤7：处理表单提交

在app.py中添加一个新的路由来处理表单提交：

from flask import Flask, render_template, request, redirect, url_for

app = Flask(__name__)

@app.route('/')
def index():
    return render_template('index.html', title='Home')

@app.route('/about')
def about():
    return render_template('index.html', title='About')

@app.route('/contact', methods=['POST'])
def contact():
    if request.method == 'POST':
        name = request.form.get('name')
        return f'Thank you, {name}!'

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

现在，当用户在联系表单中提交信息时，将显示一条感谢消息。

步骤8：添加静态文件

Flask还允许你管理静态文件，如CSS和JavaScript。在项目根目录下创建一个名为static的文件夹，然后在其中添加一个CSS文件，比如style.css：

/* static/style.css */
body {
    font-family: Arial, sans-serif;
    margin: 20px;
}

form {
    margin-top: 20px;
}

在index.html中引入这个样式文件：

<!-- index.html -->
<!-- ... -->
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Flask App</title>
    <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}">
</head>
<!-- ... -->

步骤9：使用数据库

在许多Web应用中，需要持久性存储数据，而不仅仅是处理表单提交。Flask与SQLAlchemy集成得很好，让你能够轻松地与数据库交互。首先，安装SQLAlchemy：

pip install SQLAlchemy

然后，修改app.py以使用数据库。在这里，我们使用SQLite作为简单的演示数据库：

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

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///site.db'  # 使用SQLite数据库
db = SQLAlchemy(app)

class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(50), nullable=False)

@app.route('/')
def index():
    users = User.query.all()
    return render_template('index.html', title='Home', users=users)

@app.route('/about')
def about():
    return render_template('index.html', title='About')

@app.route('/contact', methods=['POST'])
def contact():
    if request.method == 'POST':
        name = request.form.get('name')
        new_user = User(name=name)
        db.session.add(new_user)
        db.session.commit()
        return redirect(url_for('index'))

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

步骤10：模型与数据库迁移

随着应用的发展，你可能需要修改数据库模型。为了保持数据库结构的一致性，可以使用Flask-Migrate进行数据库迁移。首先，安装Flask-Migrate：

pip install Flask-Migrate

然后，修改app.py以添加迁移支持：

from flask import Flask, render_template, request, redirect, url_for
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///site.db'
db = SQLAlchemy(app)
migrate = Migrate(app, db)

class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(50), nullable=False)

@app.route('/')
def index():
    users = User.query.all()
    return render_template('index.html', title='Home', users=users)

# ... (其他路由保持不变)

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

现在，你可以使用以下命令创建和应用数据库迁移：

flask db init
flask db migrate -m "Initial migration"
flask db upgrade

这将在数据库中创建一个名为migrations的文件夹，并应用初始迁移。

通过这些步骤，你已经学会了如何在Flask应用中使用数据库和进行数据库迁移。这使得你能够持久性地存储和管理数据，为应用的扩展提供了更多的可能性。在构建更复杂的应用时，可以考虑使用更强大的数据库，如PostgreSQL或MySQL。

步骤11：添加用户认证

许多Web应用需要用户认证系统，以便用户可以注册、登录和访问个人信息。Flask-Login是一个方便的扩展，可以帮助你实现用户认证功能。首先，安装Flask-Login：

pip install Flask-Login

然后，修改app.py以集成Flask-Login：

from flask import Flask, render_template, request, redirect, url_for
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate
from flask_login import LoginManager, UserMixin, login_user, login_required, logout_user, current_user

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///site.db'
app.config['SECRET_KEY'] = 'your_secret_key'  # 用于加密用户信息
db = SQLAlchemy(app)
migrate = Migrate(app, db)
login_manager = LoginManager(app)
login_manager.login_view = 'login'

class User(db.Model, UserMixin):
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(50), nullable=False)

@login_manager.user_loader
def load_user(user_id):
    return User.query.get(int(user_id))

# ... (其他代码保持不变)

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        user_name = request.form.get('name')
        user = User.query.filter_by(name=user_name).first()
        if user:
            login_user(user)
            return redirect(url_for('index'))
    return render_template('login.html', title='Login')

@app.route('/logout')
@login_required
def logout():
    logout_user()
    return redirect(url_for('index'))

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

步骤12：创建登录模板

创建一个名为login.html的新模板文件，用于用户登录页面：

<!-- login.html -->
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Login</title>
</head>
<body>
    <h1>Login</h1>
    <form method="post" action="/login">
        <label for="name">Name:</label>
        <input type="text" id="name" name="name" required>
        <button type="submit">Login</button>
    </form>
</body>
</html>

步骤11：添加用户认证

pip install Flask-Login

然后，修改app.py以集成Flask-Login：

from flask import Flask, render_template, request, redirect, url_for
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate
from flask_login import LoginManager, UserMixin, login_user, login_required, logout_user, current_user

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///site.db'
app.config['SECRET_KEY'] = 'your_secret_key'  # 用于加密用户信息
db = SQLAlchemy(app)
migrate = Migrate(app, db)
login_manager = LoginManager(app)
login_manager.login_view = 'login'

class User(db.Model, UserMixin):
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(50), nullable=False)

@login_manager.user_loader
def load_user(user_id):
    return User.query.get(int(user_id))

# ... (其他代码保持不变)

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        user_name = request.form.get('name')
        user = User.query.filter_by(name=user_name).first()
        if user:
            login_user(user)
            return redirect(url_for('index'))
    return render_template('login.html', title='Login')

@app.route('/logout')
@login_required
def logout():
    logout_user()
    return redirect(url_for('index'))

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

步骤12：创建登录模板

创建一个名为login.html的新模板文件，用于用户登录页面：

<!-- login.html -->
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Login</title>
</head>
<body>
    <h1>Login</h1>
    <form method="post" action="/login">
        <label for="name">Name:</label>
        <input type="text" id="name" name="name" required>
        <button type="submit">Login</button>
    </form>
</body>
</html>

总结：

在本文中，我们深入探讨了如何使用Flask快速搭建轻量级Web应用。从安装Flask开始，我们逐步演示了如何创建路由、使用模板引擎、处理表单、管理静态文件，以及将数据库集成到应用中。通过添加用户认证，我们使应用更具实用性。

具体步骤包括：

安装Flask：通过简单的命令安装Flask框架，为项目的构建做好准备。
创建Flask应用：建立一个基本的Flask应用结构，并通过一个简单的例子介绍了路由的概念。
使用模板引擎：引入Jinja2模板引擎，创建动态页面，使得应用更灵活和易于维护。
处理表单：演示如何处理表单提交，包括获取用户输入和展示感谢消息。
添加静态文件：管理并引入静态文件，提高应用的可视化效果，如添加CSS样式。
使用数据库：集成SQLite数据库，并创建模型以持久性地存储数据，为应用添加更多功能和扩展性。
模型与数据库迁移：使用Flask-Migrate实现数据库模型的变更和迁移，确保数据库结构的一致性。
添加用户认证：引入Flask-Login扩展，实现用户注册、登录、注销等功能，使应用更安全和可交互。

通过这些步骤，读者可以了解如何构建一个简单而完整的Flask应用，并通过不断深入学习，掌握更多高级功能以满足更复杂的项目需求。Flask的灵活性、简洁性以及丰富的扩展库，使其成为快速搭建Web应用的理想选择。

我正在参与2024腾讯技术创作特训营最新征文，快来和我瓜分大奖！

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

腾讯技术创作特训营S6

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

腾讯技术创作特训营S6

#python

登录后参与评论

0 条评论

热度