Bezdepbonusu7Программирование: статьи и ответы

Python-фреймворки

Flask с нуля: веб-приложение на Python, маршруты, шаблоны и формы

Flask - лёгкий фреймворк для веб-приложений на Python: достаточно одного файла, чтобы получить работающий сайт. В статье установка в виртуальное окружение, маршруты с параметрами, шаблоны Jinja2, обработка форм и запуск командой flask run в режиме debug.

Flask с нуля: веб-приложение на Python, маршруты, шаблоны и формы
Содержание
  1. Что такое Flask и для чего он подходит
  2. Установка Flask в виртуальное окружение
  3. Минимальное приложение и запуск
  4. Маршруты и параметры в адресе
  5. Шаблоны Jinja2
  6. Формы и объект request
  7. Структура проекта и что изучать дальше
  8. Частые вопросы

Что такое Flask и для чего он подходит

Flask - микрофреймворк для веб-приложений на Python. Он даёт только основу: приём запросов, маршрутизацию, шаблоны Jinja2 и работу с формами. Базу данных, авторизацию и админку подключают отдельными расширениями, поэтому структуру проекта вы выбираете сами.

Такой подход удобен для небольших сайтов, прототипов, внутренних сервисов и API. Если нужен готовый набор с ORM и админ-панелью, посмотрите Django. Перед началом полезно знать основы Python: функции, словари, импорты.

Ниже по шагам собирается небольшое приложение: установка, первый маршрут, параметры в адресе, шаблон, форма и запуск в режиме отладки. Команды соответствуют актуальной ветке Flask 3.x.

Установка Flask в виртуальное окружение

Flask, как и другие библиотеки, ставят в отдельное виртуальное окружение: так версии пакетов проекта не конфликтуют с остальными. Подробности смотрите в статье про venv, а если Python ещё не установлен, начните с инструкции для Windows.

Команды для Windows создают папку, окружение, активируют его и ставят Flask через pip:

mkdir flask-demo
cd flask-demo
py -m venv .venv
.venv\Scripts\activate
python -m pip install Flask

На Linux и macOS активация выглядит как source .venv/bin/activate. В начале строки терминала появится пометка (.venv): значит, окружение включено. Назвать свой файл flask.py нельзя, он перекроет сам пакет, используйте app.py.

Минимальное приложение и запуск

Создайте файл app.py. Три строки достаточно для работающего сайта:

from flask import Flask

app = Flask(__name__)


@app.route("/")
def index():
    return "Привет, Flask!"

Объект Flask(__name__) - само приложение, а декоратор @app.route связывает адрес с функцией. То, что функция вернёт, браузер получит в ответ. Запустите сервер разработки командой:

flask --app app run --debug

Параметр --app app указывает модуль с приложением, а --debug включает режим отладки. В терминале появится адрес http://127.0.0.1:5000, откройте его в браузере и увидите приветствие.

Терминал с запуском сервера Flask в режиме debug
Запуск сервера разработки Flask

Режим отладки включает автоперезагрузку при изменении кода и интерактивный отладчик с трассировкой ошибки прямо на странице. Именно поэтому его нельзя включать на публичном сервере: отладчик позволяет выполнять код. Для рабочей среды используют сервер вроде gunicorn или waitress, а не встроенный.

Маршруты и параметры в адресе

Адрес можно сделать динамическим: часть пути в угловых скобках передаётся в функцию как аргумент. Можно указать тип: int, float, path, uuid.

@app.route("/hello/<name>")
def hello(name):
    return f"Привет, {name}!"


@app.route("/post/<int:post_id>")
def post(post_id):
    return f"Запись номер {post_id}"

Запрос на /hello/Аня вернёт приветствие с именем, а на /post/7 - строку с числом 7. Если вместо числа в адресе окажется текст, Flask сам ответит ошибкой 404. По умолчанию маршрут принимает только GET; другие методы указываются явно, о том, чем они различаются, написано в статье про HTTP-методы.

ЗадачаКак записать
Адрес со строкой@app.route("/user/<name>")
Адрес с числом@app.route("/post/<int:post_id>")
Несколько методов@app.route("/form", methods=["GET", "POST"])
Ответ в формате JSONreturn jsonify({"ok": True})
Ошибка 404abort(404)
Построить адрес по имени функцииurl_for("index")

Для ответа в виде данных вызывайте jsonify: он сам задаст заголовок Content-Type и сериализует словарь. Подробнее о формате смотрите в статье про JSON.

Шаблоны Jinja2

Собирать HTML строками неудобно, для этого есть шаблоны. Flask ищет их в папке templates рядом с app.py. Сначала общий каркас base.html, от которого будут наследоваться остальные страницы:

<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>{% block title %}Мой сайт{% endblock %}</title>
</head>
<body>
  <nav><a href="{{ url_for('index') }}">Главная</a></nav>
  {% block content %}{% endblock %}
</body>
</html>

Блоки block - места, которые дочерние шаблоны заполняют своим содержимым. Страница index.html расширяет каркас и выводит список из переданных данных:

