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

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

Django с нуля: первый проект, модели, админка и шаблоны

Django - популярный веб-фреймворк на Python со встроенной ORM, админкой и шаблонами. В статье на примере простого блога разобрано, как установить Django в venv, создать проект и приложение, описать модель, выполнить миграции и вывести данные на страницу.

Django с нуля: первый проект, модели, админка и шаблоны
Содержание
  1. Что такое Django и когда он нужен
  2. Установка Django в виртуальное окружение
  3. Создание проекта и приложения
  4. Модели и миграции
  5. Админ-панель Django
  6. Представления, адреса и шаблоны
  7. Частые ошибки и что изучать дальше
  8. Частые вопросы

Что такое Django и когда он нужен

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

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

В статье пошагово создаётся простой блог: окружение, проект, приложение, модель, миграции, админка, адреса, представление и шаблон. Все команды проверены по официальной документации Django.

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

Django ставят в отдельное виртуальное окружение, чтобы зависимости проекта не смешивались с системным Python. Подробно про окружения написано в статье о venv, а сам интерпретатор ставится по инструкции для Windows. Актуальные выпуски Django 6.x требуют свежий Python (3.12 или новее), точные требования указаны на странице загрузки djangoproject.com.

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

mkdir mysite_project
cd mysite_project
py -m venv .venv
.venv\Scripts\activate
python -m pip install Django
python -m django --version

На Linux и macOS окружение активируется командой source .venv/bin/activate, а вместо py используется python3. Последняя команда выведет версию установленного Django: убедитесь, что она печатается и нет ошибки. Список зависимостей сохраните командой python -m pip freeze > requirements.txt.

Создание проекта и приложения

В Django различают проект и приложение. Проект - это весь сайт с настройками, приложение - отдельный функциональный блок: блог, каталог, личный кабинет. Приложений в проекте может быть много.

Команды создают проект mysite в текущей папке, затем приложение blog и запускают сервер разработки:

django-admin startproject mysite .
python manage.py startapp blog
python manage.py runserver

Точка в конце первой команды важна: она создаёт проект прямо в текущей папке, без лишней вложенности. После запуска откройте в браузере адрес http://127.0.0.1:8000/ и увидите стартовую страницу с ракетой.

Терминал с командами создания проекта Django и запуска сервера
Создание проекта и запуск сервера разработки
ФайлНазначение
manage.pyКомандная утилита проекта: запуск сервера, миграции, создание приложений
mysite/settings.pyНастройки: приложения, база данных, язык, часовой пояс
mysite/urls.pyГлавная таблица адресов сайта
blog/models.pyОписание таблиц базы данных в виде классов
blog/views.pyПредставления: функции, которые отвечают на запросы
blog/admin.pyРегистрация моделей в админ-панели

Чтобы Django узнал о новом приложении, добавьте его в список INSTALLED_APPS в файле settings.py. Заодно можно сменить язык и часовой пояс:

INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    "blog",   # наше приложение
]

LANGUAGE_CODE = "ru"
TIME_ZONE = "Europe/Moscow"

Остальные строки файла остаются без изменений, добавьте только "blog" и поменяйте два параметра внизу. По умолчанию проект использует файловую базу SQLite, ничего ставить дополнительно не нужно. Редактор с подсветкой проще настроить по материалу про VS Code.

Модели и миграции

Модель - это класс Python, который описывает таблицу в базе данных. Поля класса становятся столбцами, а SQL писать не нужно: за это отвечает ORM. Основы запросов можно освежить в статье про SQL, а возможности самой ORM разбираются в отдельном руководстве.

Опишем запись блога в файле blog/models.py:

from django.db import models


class Post(models.Model):
    title = models.CharField("Заголовок", max_length=200)
    text = models.TextField("Текст")
    created = models.DateTimeField("Создано", auto_now_add=True)
    published = models.BooleanField("Опубликовано", default=False)

    def __str__(self):
        return self.title

Метод __str__ задаёт, как запись выглядит в списках и в админке. Теперь Django нужно создать файл миграции с описанием изменений и применить его к базе:

python manage.py makemigrations
python manage.py migrate

Первая команда создаёт файл в папке blog/migrations, вторая выполняет все ещё не выполненные миграции, в том числе встроенные таблицы пользователей и сессий. Каждый раз после изменения моделей эту пару команд нужно повторять. Миграции хранят в системе контроля версий вместе с кодом.

Админ-панель Django

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

python manage.py createsuperuser

Пароль при вводе не отображается, это нормально. Теперь откройте файл blog/admin.py и зарегистрируйте модель с настройкой списка:

from django.contrib import admin
from .models import Post


@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    list_display = ("title", "created", "published")
    list_filter = ("published",)
    search_fields = ("title", "text")

