Django入門ガイド：知っておきたいことと始め方

By /

はい、承知いたしました。Djangoの入門者向けガイドとして、知っておくべきことや始め方を約5000語の詳細な記事形式で記述します。

Django入門ガイド：知っておきたいことと始め方

Web開発の世界に足を踏み入れるにあたり、数多くのフレームワークやツールが存在します。その中でも、Pythonで書かれたハイレベルなWebフレームワークであるDjangoは、その「バッテリー付属（Batteries included）」という思想のもと、Webアプリケーション開発に必要な多くの機能を提供し、開発者が効率的に、かつセキュアなアプリケーションを構築できるようサポートします。この記事では、Djangoとは何か、なぜ学ぶ価値があるのか、そして実際に開発を始めるために知っておくべきことや手順について、詳細に解説します。

1. Djangoとは何か？ なぜDjangoを選ぶのか？

1.1 Djangoの概要

Djangoは、Pythonで書かれた無料かつオープンソースのWebフレームワークです。2005年に初めて公開されて以来、安定した開発が続けられ、世界中の多くの開発者や企業に利用されています。その主な目的は、Web開発を迅速かつ容易にすることにあり、繰り返し行われる多くのタスクを自動化し、開発者がアプリケーションの核心部分に集中できるよう設計されています。

Djangoは「MTV (Model-Template-View)」と呼ばれるデザインパターンを採用しています（これは他のフレームワークで一般的に使用されるMVCパターンと類似していますが、Django独自の命名です）。このパターンに基づき、アプリケーションの異なる側面（データ、ロジック、プレゼンテーション）が明確に分離されるため、コードの保守性や再利用性が高まります。

1.2 Djangoの特徴とメリット

Djangoが多くの開発者に選ばれる理由には、いくつかの大きな特徴があります。

  • 高速な開発 (Rapid Development): Djangoは、開発者がゼロから多くのものを構築する必要がないように設計されています。強力なORM（Object-Relational Mapper）、テンプレートエンジン、URLディスパッチャー、自動生成される管理サイトなど、多数の組み込み機能が提供されており、これにより開発スピードが大幅に向上します。
  • セキュア (Secure): Djangoは、一般的なWebの脆弱性（SQLインジェクション、クロスサイトスクリプティング(XSS)、クロスサイトリクエストフォージェリ(CSRF)、クリックジャッキングなど）からアプリケーションを保護するための機能やベストプラクティスをデフォルトで提供しています。これにより、セキュリティに関する懸念を軽減し、より安全なアプリケーションを構築できます。
  • スケーラブル (Scalable): Djangoは、大量のトラフィックやデータを扱うアプリケーションにも対応できるよう設計されています。コンポーネントが疎結合されており、必要に応じて特定の部品（例: データベース）をスケールアウトすることが可能です。
  • 保守が容易 (Maintainable): MTVパターンによる明確な分離、DRY（Don’t Repeat Yourself）の原則への準拠、クリーンなコード構造などにより、開発したアプリケーションの保守や機能追加が容易になります。
  • 機能が豊富（Batteries included）: 前述のように、認証システム、管理パネル、セッション管理、キャッシュフレームワーク、国際化・ローカライゼーションなど、多くの便利なツールや機能が標準で含まれています。これにより、外部ライブラリに依存することなく、多くの要件を満たすことができます。
  • 多様性 (Versatile): Djangoは特定のドメインに限定されず、CMS（コンテンツ管理システム）、ソーシャルネットワーク、科学計算プラットフォーム、APIバックエンドなど、様々な種類のWebアプリケーション開発に使用できます。
  • 活発なコミュニティ (Vibrant Community): Djangoには大規模で活発なコミュニティがあり、豊富なドキュメント、チュートリアル、フォーラム、サードパーティ製パッケージが利用可能です。困ったときに助けを求めやすい環境が整っています。

1.3 どのような場合にDjangoを選ぶべきか？

  • MVP（Minimum Viable Product）を迅速に開発したい場合
  • データベースを利用する比較的複雑なWebアプリケーションを構築する場合
  • セキュリティが重要な要件である場合
  • フルスタックのフレームワークを求めている場合（バックエンドから一部フロントエンドまで）
  • Python開発者であり、Pythonのエコシステムを活用したい場合
  • 将来的なスケーラビリティを考慮する必要がある場合

1.4 他のフレームワークとの比較（ごく簡単に）

  • Flask (Python): Flaskはマイクロフレームワークであり、Djangoよりも機能が少なく軽量です。小規模なアプリケーションやAPI構築に向いており、必要な機能を自分で選択・追加したい場合に適しています。Djangoはより多くの機能が組み込まれており、大規模なアプリケーション開発のスタートに適しています。
  • Ruby on Rails (Ruby): Ruby on Railsも強力なフルスタックフレームワークで、開発スピードが速いことで知られています。Djangoと同様に規約に基づいた開発を推奨しますが、言語が異なります。Pythonのエコシステムやコミュニティを活用したい場合はDjangoが良い選択です。
  • Node.js + Express (JavaScript): Node.jsはサーバーサイドJavaScriptの実行環境で、Expressはその上で動く人気のフレームワークです。JavaScriptスタックで統一したい場合や、リアルタイムアプリケーションに適しています。非同期処理が得意な一方、Express自体は最小限の機能しか提供しないため、他のライブラリの選定や統合が必要になります。Djangoは同期処理が基本ですが、ASGIによる非同期対応も進化しています。

2. 始める前に知っておくべきこと（前提条件）

