Djangoとは

Django とは Python の Webアプリケーションフレームワークです。
Python で Webアプリケーションを作成するために便利な機能を提供しています。

環境

Ubuntu-20.04 (wsl)
Python 3.9.7

pip で Django をインストール

1. pip を最新状態に更新
$ pip install -U pip

2. Django をインストール
$ pip install django

Djangoの初期ページを表示

プロジェクトの作成
$ django-admin startproject <プロジェクト名>

プロジェクトファイルの中身

TestSite/
├── TestSite
│   ├── __init__.py
│   ├── __pycache__/
│   ├── asgi.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── db.sqlite3
└── manage.py

manage.py を使ってプロジェクトを操作します。

初期ページの表示
$ cd TestSite/
$ python manage.py runserver

ブラウザで localhost:8000 にアクセスすると下のようなDjangoの初期ページを確認することができます。

アプリケーションを作成

Django では機能ごとにアプリケーションを分けるので１つのプロジェクトに複数のアプリケーションが存在することになります。

TestSite/
$ python manage.py startapp <アプリケーション名>

testApp/
├── __init__.py
├── admin.py
├── apps.py
├── migrations
│   └── __init__.py
├── models.py
├── tests.py
└── views.py

templatesの作成

実際に表示するHTMLファイルを作成します。
HTMLファイルを配置するのは、 templates/testApp の中です。

TestSite/testApp/
$ mkdir templates
$ mkdir templates/testApp

test.html

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <title>Test Page</title>
  </head>
  <body>
    <h1>Hello Django!</h1>
  </body>
</html>

views を修正

先ほど作成した html を表示するための処理を views.py に書いていきます。

views.py

from django.shortcuts import render

def testView(request):
  return render(request, 'testApp/test.html')

URLマッピングの設定

Django では各アプリケーションごとの urls.py で URLマッピングを行います
まずは、作成したアプリケーションを登録します。

settings.py

# 33行目ぐらいにあるINSTALLED_APPSというリストを修正します。

INSTALLED_APPS = [
  'django.contrib.admin',
  'django.contrib.auth',
  'django.contrib.contenttypes',
  'django.contrib.sessions',
  'django.contrib.messages',
  'django.contrib.staticfiles',
  'testApp',
]

次に、TestSite/urls.py でアプリケーション内の urls.py を include します。

TestSite/urls.py

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
  path('admin/', admin.site.urls),
  path('', include('testApp.urls')),
]

最後に、アプリケーション内の urls.py で URLマッピングを行います。

testApp/urls.py

from django.urls import path
from . import views

urlpatterns = [
  path('', veiws.testView, name='testView'),
]

先ほどと同じ localhost:8000 にアクセスすると、先ほど作成した test.html が表示されます。

おまけ

作成したhtmlに値を渡して表示することができます。

test.html

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <title>Test Page</title>
  </head>
  <body>
    <h1>{{title}}</h1>
    <p>{{message}}</p>
  </body>
</html>

html内には {{キー}} を配置し、views.py で辞書（params）を定義します。

views.py

from django.shortcuts import render

def testView(request):
  params = {
    'title' : 'Hello Django!',
    'message': 'このページはDjangoによって表示されています。',
  }

  return render(request, 'testApp/test.html', params)

render の第3引数に params を指定することで、辞書のキーの値を html に埋め込み表示します。