{% extends "base.html" %}
{% block title %}Главная{% endblock %}
{% block content %}
  <h1>Привет, {{ user }}!</h1>
  <ul>
    {% for item in items %}
      <li>{{ item }}</li>
    {% else %}
      <li>Список пуст</li>
    {% endfor %}
  </ul>
{% endblock %}

Двойные фигурные скобки выводят значение (Jinja2 автоматически экранирует HTML), а конструкции с процентами задают логику. Осталось передать данные из функции через render_template:

from flask import render_template


@app.route("/")
def index():
    return render_template("index.html", user="Аня", items=["Python", "Flask", "Jinja2"])

Теперь главная страница показывает заголовок и маркированный список из трёх пунктов. Функцию url_for используют вместо жёстко записанных адресов: при смене маршрута ссылки не сломаются.

Формы и объект request

Данные формы и параметры запроса доступны через объект request. Для формы обратной связи маршрут должен принимать GET (показать форму) и POST (получить данные):

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

app = Flask(__name__)
messages = []


@app.route("/feedback", methods=["GET", "POST"])
def feedback():
    if request.method == "POST":
        name = request.form.get("name", "").strip()
        text = request.form.get("text", "").strip()
        if name and text:
            messages.append({"name": name, "text": text})
            return redirect(url_for("feedback"))
    return render_template("feedback.html", messages=messages)

Метод request.form.get безопаснее обращения по ключу: если поля нет, вернётся значение по умолчанию вместо ошибки 400. После успешной отправки делается перенаправление на тот же адрес, чтобы повторное обновление страницы не отправляло форму заново. Сообщения хранятся в списке в памяти, после перезапуска сервера они пропадут; для постоянного хранения подключают базу данных, например через Flask-SQLAlchemy.

Шаблон feedback.html с формой и выводом сообщений:

{% extends "base.html" %}
{% block content %}
  <h1>Обратная связь</h1>
  <form method="post">
    <input name="name" placeholder="Имя" required>
    <textarea name="text" placeholder="Сообщение" required></textarea>
    <button type="submit">Отправить</button>
  </form>
  {% for m in messages %}
    <p><strong>{{ m.name }}:</strong> {{ m.text }}</p>
  {% endfor %}
{% endblock %}

Параметры из адреса вида ?q=python читаются через request.args.get("q"), а JSON из тела запроса - через request.get_json(). Приложение с готовым примером можно сравнить с другим разбором веб-приложения на Flask.

Браузер со страницей формы обратной связи на Flask
Форма и список сообщений в браузере

Для форм, которые меняют данные, добавьте защиту от CSRF, например через расширение Flask-WTF. А секретные значения, вроде SECRET_KEY, держите в переменных окружения, а не в коде репозитория.

Структура проекта и что изучать дальше

Когда приложение вырастет, один файл перестанет быть удобным. Типичная структура: папка templates для шаблонов, папка static для CSS, картинок и скриптов, файл requirements.txt со списком зависимостей. Крупные приложения делят на части через blueprints и создают приложение функцией-фабрикой.

Ошибки, на которые часто жалуются новички: ModuleNotFoundError, если Flask установлен не в то окружение; TemplateNotFound, если папка называется не templates или лежит не рядом с app.py; повторный запуск сервера на занятом порту 5000. В последнем случае запустите сервер с другим портом: flask --app app run --debug --port 5001.

Дальше изучайте расширения Flask-SQLAlchemy для базы данных, Flask-Login для входа пользователей и Flask-Migrate для миграций. Для разработки в редакторе пригодится материал про настройку VS Code.

Частые вопросы

Как установить Flask?

Активируйте виртуальное окружение и выполните python -m pip install Flask. После этого модуль flask можно импортировать, а команда flask станет доступной в терминале.

Как запустить приложение Flask?

Командой flask --app app run, где app - имя файла без расширения. Для режима отладки добавьте --debug, сервер запустится на порту 5000.

Что значит Flask(__name__)?

Это создание приложения. Аргумент __name__ помогает Flask определить, где искать шаблоны и статические файлы относительно вашего модуля.

Где Flask ищет шаблоны?

В папке templates рядом с файлом приложения. Для статики используется папка static.

Можно ли использовать режим debug на сервере?

Нет. Отладчик позволяет выполнять код, поэтому для публичного сайта используют рабочий сервер, например gunicorn или waitress, и отключённый debug.

Чем Flask отличается от Django?

Flask минималистичен и оставляет выбор библиотек вам, Django включает ORM, админку и авторизацию. Flask проще для небольших сервисов и API.

Источники

  • Flask documentation: Quickstart, Pallets
  • Flask documentation: Command Line Interface, Pallets
  • Jinja documentation: Template Designer, Pallets

PythonFlask

Похожие материалы

Версии программ и команды проверены на дату публикации. Если что-то изменилось, сверяйтесь с официальной документацией. Нашли неточность? Напишите на admin@bezdepbonusu7.win.