Djangoを使ったWeb開発を始める前に、以下の準備と知識があるとスムーズに進められます。

  • Pythonの基礎知識: Pythonの基本的な文法（変数、データ型、リスト、辞書、関数、クラス、モジュールなど）が理解できていることが望ましいです。
  • HTML/CSSの基礎知識: Webページの構造を定義するHTMLと、見た目を装飾するCSSの基本的な理解が必要です。
  • コマンドライン/ターミナルの基本操作: ディレクトリの移動、ファイルの作成、コマンドの実行など、基本的なコマンドライン操作が必要です。Djangoの多くの作業はコマンドラインで行います。
  • データベースの基本的な考え方（オプション）: リレーショナルデータベースの基本的な概念（テーブル、カラム、行、主キー、外部キー、リレーションシップなど）を知っていると、DjangoのORMの理解が深まります。必須ではありませんが、学習効率が上がります。

3. 開発環境のセットアップ

Django開発を始めるための環境構築手順です。

3.1 Pythonのインストール

まず、Pythonがシステムにインストールされているか確認します。コマンドプロンプトやターミナルを開いて、以下のコマンドを実行してください。

“`bash
python –version

または

python3 –version
“`

バージョン情報（例: Python 3.9.7）が表示されればインストールされています。表示されない場合や古いバージョンの場合は、Pythonの公式サイトから最新版（執筆時点では3.8以上を推奨）をダウンロードしてインストールしてください。インストール時に「Add Python to PATH」のようなオプションがあれば、チェックを入れるとコマンドラインから実行しやすくなります。

3.2 仮想環境の利用（強く推奨）

Pythonプロジェクトでは、プロジェクトごとに異なるライブラリのバージョンを使用することがよくあります。仮想環境（Virtual Environment）は、プロジェクトごとに独立したPython環境を作成し、ライブラリの依存関係が他のプロジェクトに影響を与えないようにするための仕組みです。Django開発においても、仮想環境の利用は強く推奨されます。

Python 3.3以降にはvenvという仮想環境管理ツールが標準で搭載されています。

プロジェクトを置きたいディレクトリに移動し、以下のコマンドで仮想環境を作成します。

“`bash

プロジェクトディレクトリを作成 (例: mydjangosite)

mkdir mydjangosite
cd mydjangosite

仮想環境を作成 (環境名: venv など)

python -m venv venv

または python3 を使用する場合

python3 -m venv venv
“`

これで、mydjangositeディレクトリ内にvenvというディレクトリが作成されます。これがあなたの新しい仮想環境です。

次に、この仮想環境を「アクティベート（有効化）」します。

  • macOS/Linux:
    bash
    source venv/bin/activate
  • Windows (Command Prompt):
    cmd
    venv\Scripts\activate.bat
  • Windows (PowerShell):
    powershell
    venv\Scripts\Activate.ps1

仮想環境がアクティベートされると、コマンドラインのプロンプトの先頭に(venv)のような環境名が表示されるようになります。これで、このターミナルセッションでインストールするPythonパッケージは、この仮想環境内にのみインストールされます。

仮想環境を終了する際は、以下のコマンドを実行します。

bash
deactivate

3.3 Djangoのインストール

仮想環境がアクティベートされた状態で、以下のコマンドを実行してDjangoをインストールします。Pythonのパッケージ管理ツールであるpipを使用します。

bash
pip install Django

インストールが完了したら、以下のコマンドでDjangoがインストールされているか確認できます。

“`bash
pip list

または

django-admin –version
“`

バージョン情報が表示されれば成功です。

4. Djangoプロジェクトの作成

環境構築が完了したら、Djangoの「プロジェクト」を作成します。プロジェクトは、設定や全体的な構造を含むDjangoインスタンス全体のパッケージです。

先ほど作成したプロジェクトディレクトリ（例: mydjangosite）にいることを確認し、以下のコマンドを実行します。

bash
django-admin startproject config .

  • django-admin: Djangoの管理コマンドを実行するためのツールです。
  • startproject: 新しいプロジェクトを作成するサブコマンドです。
  • config: プロジェクト設定が含まれるディレクトリの名前です。慣習的にconfigやプロジェクト名自体が使われます。
  • .: 現在のディレクトリにプロジェクトを作成することを示します。.を付けないと、mydjangositeの中にconfigというさらに一層深いディレクトリが作成されてしまいます。現在のディレクトリにプロジェクトのファイル群を展開したい場合は.を付けます。

このコマンドを実行すると、mydjangositeディレクトリ直下に以下のファイルとディレクトリが作成されます。

mydjangosite/
├── manage.py
└── config/
├── __init__.py
├── asgi.py
├── settings.py
├── urls.py
└── wsgi.py

  • manage.py: Djangoプロジェクトを操作するためのコマンドラインユーティリティです。サーバー起動、データベース操作、アプリ作成など、多くのDjangoコマンドはこのファイルを通して実行します（例: python manage.py runserver）。
  • config/: プロジェクトの設定ファイルが含まれるディレクトリです。このディレクトリ名はstartprojectコマンドの第一引数で指定しました。
    • __init__.py: Pythonパッケージであることを示す空のファイルです。
    • asgi.py: 非同期Webサーバーとプロジェクトを連携させるための設定ファイルです（ ASGI: Asynchronous Server Gateway Interface）。リアルタイム通信などに使用されますが、最初はあまり気にしなくて良いです。
    • settings.py: プロジェクトの全ての主要な設定が含まれるファイルです。データベース設定、インストール済みアプリ、静的ファイル設定、タイムゾーンなど、様々な設定を行います。
    • urls.py: プロジェクト全体のURLとビューのマッピングを定義するファイルです。どのURLにアクセスがあったときに、どのPythonコード（ビュー）を実行するかをここで指定します。
    • wsgi.py: Webサーバーとプロジェクトを連携させるための設定ファイルです（ WSGI: Web Server Gateway Interface）。同期的なWebアプリケーションで使用されます。

