Django

Djangoとは何か

DjangoはPythonで書かれたフルスタックWebフレームワーク。2005年にKansas州Lawrence市の新聞社「Lawrence Journal-World」のWeb開発チームが開発・公開した。「バッテリー同梱（Batteries Included）」の哲学を掲げ、Webアプリケーション開発に必要な機能を一通り標準で備えている。

たとえるなら、Djangoは「システムキッチン」。シンク、コンロ、冷蔵庫、食洗機が最初から一体化しており、すぐに料理（開発）を始められる。Express.jsが「好きな調理器具を自分で揃える」スタイルなら、Djangoは「全部揃った状態で始める」スタイル。

Djangoの核心的な特徴

なぜDjangoが生まれたのか

新聞社の開発ニーズ

2003年頃、Lawrence Journal-WorldのWebチーム（Adrian Holovaty、Simon Willison等）は、新聞社の記事管理システムやWebアプリを非常に短い締め切りで開発する必要があった。新聞社では「明日までにこの機能を作って」という要求が日常的だった。

当時のPython Web開発環境は断片的で、プロジェクトごとに同じような基盤コードを書き直していた。彼らは共通のフレームワークを内部で構築し、それが2005年にオープンソースとして公開された。

名前の由来

DjangoはジャズギタリストのDjango Reinhardtに由来する。開発者のAdrian Holovatyがジャズ音楽のファンだったことから名付けられた。

Djangoの進化の歴史

MTV（Model-Template-View）アーキテクチャ

DjangoはMTVパターンを採用している。一般的なMVC（Model-View-Controller）とは用語が異なるが、概念は似ている。

コアコンポーネント

Model（モデル）

DjangoのモデルはPythonのクラスとして定義する。各クラスがデータベースのテーブルに対応する。

from django.db import models

class Author(models.Model):
    name = models.CharField(max_length=100)
    email = models.EmailField(unique=True)
    bio = models.TextField(blank=True)
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.name

    class Meta:
        ordering = ['name']


class Article(models.Model):
    STATUS_CHOICES = [
        ('draft', '下書き'),
        ('published', '公開'),
    ]

    title = models.CharField(max_length=200)
    slug = models.SlugField(unique=True)
    content = models.TextField()
    author = models.ForeignKey(Author, on_delete=models.CASCADE, related_name='articles')
    status = models.CharField(max_length=10, choices=STATUS_CHOICES, default='draft')
    published_at = models.DateTimeField(null=True, blank=True)
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

    def __str__(self):
        return self.title

    class Meta:
        ordering = ['-published_at']

ORM（Object-Relational Mapping）

DjangoのORMを使えば、SQLを直接書かずにPythonコードでデータベースを操作できる。

# 作成
author = Author.objects.create(name='太郎', email='taro@example.com')

# 取得
article = Article.objects.get(slug='my-first-post')

# フィルタリング
published = Article.objects.filter(status='published')
recent = Article.objects.filter(published_at__gte='2025-01-01')
by_author = Article.objects.filter(author__name='太郎')

# 集約
from django.db.models import Count, Avg
stats = Author.objects.annotate(article_count=Count('articles'))

# チェーン
results = (
    Article.objects
    .filter(status='published')
    .select_related('author')
    .order_by('-published_at')[:10]
)

# 更新
Article.objects.filter(status='draft').update(status='published')

# 削除
Article.objects.filter(published_at__lt='2020-01-01').delete()

マイグレーション

モデルの変更をデータベースに反映するための仕組み。

# モデルの変更からマイグレーションファイルを生成
python manage.py makemigrations

# マイグレーションを実行（DBに反映）
python manage.py migrate

# マイグレーションの状態確認
python manage.py showmigrations

View（ビュー）

# 関数ベースビュー
from django.http import JsonResponse
from django.shortcuts import render, get_object_or_404

def article_list(request):
    articles = Article.objects.filter(status='published')
    return render(request, 'articles/list.html', {'articles': articles})

def article_detail(request, slug):
    article = get_object_or_404(Article, slug=slug, status='published')
    return render(request, 'articles/detail.html', {'article': article})

# クラスベースビュー
from django.views.generic import ListView, DetailView

class ArticleListView(ListView):
    model = Article
    template_name = 'articles/list.html'
    context_object_name = 'articles'
    queryset = Article.objects.filter(status='published')
    paginate_by = 10

class ArticleDetailView(DetailView):
    model = Article
    template_name = 'articles/detail.html'
    slug_field = 'slug'

Template（テンプレート）

<!-- templates/articles/list.html -->
{% extends "base.html" %}