Декоратор регистрирует модель, а атрибуты задают столбцы в списке, фильтр сбоку и поиск. Запустите python manage.py runserver и перейдите по адресу http://127.0.0.1:8000/admin/. После входа появится раздел Posts, где можно добавлять, менять и удалять записи без написания формы.

Страница списка записей в админ-панели Django
Список записей модели Post в админке

Админка предназначена для сотрудников сайта, а не для посетителей. Не используйте для неё простой пароль и не оставляйте режим DEBUG включённым на рабочем сервере.

Представления, адреса и шаблоны

Когда браузер просит страницу, Django ищет подходящий адрес в таблице urls, вызывает связанное представление, а оно готовит данные и отдаёт шаблон. Запрос и ответ описаны на уровне HTTP-методов, которые фреймворк берёт на себя.

Сначала представления в blog/views.py: список опубликованных записей и страница одной записи.

from django.shortcuts import get_object_or_404, render
from .models import Post


def post_list(request):
    posts = Post.objects.filter(published=True).order_by("-created")
    return render(request, "blog/post_list.html", {"posts": posts})


def post_detail(request, pk):
    post = get_object_or_404(Post, pk=pk, published=True)
    return render(request, "blog/post_detail.html", {"post": post})

Функция get_object_or_404 вернёт страницу ошибки 404, если запись не найдена. Теперь адреса: создайте файл blog/urls.py и подключите его в главном mysite/urls.py.

# blog/urls.py
from django.urls import path
from . import views

urlpatterns = [
    path("", views.post_list, name="post_list"),
    path("post/<int:pk>/", views.post_detail, name="post_detail"),
]
# mysite/urls.py
from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path("admin/", admin.site.urls),
    path("", include("blog.urls")),
]

Фрагмент <int:pk> извлекает число из адреса и передаёт его в представление. Теперь шаблоны. Создайте папки blog/templates/blog/ и файл post_list.html внутри:

<!doctype html>
<html lang="ru">
<head><meta charset="utf-8"><title>Блог</title></head>
<body>
  <h1>Записи блога</h1>
  {% for post in posts %}
    <article>
      <h2><a href="{% url 'post_detail' post.pk %}">{{ post.title }}</a></h2>
      <p>{{ post.text|truncatewords:30 }}</p>
    </article>
  {% empty %}
    <p>Пока нет записей.</p>
  {% endfor %}
</body>
</html>

Конструкции в фигурных скобках с процентами - теги шаблона (цикл, ссылки), двойные скобки выводят значение, а после вертикальной черты стоит фильтр. Ветка empty сработает, если список пуст. Шаблон страницы записи post_detail.html делается так же: выведите {{ post.title }} и {{ post.text }}.

Если открыть главную страницу сайта, после публикации записи в админке она появится в списке. Значит все звенья цепочки работают: адрес, представление, модель, шаблон.

Частые ошибки и что изучать дальше

Новички чаще всего спотыкаются на трёх вещах. Первая - ошибка TemplateDoesNotExist: проверьте, что приложение добавлено в INSTALLED_APPS, а шаблон лежит в blog/templates/blog/. Вторая - забытая миграция после правки модели; симптом - сообщение об отсутствующем столбце. Третья - запуск команд вне виртуального окружения и вне папки с manage.py.

Следующий шаг после этого проекта: формы и ModelForm для создания записей с сайта, пользователи и права, статические файлы, пагинация. Для интерфейса с внешними клиентами пригодится Django REST framework, он помогает строить API. Для рабочего сервера замените SQLite на PostgreSQL, отключите DEBUG и настройте ALLOWED_HOSTS по официальному чек-листу развёртывания.

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

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

Создайте виртуальное окружение, активируйте его и выполните python -m pip install Django. Проверить результат можно командой python -m django --version.

Чем проект Django отличается от приложения?

Проект - весь сайт с настройками и главными адресами. Приложение - отдельный блок функций, например блог или каталог; их в проекте может быть несколько.

Зачем нужны миграции в Django?

Миграции переносят изменения моделей в структуру базы данных. После правки модели выполняйте makemigrations и migrate.

Как зайти в админку Django?

Создайте суперпользователя командой createsuperuser, запустите runserver и откройте адрес /admin/ на локальном сервере.

Какая база данных используется в Django по умолчанию?

SQLite: это файл db.sqlite3 в папке проекта. Для рабочего сайта обычно переходят на PostgreSQL.

Что лучше для новичка: Django или Flask?

Django даёт готовую структуру и админку, Flask минимален и гибок. Для сайта с базой данных и пользователями чаще берут Django, для небольшого сервиса - Flask.

Источники

  • Django documentation, Django Software Foundation
  • How to get Django, Django Software Foundation
  • Writing your first Django app, Django Software Foundation

PythonDjango

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

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