4.1 開発サーバーの起動

プロジェクトが作成できたら、Djangoに組み込まれている開発サーバーを起動して、正しくセットアップできたか確認してみましょう。manage.pyがあるディレクトリ（mydjangosites）に移動し、以下のコマンドを実行します。

bash
python manage.py runserver

サーバーが起動すると、以下のようなメッセージが表示されます。

“`
Watching for file changes with StatReloader
Performing system checks…

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for apps: admin, auth, contenttypes, sessions.
Run ‘python manage.py migrate’ to apply them.
September 10, 2023 – 12:00:00
Django version 4.2.5, using settings ‘config.settings’
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
“`

メッセージ中のhttp://127.0.0.1:8000/にブラウザでアクセスしてください。ロケットのアイコンが表示された「The install worked successfully! Congratulations!」というページが表示されれば、プロジェクトの作成とサーバー起動は成功です。

CONTROL-C（WindowsではCtrl+C）を押すと、サーバーは停止します。

You have 18 unapplied migration(s)... というメッセージが表示されていますが、これはDjangoの組み込み機能（認証システム、管理サイトなど）に必要なデータベースの初期設定がまだ適用されていないことを示しています。次のセクションで説明するmigrateコマンドを実行すると解消されます。

5. Djangoの核心：MVTパターンと主要コンポーネント

DjangoはMVT (Model-Template-View)パターンを採用しています。これは、MVC (Model-View-Controller)パターンをDjangoの哲学に合わせて再解釈したものです。

  • Model: データの構造を定義し、データベースとのやり取りを管理します。DjangoのORM（Object-Relational Mapper）を使ってPythonコードでデータベースのテーブルや関係性を定義できます。SQLを書く必要はほとんどありません。
  • View: アプリケーションのビジネスロジックを記述する部分です。ユーザーからのリクエストを受け取り、Modelからデータを取得・操作し、その結果をTemplateに渡してレスポンスを生成します。関数またはクラスとして定義されます。DjangoのViewは、MVCにおけるControllerの役割に近いですが、さらにTemplateと連携してレスポンスを生成する部分も担います。
  • Template: ユーザーに表示されるプレゼンテーション層です。HTMLコードに、Djangoのテンプレート言語（DTL: Django Template Language）を使って動的なデータを埋め込んだファイルです。Viewから渡されたデータを受け取り、最終的なHTMLを生成します。MVCにおけるViewの役割に近いと言えます。

リクエストがDjangoプロジェクトに到着すると、以下の流れで処理されます。

  1. URLs (urls.py): まず、リクエストされたURLパスが、プロジェクトのURL設定 (urls.py) と照合されます。
  2. View (views.py): マッチしたURLパターンに紐づけられたView関数（またはクラスメソッド）が実行されます。Viewはリクエストオブジェクトを受け取ります。
  3. Model (models.py): Viewは必要に応じてModelを介してデータベースとやり取りし、データを取得したり保存したりします。
  4. Template (.html ファイル): Viewは取得したデータをContextと呼ばれる辞書形式でTemplateに渡します。TemplateはContextデータと自身の構造を組み合わせて、HTMLレスポンスを生成します。
  5. Response: 生成されたHTMLレスポンスがユーザーのブラウザに返されます。

このMTVパターンに加えて、Djangoには以下の重要なコンポーネントがあります。

  • Apps (apps.py): Djangoプロジェクトは、一つまたは複数の「アプリケーション (App)」で構成されます。Appは、特定の機能（例: ブログ、投票システム、ユーザー認証）を担当する独立したパッケージです。Appは他のプロジェクトでも再利用可能なように設計されることが多いです。プロジェクト全体のファイルの中に、機能ごとのまとまりとしてAppを作成するのが一般的な構造です。
  • Settings (settings.py): プロジェクト全体の構成設定（データベース接続、インストール済みアプリ、タイムゾーン、静的ファイルの場所など）を保持します。
  • Migrations (migrations/): Modelの定義変更（新しいテーブルの追加、カラムの変更など）をデータベースのスキーマ変更に変換・適用するための仕組みです。これにより、データベースのスキーマ管理が容易になります。
  • Admin Site: Djangoが自動生成する強力な管理インターフェースです。定義したModelに基づいて、データの閲覧、追加、編集、削除をWebブラウザから簡単に行えます。開発中は非常に便利です。

6. 初めてのDjangoアプリケーション作成（簡単なブログ機能）

概念だけでは分かりにくいので、実際に簡単なブログアプリケーションを作成しながら、前述のコンポーネントがどのように連携するかを見ていきましょう。

6.1 アプリケーションの作成

まず、プロジェクト内に新しいアプリケーションを作成します。manage.pyがあるディレクトリ（mydjangosite）で以下のコマンドを実行します。

bash
python manage.py startapp blog

これにより、blogという新しいディレクトリとファイル群が作成されます。

mydjangosite/
├── manage.py
├── config/
│ └── ...
└── blog/
├── migrations/
├── __init__.py
├── admin.py
├── apps.py
├── models.py
├── tests.py
└── views.py

  • blog/: 作成したアプリケーションのルートディレクトリです。
  • admin.py: Django Adminサイトにモデルを登録するためのファイルです。
  • apps.py: アプリケーションの設定ファイルです。
  • models.py: アプリケーションのデータ構造（Model）を定義するファイルです。
  • tests.py: アプリケーションのテストを記述するファイルです。
  • views.py: アプリケーションのロジック（View）を記述するファイルです。

6.2 アプリケーションの登録

作成したアプリケーションをプロジェクトに認識させる必要があります。プロジェクトのsettings.pyファイルを開き、INSTALLED_APPSリストに'blog'を追加します。