{% block title %}記事一覧{% endblock %}

{% block content %}
<h1>記事一覧</h1>

{% for article in articles %}
<article>
    <h2><a href="{% url 'article_detail' article.slug %}">{{ article.title }}</a></h2>
    <p>著者: {{ article.author.name }}</p>
    <p>公開日: {{ article.published_at|date:"Y年m月d日" }}</p>
    <p>{{ article.content|truncatewords:30 }}</p>
</article>
{% empty %}
<p>記事がありません。</p>
{% endfor %}

{% if is_paginated %}
<nav>
    {% if page_obj.has_previous %}
    <a href="?page={{ page_obj.previous_page_number }}">前のページ</a>
    {% endif %}
    <span>{{ page_obj.number }} / {{ paginator.num_pages }}</span>
    {% if page_obj.has_next %}
    <a href="?page={{ page_obj.next_page_number }}">次のページ</a>
    {% endif %}
</nav>
{% endif %}
{% endblock %}

URLconf

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

urlpatterns = [
    path('articles/', views.ArticleListView.as_view(), name='article_list'),
    path('articles/<slug:slug>/', views.ArticleDetailView.as_view(), name='article_detail'),
]

管理画面

Djangoの最も特徴的な機能の一つが、自動生成される管理画面。

# admin.py
from django.contrib import admin
from .models import Author, Article

@admin.register(Author)
class AuthorAdmin(admin.ModelAdmin):
    list_display = ['name', 'email', 'created_at']
    search_fields = ['name', 'email']

@admin.register(Article)
class ArticleAdmin(admin.ModelAdmin):
    list_display = ['title', 'author', 'status', 'published_at']
    list_filter = ['status', 'author']
    search_fields = ['title', 'content']
    prepopulated_fields = {'slug': ('title',)}
    date_hierarchy = 'published_at'

これだけの定義で、記事の一覧表示、検索、フィルタリング、作成、編集、削除が可能な管理画面が自動生成される。

プロジェクトの始め方

# Djangoのインストール
pip install django

# プロジェクトの作成
django-admin startproject myproject
cd myproject

# アプリケーションの作成
python manage.py startapp articles

# 開発サーバーの起動
python manage.py runserver

プロジェクト構成

myproject/
├── manage.py              # 管理コマンド
├── myproject/
│   ├── __init__.py
│   ├── settings.py        # プロジェクト設定
│   ├── urls.py            # ルートURLconf
│   ├── asgi.py            # ASGI設定
│   └── wsgi.py            # WSGI設定
├── articles/
│   ├── __init__.py
│   ├── admin.py           # 管理画面の設定
│   ├── apps.py            # アプリ設定
│   ├── models.py          # データモデル
│   ├── views.py           # ビュー
│   ├── urls.py            # URL定義
│   ├── templates/         # テンプレート
│   ├── tests.py           # テスト
│   └── migrations/        # マイグレーション
└── requirements.txt

メリットとデメリット

メリット

デメリット

代替フレームワークとの比較

Django REST Framework（DRF）

現代のDjango開発では、フロントエンドをReactやVue.jsで構築し、バックエンドAPIをDjangoで提供するケースが多い。その際に使われるのがDjango REST Framework（DRF）。

# serializers.py
from rest_framework import serializers
from .models import Article

class ArticleSerializer(serializers.ModelSerializer):
    author_name = serializers.CharField(source='author.name', read_only=True)

    class Meta:
        model = Article
        fields = ['id', 'title', 'content', 'author', 'author_name', 'status', 'published_at']

# views.py
from rest_framework import viewsets
from .models import Article
from .serializers import ArticleSerializer

class ArticleViewSet(viewsets.ModelViewSet):
    queryset = Article.objects.filter(status='published')
    serializer_class = ArticleSerializer

# urls.py
from rest_framework.routers import DefaultRouter
from .views import ArticleViewSet

router = DefaultRouter()
router.register('articles', ArticleViewSet)
urlpatterns = router.urls

参考文献

• Django 公式ドキュメント - 公式リファレンスとチュートリアル
• Django 公式チュートリアル - 公式の入門チュートリアル
• Django REST Framework - API開発用の拡張フレームワーク
• Django GitHub - ソースコードとIssue
• Two Scoops of Django - Djangoのベストプラクティス書籍
• Django Girls Tutorial - 初心者向けの日本語チュートリアル
• Flask 公式ドキュメント - Pythonのマイクロフレームワーク
• FastAPI 公式ドキュメント - Python製の高速APIフレームワーク