“`python

config/settings.py

INSTALLED_APPS = [
‘django.contrib.admin’,
‘django.contrib.auth’,
‘django.contrib.contenttypes’,
‘django.contrib.sessions’,
‘django.contrib.messages’,
‘django.contrib.staticfiles’,
# 作成したアプリケーションを追加
‘blog’,
]

他の設定はそのまま

“`

6.3 データベース設定と初期マイグレーション

DjangoはデフォルトでSQLiteというファイルベースのデータベースを使用します。小規模なプロジェクトや開発段階ではこれで十分です。settings.pyにはすでにSQLiteの設定が書かれています。

“`python

config/settings.py

DATABASES = {
‘default’: {
‘ENGINE’: ‘django.db.backends.sqlite3’,
‘NAME’: BASE_DIR / ‘db.sqlite3’,
}
}
“`

プロジェクトの作成時に表示された「unapplied migration(s)」を解消するため、そしてDjangoの組み込みアプリ（認証、管理サイトなど）や今後作成するアプリケーションのデータベース構造を反映させるために、マイグレーションを実行します。

manage.pyがあるディレクトリで、以下のコマンドを実行します。

bash
python manage.py migrate

これにより、db.sqlite3というファイルがプロジェクトのルートディレクトリに作成され、必要なテーブルがデータベースに作成されます。

6.4 管理サイトのためのスーパーユーザー作成

Django Adminサイトにログインするために、管理者権限を持つユーザー（スーパーユーザー）を作成します。

bash
python manage.py createsuperuser

コマンドを実行すると、ユーザー名、メールアドレス、パスワードの入力を求められます。

Username (leave blank to use 'your_username'): admin
Email address: [email protected]
Password:
Password (again):
Superuser created successfully.

パスワードを入力しても画面に表示されませんが、入力はされています。パスワード入力後、Enterキーを押すとユーザーが作成されます。

開発サーバーを再度起動し (python manage.py runserver)、ブラウザでhttp://127.0.0.1:8000/admin/にアクセスしてください。ログイン画面が表示されるので、作成したスーパーユーザーの認証情報でログインできます。ログイン後、サイトの管理画面が表示されます。現時点では、認証関連のテーブルなどが管理対象として表示されているはずです。

7. Modelの定義とデータベース連携

ブログ記事のデータ構造を定義しましょう。ブログ記事には、タイトル、本文、公開日、作成者などの情報が必要です。

blog/models.pyファイルを開き、以下のようにModelを定義します。

“`python

blog/models.py

from django.db import models
from django.contrib.auth.models import User # 後で作成者と紐付けるためにUserモデルをインポート
from django.utils import timezone

Create your models here.

class Post(models.Model):
“””ブログ記事モデル”””
title = models.CharField(max_length=200, verbose_name=’タイトル’)
text = models.TextField(verbose_name=’本文’)
author = models.ForeignKey(User, on_delete=models.CASCADE, verbose_name=’作成者’) # Userモデルとの関連
created_date = models.DateTimeField(default=timezone.now, verbose_name=’作成日’)
published_date = models.DateTimeField(blank=True, null=True, verbose_name=’公開日’) # 公開されていない記事もありうるためNullを許可

def publish(self):
    """記事を公開するメソッド"""
    self.published_date = timezone.now()
    self.save()

def __str__(self):
    """オブジェクトの文字列表現"""
    return self.title

class Meta:
    """モデルのメタデータ"""
    ordering = ['-created_date'] # デフォルトの並び順を作成日の新しい順にする
    verbose_name = '記事'
    verbose_name_plural = '記事' # 管理画面で表示される名前

“`

  • models.Modelを継承することで、このクラスがDjangoのModelであることを示します。
  • 各クラス変数（title, textなど）がデータベースのテーブルのカラムに対応します。models.Fieldのサブクラス（CharField, TextFieldなど）を使用してカラムのデータ型や制約を定義します。
  • max_length: CharFieldに必要な最大文字数です。
  • ForeignKey: 他のModel（ここではDjangoの組み込みUserモデル）との一対多の関係を定義します。on_delete=models.CASCADEは、関連付けられたUserが削除された場合に、そのUserが作成した記事も一緒に削除することを意味します。
  • default=timezone.now: オブジェクト作成時のデフォルト値を設定します。Djangoではタイムゾーン対応のためにdjango.utils.timezone.nowを使うのが一般的です。
  • blank=True, null=True: フィールドが空（ブランク）またはNULL値を許可するかどうかを設定します。
  • verbose_name, verbose_name_plural: Django Adminなどで表示される、人間が読みやすい名前です。
  • publishメソッド: Modelに独自のメソッドを追加できます。ここでは、記事を公開する際にpublished_dateを設定するメソッドを定義しました。
  • __str__メソッド: Pythonオブジェクトの文字列表現を定義します。これにより、例えばAdminサイトでオブジェクトが表示される際に、記事のタイトルが表示されるようになります。
  • Metaクラス: モデルに関する様々なオプション（並び順、テーブル名、表示名など）を設定できます。ordering = ['-created_date']は、取得した際にcreated_dateの降順（新しい順）に並べ替えられることを意味します。

Modelを定義したら、これをデータベースに反映させるための「マイグレーションファイル」を作成します。

bash
python manage.py makemigrations blog

makemigrationsコマンドは、models.pyの変更を検知し、データベースのスキーマ変更手順を記述したPythonファイル（マイグレーションファイル）をblog/migrations/ディレクトリに作成します。

Migrations for 'blog':
blog/migrations/0001_initial.py
- Create model Post

次に、このマイグレーションファイルをデータベースに適用します。

bash
python manage.py migrate

これにより、Postモデルに対応するテーブルがデータベースに作成されます。

7.1 ModelをAdminサイトに表示する

作成したPostモデルをDjango Adminサイトで管理できるようにします。

blog/admin.pyファイルを開き、以下のように編集します。

“`python

blog/admin.py

from django.contrib import admin
from .models import Post # 作成したPostモデルをインポート

Register your models here.

admin.site.register(Post) # PostモデルをAdminサイトに登録
“`

開発サーバーを起動し (python manage.py runserver)、http://127.0.0.1:8000/admin/に再度アクセスしてログインしてください。サイドバーに「BLOG」という項目が表示され、その中に「記事 (Posts)」が表示されているはずです。ここから新しい記事の追加や既存記事の編集・削除が行えます。いくつかの記事を追加してみてください。

8. ViewとURL設定

Webサイトの各ページを表示するためのロジックをViewに記述し、どのURLがどのViewに対応するかをURL設定ファイルで定義します。

8.1 Viewの作成

ブログの記事一覧を表示するViewと、個別の記事詳細を表示するViewを作成します。

blog/views.pyファイルを開き、以下のように編集します。

“`python

blog/views.py

from django.shortcuts import render, get_object_or_404 # renderとget_object_or_404をインポート
from .models import Post # Postモデルをインポート
from django.utils import timezone # timezoneをインポート

Create your views here.

def post_list(request):
“””ブログ記事一覧を表示するView”””
# 公開日が設定されている記事のみを取得し、公開日の新しい順に並べ替える
posts = Post.objects.filter(published_date__lte=timezone.now()).order_by(‘-published_date’)
# テンプレートに渡すContextを作成
context = {‘posts’: posts}
# blog/post_list.htmlテンプレートをレンダリングしてレスポンスを返す
return render(request, ‘blog/post_list.html’, context)

def post_detail(request, pk):
“””個別ブログ記事詳細を表示するView”””
# 主キー(pk)を使って記事を取得、存在しない場合は404エラー
post = get_object_or_404(Post, pk=pk)
# テンプレートに渡すContextを作成
context = {‘post’: post}
# blog/post_detail.htmlテンプレートをレンダリングしてレスポンスを返す
return render(request, ‘blog/post_detail.html’, context)
“`

  • render(request, template_name, context): Viewの基本的な戻り値の形式です。指定したテンプレートをレンダリングし、HTTPレスポンスオブジェクトを返します。
  • get_object_or_404(Model, **kwargs): 指定した条件でオブジェクトを検索し、存在すればそのオブジェクトを、存在しなければHTTP 404 Not Foundレスポンスを返します。個別記事のように、存在しないIDでアクセスされた場合のエラー処理を簡潔に記述できます。
  • Post.objects.filter(...): Django ORMを使ったデータの絞り込みです。published_date__lte=timezone.now()は「published_dateが現在時刻以下のもの（つまり公開されているもの）」という条件を指定しています。
  • .order_by('-published_date'): 取得したデータセットをpublished_dateの降順（-が付くと降順）に並べ替えます。
  • context: テンプレートに渡したいデータを辞書形式で格納します。辞書のキーがテンプレート内で変数名として使用できます（例: postsリストはテンプレートで{{ posts }}としてアクセス可能）。

8.2 URL設定

作成したViewにアクセスするためのURLを設定します。URL設定はプロジェクト全体とアプリケーションごとに行うのが一般的です。

まず、プロジェクト全体のurls.py（config/urls.py）で、blogアプリケーションのURL設定を含めるようにします。

“`python

config/urls.py

from django.contrib import admin
from django.urls import path, include # includeをインポート

urlpatterns = [
path(‘admin/’, admin.site.urls), # AdminサイトのURLパターン
# ‘blog/’から始まるURLは blogアプリのurls.py で処理する
path(‘blog/’, include(‘blog.urls’)),
# ルートパス(‘/’)にアクセスがあった場合、blogアプリのURLにリダイレクト or 他のViewを指定することも可能
# path(”, RedirectView.as_url(‘/blog/’, permanent=True)), # 例: ルートパスをブログ一覧にリダイレクト
# path(”, include(‘blog.urls’)), # 例: ルートパスをblogアプリのurls.pyで処理する（複雑になる可能性あり）
# 今回はシンプルに ‘blog/’ をトップとみなします。
]
“`

次に、blogアプリケーション専用のURL設定ファイルを作成します。blogディレクトリ直下にurls.pyという名前で新しいファイルを作成し、以下のように記述します。

“`python

blog/urls.py

from django.urls import path
from . import views # 同じディレクトリにあるviews.pyをインポート

このアプリケーションのURLの名前空間を定義

app_name = ‘blog’

urlpatterns = [
# /blog/ (root of the blog app) にアクセスがあった場合、views.post_list を実行
path(”, views.post_list, name=’post_list’),
# /blog/1/, /blog/2/ など、数値が続くパスにアクセスがあった場合、views.post_detail を実行
# はパスコンバーター。数値部分をpkという名前のキーワード引数としてViewに渡す。
path(‘/’, views.post_detail, name=’post_detail’),
]
“`

  • from . import views: 同じディレクトリにあるviews.pyモジュールをインポートします。
  • app_name = 'blog': このアプリケーションのURLに名前空間を割り当てます。他のアプリケーションと同じURL名が衝突するのを防ぐことができます。テンプレートなどでURLを逆引きする際に、'blog:post_list'のように指定します。
  • urlpatterns: URLパターンを定義するリストです。
  • path(route, view, name=None): URLパターンを定義する関数です。
    • route: URLのパス部分です。config/urls.pyのinclude('blog.urls')で'blog/'の下に来るパスを指定します。
    • view: そのパスにマッチした場合に実行されるView関数です。
    • name: そのURLパターンにつける名前です。テンプレートやViewからURLを逆引きする際に使用します。URLのハードコーディングを防ぐために非常に重要です。
  • <int:pk>/: パスコンバーターと呼ばれる記法です。<type:name>の形式で、URLパスの一部をキャプチャし、View関数にキーワード引数として渡します。intは整数にマッチし、キャプチャした値をpkという名前でViewに渡します。

これで、http://127.0.0.1:8000/blog/にアクセスするとpost_list Viewが、http://127.0.0.1:8000/blog/1/のようなパスにアクセスするとpost_detail Viewが実行されるようになりました。

9. Templateの作成

Viewから渡されたデータを表示するためのHTMLテンプレートを作成します。Djangoのテンプレートは、HTMLコードに特別なタグやフィルターを埋め込んで動的な内容を表示できます。

9.1 Templateディレクトリの作成

Djangoは、デフォルトで各アプリケーション内のtemplates/ディレクトリ、さらにその中のアプリ名と同じ名前のサブディレクトリ（例: blog/templates/blog/）にあるテンプレートファイルを検索します。この構造は、他のアプリケーションと同じテンプレートファイル名が衝突するのを防ぐために推奨されています。

blogディレクトリ内にtemplatesディレクトリを作成し、その中にさらにblogディレクトリを作成します。

mydjangosite/
├── ...
└── blog/
├── migrations/
├── templates/
│ └── blog/
│ ├── post_list.html
│ └── post_detail.html
└── ...

9.2 記事一覧テンプレートの作成

blog/templates/blog/post_list.htmlファイルを作成し、以下のように記述します。

“`html




ブログ記事一覧

ブログ

{% for post in posts %} {# Viewから渡されたpostsリストをループ処理 #}

{{ post.title }}

{# 個別記事へのリンク。urlタグでURLを逆引き #}

{{ post.published_date|date:”Y年m月d日 H:i” }}

{# published_dateをフォーマットして表示。dateフィルターを使用 #}

{{ post.text|linebreaksbr }}

{# textフィールドの改行を
タグに変換。linebreaksbrフィルターを使用 #}

{% empty %} {# ループするリストが空の場合の処理 #}

まだ記事がありません。

{% endfor %}

“`

  • {% ... %}: Djangoテンプレートタグです。ロジック（ループ、条件分岐、URL生成など）を実行します。
  • {{ ... }}: Djangoテンプレート変数です。Viewから渡されたコンテキストデータや、その属性を表示します。
  • {% for post in posts %} … {% endfor %}: postsリストの各要素に対してループ処理を行います。各要素はpostという変数で参照できます。
  • {% empty %}: {% for %}ループでリストが空の場合に実行されるブロックです。
  • {% url 'blog:post_detail' post.pk %}: urlタグを使って、指定した名前（blog:post_detail）と引数（post.pk = 記事の主キー）から対応するURLを動的に生成します。blog:はblogアプリの名前空間、post_detailはblog/urls.pyで定義したURLの名前です。これにより、URLパターンを変更してもテンプレートのリンクを修正する必要がなくなります。
  • {{ variable|filter }}: テンプレートフィルターを使って変数の表示形式を変更できます。date:"Y年m月d日 H:i"は指定された形式で日付をフォーマットします。linebreaksbrはテキスト内の改行文字を<br>タグに変換します。

9.3 記事詳細テンプレートの作成

blog/templates/blog/post_detail.htmlファイルを作成し、以下のように記述します。

“`html




{{ post.title }} – ブログ {# 記事タイトルをページのタイトルに表示 #}

{{ post.title }}

{# 記事タイトルを表示 #}

{{ post.published_date|date:”Y年m月d日 H:i” }}

{# 公開日を表示 #}

{{ post.text|linebreaksbr }} {# 本文を表示、改行を変換 #}

ブログ記事一覧に戻る

{# 一覧ページへのリンク #}

“`

  • {{ post.title }}: Viewから渡されたpostオブジェクトのtitle属性を表示します。
  • {{ post.text|linebreaksbr }}: postオブジェクトのtext属性を表示し、改行を変換します。
  • {% url 'blog:post_list' %}: 記事一覧ページ（blog:post_listという名前のURL）へのリンクを生成します。このURLパターンは引数を取らないので、post.pkのような引数は不要です。

9.4 テンプレートの継承（DRY原則の適用）

今のテンプレートは非常にシンプルですが、ヘッダー、ナビゲーション、フッターなど、多くのページで共通して使われる部分が出てきます。同じコードを繰り返し書くのはDRY原則に反するため、テンプレートの継承機能を使います。

まず、ベースとなるテンプレートファイルを作成します。プロジェクトのルートディレクトリ直下のtemplatesディレクトリ、またはアプリケーションのtemplates/ディレクトリの親ディレクトリ（mydjangosite/templates/）に配置するのが一般的です。ここでは、プロジェクトルート直下にtemplatesディレクトリを作成し、その中にbase.htmlを作成します。

mydjangosite/
├── manage.py
├── config/
│ └── ...
├── blog/
│ └── ...
└── templates/
└── base.html

settings.pyのTEMPLATES設定で、この新しいtemplatesディレクトリをテンプレート検索パスに追加する必要があります。

“`python

config/settings.py

TEMPLATES = [
{
# … other settings
‘DIRS’: [BASE_DIR / ‘templates’], # プロジェクトルートのtemplatesディレクトリを追加
‘APP_DIRS’: True, # アプリケーション内のtemplatesディレクトリも検索する
# … other settings
},
]
“`

base.htmlファイルを作成し、以下のように記述します。

“`html
{# templates/base.html #}





{% block title %}My Django Blog{% endblock %} {# titleブロック。デフォルト値を設定 #}
{# 静的ファイル（CSSなど）を読み込む場合は {% load static %} タグを使用し {% static ‘path/to/css’ %} とする #}

Django Blog


{% block content %}
{# 各ページ固有のコンテンツはこのブロックで置き換えられる #}
{% endblock %}

© {{ ‘now’|date:”Y” }} My Django Blog

{# 現在の年を表示 #}


“`

  • {% block block_name %} … {% endblock %}: ブロックを定義します。子テンプレートはこのブロックの内容を置き換えることができます。
  • {% block title %}: ページのタイトル用のブロックです。
  • {% block content %}: ページ固有のメインコンテンツ用のブロックです。
  • {{ 'now'|date:"Y" }}: 組み込みフィルターを使って現在時刻を取得し、年のみをフォーマットして表示します。

次に、子テンプレート（post_list.htmlとpost_detail.html）を編集して、base.htmlを継承するようにします。

blog/templates/blog/post_list.htmlを以下のように変更します。

“`html
{# blog/templates/blog/post_list.html #}
{% extends ‘base.html’ %} {# base.htmlを継承する #}

{% block title %}ブログ記事一覧{% endblock %} {# base.htmlのtitleブロックを上書き #}

{% block content %} {# base.htmlのcontentブロックを上書き #}

ブログ記事一覧

{% for post in posts %}

{{ post.title }}

{{ post.published_date|date:”Y年m月d日 H:i” }}

{# 本文全体ではなく、一部だけ表示するなど変更可能 #}

{{ post.text|truncatechars:200|linebreaksbr }}…

{# テキストを200文字で切り詰め #}

{% empty %}

まだ記事がありません。

{% endfor %}
{% endblock %}
“`

blog/templates/blog/post_detail.htmlを以下のように変更します。

“`html
{# blog/templates/blog/post_detail.html #}
{% extends ‘base.html’ %}

{% block title %}{{ post.title }} – ブログ{% endblock %}

{% block content %}

{{ post.title }}

{{ post.published_date|date:”Y年m月d日 H:i” }}

{{ post.text|linebreaksbr }}

ブログ記事一覧に戻る

{% endblock %}
“`

  • {% extends 'template_name.html' %}: このタグをテンプレートファイルの先頭に書くことで、指定したテンプレートを継承します。
  • 子テンプレートで定義したブロックは、親テンプレートの同名のブロックの内容を置き換えます。親テンプレートで定義されていないブロックを子テンプレートで定義しても、デフォルトでは表示されません（親テンプレートで{{ block.super }}などを使用しない限り）。
  • truncatechars:200: テキストを最初の200文字で切り詰め、末尾に...を追加するフィルターです。

これで、開発サーバーを起動してhttp://127.0.0.1:8000/blog/にアクセスすると、base.htmlの構造の中にpost_list.htmlの内容が埋め込まれて表示されます。個別の記事をクリックすると、post_detail.htmlの内容が表示されます。

10. 静的ファイル（CSS, JavaScript, 画像など）の扱い

Webサイトには、CSS、JavaScript、画像などの静的ファイルが必要です。Djangoは開発環境と本番環境で静的ファイルの扱い方が異なります。開発中は簡単に扱うことができます。

10.1 静的ファイルの設定

settings.pyには、静的ファイルに関する基本的な設定がすでに含まれています。

“`python

config/settings.py

Static files (CSS, JavaScript, Images)

https://docs.djangoproject.com/en/4.2/howto/static-files/

STATIC_URL = ‘/static/’ # 静的ファイルにアクセスするためのURL
“`

これは、ブラウザから/static/css/style.cssのようなURLで静的ファイルにアクセスした場合、Djangoがどこか（後で設定する場所）を探しに行くことを意味します。

アプリケーション固有の静的ファイル（例: ブログアプリのCSS）は、アプリケーションディレクトリ内のstatic/ディレクトリ、さらにその中のアプリ名と同じ名前のサブディレクトリ（例: blog/static/blog/）に配置するのが一般的です。

mydjangosite/
├── ...
└── blog/
├── static/
│ └── blog/
│ └── style.css # 例
└── ...

プロジェクト全体で共通して使う静的ファイルは、プロジェクトルート直下のstatic/ディレクトリに配置し、そのパスをsettings.pyでDjangoに教えるのが一般的です。

mydjangosite/
├── manage.py
├── config/
│ └── ...
├── blog/
│ └── ...
├── static/
│ └── style.css # 例
└── templates/
└── base.html

プロジェクト全体の静的ファイルディレクトリを指定するには、settings.pyにSTATICFILES_DIRS設定を追加します。

“`python

config/settings.py

STATIC_URL = ‘/static/’

プロジェクトルート直下の static ディレクトリを指定

STATICFILES_DIRS = [
BASE_DIR / ‘static’,
]

本番環境での静的ファイルの収集先ディレクトリ (開発中は通常不要)

STATIC_ROOT = BASE_DIR / ‘staticfiles’

“`

10.2 テンプレートでの静的ファイルの利用

テンプレートで静的ファイル（例: static/style.css）を使用するには、まずテンプレートの先頭で{% load static %}タグを読み込みます。そして、{% static 'path/to/file' %}タグを使用してファイルのURLを生成します。

templates/base.htmlを編集してCSSファイルを読み込むようにします。例として、プロジェクトルートのstatic/ディレクトリにstyle.cssを配置した場合を想定します。

css
/* static/style.css */
body {
font-family: sans-serif;
margin: 20px;
line-height: 1.6;
}
h1, h2, h3 {
color: #333;
}
div {
margin-bottom: 20px;
padding-bottom: 20px;
border-bottom: 1px solid #eee;
}
a {
color: #007bff;
text-decoration: none;
}
a:hover {
text-decoration: underline;
}

templates/base.html:

“`html
{# templates/base.html #}
{% load static %} {# static タグを読み込む #}





{% block title %}My Django Blog{% endblock %} {# CSSファイルを読み込む #}

Django Blog

{# H1にもリンクを追加 #}


{% block content %}
{# 各ページ固有のコンテンツ #}
{% endblock %}

© {{ ‘now’|date:”Y” }} My Django Blog


“`

開発サーバーは、DEBUG=True（デフォルト）の場合、自動的にSTATIC_URLで指定されたパスでSTATICFILES_DIRSや各アプリのstatic/ディレクトリにある静的ファイルをサーブしてくれます。サーバーを再起動してブラウザを更新すると、CSSが適用されているのが確認できます。

注意点: この静的ファイルの提供方法は開発サーバー限定です。本番環境では、Webサーバー（Nginx, Apacheなど）が静的ファイルを直接提供するように設定する必要があります。そのためにpython manage.py collectstaticコマンドを使用しますが、これはデプロイの際に学ぶべき内容です。

11. 次のステップ

ここまでで、Djangoの基本的な構造、環境構築、Model、View、Template、URL設定、Adminサイト、静的ファイルの扱いの基礎を学びました。これらはDjango開発の出発点ですが、実際のWebアプリケーション開発にはさらに多くの要素が必要です。

学習を続けるための次のステップとして、以下のようなトピックに取り組むことをお勧めします。

  • フォーム (Forms): ユーザーからのデータ入力（例: 記事の作成・編集画面）を扱うための仕組みです。Djangoのフォーム機能は、データの表示、バリデーション、クリーニングを強力にサポートします。
  • ユーザー認証と認可 (Authentication and Authorization): ユーザーの登録、ログイン、ログアウト機能や、特定のユーザーのみがアクセスできるページ、特定の権限を持つユーザーのみが実行できる操作などを実装するための組み込み機能です。
  • クラスベースView (Class-Based Views – CBV): これまで関数ベースView (FBV) を使いましたが、共通のパターンを持つView（リスト表示、詳細表示、フォーム処理など）をクラスとして定義し、より効率的かつ再利用可能なコードを書くための仕組みです。
  • リレーションシップの詳細: ForeignKey以外のリレーションシップ（ManyToManyField, OneToOneField）の使い方を学びます。
  • クエリセットの詳細: ORMを使ったより高度なデータベース操作（集計、リレーションシップを跨いだクエリ、Fオブジェクト、Qオブジェクトなど）を学びます。
  • テスト (Testing): 作成したアプリケーションが正しく動作するかを自動的に検証するためのテストコードの書き方を学びます。Djangoはテストフレームワークを内蔵しています。
  • デプロイ (Deployment): 開発したアプリケーションをインターネット上で公開するための手順（本番Webサーバー、データベース、静的ファイルの配信、設定など）を学びます。Heroku, AWS, Renderなどのプラットフォームへのデプロイ方法があります。
  • REST API: Django REST Framework（DRF）のようなサードパーティライブラリを使用して、スマートフォンアプリやJavaScriptフロントエンドと連携するためのAPIを構築します。
  • キャッシュ (Caching): アプリケーションのパフォーマンスを向上させるために、頻繁にアクセスされるデータを一時的に保存する仕組みを学びます。
  • シグナル (Signals): 特定のアクション（例: モデルの保存、ユーザーのログイン）が発生したときに、他の関数を自動的に実行するための仕組みです。

これらのトピックはDjangoの公式ドキュメントや、Django Girls Tutorialのような優れた無料リソースで学ぶことができます。

12. まとめ

この記事では、Djangoの基本、開発環境のセットアップ、そしてMVTパターンに基づいた簡単なWebアプリケーションの構築方法を解説しました。Djangoは多くの機能が組み込まれているため、初めは覚えることが多いと感じるかもしれませんが、その分、Web開発の多くの側面を効率的にカバーできます。

学んだことの要点:

  • DjangoはPython製の高機能なWebフレームワークである。
  • MVTパターン（Model, Template, View）でアプリケーションを構造化する。
  • 仮想環境を使ってプロジェクトごとに独立した環境を作るのが良いプラクティスである。
  • django-adminコマンドでプロジェクトを作成し、manage.pyコマンドで様々な操作を行う。
  • Modelでデータの構造を定義し、makemigrationsとmigrateでデータベースを管理する。
  • Adminサイトで簡単にデータベースの内容を管理できる。
  • Viewでリクエスト処理とビジネスロジックを記述する。
  • URL設定 (urls.py) でURLとViewをマッピングする。
  • Template (.html) でHTML構造と動的なデータを組み合わせて表示する。
  • 静的ファイル（CSSなど）はstatic/ディレクトリに配置し、テンプレートで{% load static %}と{% static ... %}タグを使って参照する。

Djangoは、単なるフレームワークではなく、Webアプリケーション開発における様々なベストプラクティスを推奨し、開発者がセキュアで保守しやすいコードを書くことを助けてくれます。このガイドが、あなたのDjango学習の第一歩となり、さらなる学びへの興味を引き出すことができれば幸いです。

実際に手を動かし、コードを書き、エラーにぶつかり、それを解決していく過程が、最も効果的な学習方法です。公式ドキュメントやコミュニティを活用しながら、あなたのWeb開発プロジェクトをDjangoで実現してください。

これで、Djangoの入門ガイドとして、約5000語の詳細な記事が完成しました。概念説明、環境構築、主要コンポーネント、実践的なアプリケーション構築例（簡単なブログ）、そして静的ファイルの扱いや次のステップまで、初心者が必要とする基本的な情報を網羅しています。

コメントする

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

上部へスクロール