Djangoハローワールドチュートリアル

Djangoをスムーズに動かす前に、Python 3.8以上とpip（Pythonのパッケージインストーラー）がシステムにインストールされている必要があります。ほとんどの最新オペレーティングシステムにはPythonがプリインストールされていますが、確認しておくと良いでしょう。

ターミナルを開いて、どのPythonバージョンがインストールされているか確認してください:

python3 --version

Python 3.8.x以降が表示されない場合、またはPythonが見つからない場合は、python.orgから最新の安定版3.xリリースをダウンロードしてインストールしてください。Djangoは最新版を好みます。

グローバルなPythonパッケージをいじり回すのは、きれいな図書館に子供を放り込むようなもので、すぐに散らかってしまいます。だからこそ、仮想環境を使用するのです。仮想環境は、プロジェクトの依存関係のための整然とした自己完結型の空間であり、すべてを整理整頓し、競合を回避します。

まず、Djangoプロジェクトをどこに置くか決めましょう。ターミナルでその場所に移動し、新しい仮想環境を作成します:

python3 -m venv .venv

次に、それをアクティベートします。コマンドはオペレーティングシステムによって若干異なります:

# macOS/Linuxの場合
source .venv/bin/activate

# Windowsの場合 (コマンドプロンプトを使用)
.venv\Scripts\activate

ターミナルのプロンプトに(.venv)というプレフィックスが表示されたら、アクティベートされています。これは、分離された開発空間であることを示す、小さな名誉のバッジのようなものです。

仮想環境が準備できたので、いよいよ本番です。Djangoを導入します。これは驚くほど簡単で、1つのコマンドだけです。

アクティブな仮想環境で、次を実行します:

pip install django

PipはDjangoとその必要なコンポーネントをすべて取得します。完了したら、あなたは正式にDjango対応の開発者です。フレームワークがインストールされ、すぐに使用できる状態になりました。

Djangoの魔法を体験しましょう！ Djangoにバンドルされているdjango-adminコマンドを使用して、まったく新しいプロジェクトの足場を構築します。これは、DjangoがWebアプリケーションの基本的な設計図を配置していると考えてください。

プロジェクトのルートディレクトリ（.venvがある場所）から、このコマンドを実行します:

django-admin startproject mysite .

末尾の.は重要です。これは、Djangoがプロジェクトファイルを別のmysiteフォルダにネストするのではなく、現在のディレクトリに作成するように指示します。これで、Webアプリケーションの骨格となる基本的なDjangoプロジェクト構造ができます。

startprojectコマンドを実行すると、ディレクトリにいくつかの新しいファイルとサブディレクトリが追加されます。何が何であるかを理解するために、簡単に確認してみましょう:

.
├── .venv/                  # 仮想環境
├── manage.py               # Djangoのコマンドラインユーティリティ
└── mysite/                 # プロジェクトの実際のPythonパッケージ
    ├── __init__.py         # mysiteをPythonパッケージとしてマーク
    ├── asgi.py             # 非同期サーバーのASGIエントリーポイント
    ├── settings.py         # プロジェクトの設定
    ├── urls.py             # プロジェクトのURL宣言
    └── wsgi.py             # 同期サーバーのWSGIエントリーポイント
                                

manage.pyは、すべてのDjangoコマンドライン関連の操作に役立つ相棒です。mysite/内では、settings.pyで設定を調整し、urls.pyでプロジェクトの主要なURLルーティングを管理します。

Webページが表示される前に、Djangoはデフォルトのデータベーステーブルを設定する必要があります。ユーザー認証や管理インターフェースのような組み込み機能には、データを保存するための場所が必要です。

ここでマイグレーションが登場します。これらは本質的にデータベースへの指示です。プロジェクトのルート（manage.pyがある場所）からこれを実行します:

python manage.py migrate

Djangoが認証、セッション、管理パネル用のテーブルをデフォルトのSQLiteデータベースに作成する際に、多くの出力が表示されます。これは、壁を建てる前に基礎を準備するようなものです。

Djangoでは、「プロジェクト」は設定と「アプリ」のコレクションです。「アプリ」とは、特定のことを行うWebアプリケーションのことです。ブログ、アンケート、簡単な「Hello World」などです。このモジュール化はDjangoの強力な機能の1つであり、さまざまなプロジェクトでアプリを再利用できます。

最初のアプリを作成しましょう。hello_world_appと名付けます。このコマンドを実行します:

python manage.py startapp hello_world_app

これで、プロジェクト内にhello_world_app/という新しいディレクトリが表示されます。ここに、「Hello World」の魔法が実際に起こります。

Djangoは、新しく作成されたアプリを自動的に認識しません。プロジェクトの設定に、この新しいアプリが存在し、含めるべきであることを明示的に伝える必要があります。これは、クラブに新しいメンバーを追加するようなもので、名簿を更新する必要があります。

mysite/settings.pyを開き、INSTALLED_APPSリストを見つけます。そこに新しいhello_world_appを追加します:

# mysite/settings.py

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'hello_world_app',  # <-- この行を追加
]
                                

これがないと、Djangoは新しいアプリ内のビュー、モデルなどの場所を探しません。これは、プロジェクトと新しいコンポーネント間の重要な連携です。

Djangoにおける「ビュー」とは、Webリクエストを受け取ってWebレスポンスを返すPython関数またはクラスです。本質的に、これは特定のURLにアクセスしたときにどのコンテンツを表示するかを決定するコアロジックです。

hello_world_app/views.pyを開き、その内容をこのシンプルな関数に置き換えます:

# hello_world_app/views.py

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, Django World!")
                                

このindex関数は非常にシンプルです。呼び出されると「Hello, Django World!」というテキストを返すだけです。最初のステップとしてはかなりいいですね？

新しいビューがWebアドレスからアクセスできるようにするには、URLパターンが必要です。hello_world_appの*内部*に専用のurls.pyファイルを作成して、その特定のルートを管理します。これは、Djangoが好むように、モジュール性を保ちます。

新しいファイルを作成します: hello_world_app/urls.py、そしてこの内容を記述します:

# hello_world_app/urls.py

from django.urls import path
from . import views

urlpatterns = [
    path("", views.index, name="index"),
]
                                

ここでは、path("", views.index, name="index")は、空のパス（つまり、アプリのURLスペースのルート）がindexビューをトリガーすることを意味します。シンプルですよね？

アプリに独自のURLを伝えましたが、プロジェクトのメインURLディスパッチャー（mysite/urls.py）には、hello_world_appが関連するパスを持っていることを知らせる必要があります。これは、支店があるが、本社がそれについて知っておく必要があるようなものです。

mysite/urls.pyを開き、includeを追加してアプリのURLをリンクします:

# mysite/urls.py

from django.contrib import admin
from django.urls import path, include # <-- 'include' を追加

urlpatterns = [
    path("admin/", admin.site.urls),
    path("", include("hello_world_app.urls")), # <-- この行を追加
]
                                

これで、プロジェクトのルートURL（/）にアクセスすると、Djangoはhello_world_app/urls.pyからURLパターンを「含め」、"Hello World"ビューを見つけます。すべてのピースが組み合わさっています！

すべての下準備が完了し、コードが結合され、ルーティングが定義されました。そして、真実の瞬間です！ Djangoには、ローカルでテストするのに最適な軽量開発サーバーが付属しています。

プロジェクトのルートディレクトリ（manage.pyがある場所）から、次を実行します:

python manage.py runserver

多くのターミナル出力が表示され、最後にStarting development server at http://127.0.0.1:8000/のようなメッセージが表示されます。これは、Djangoサーバーが起動し、リクエストを待っていることを意味します。

その瞬間がやってきました！ Webブラウザを開き、Djangoが提供したアドレス、通常はhttp://127.0.0.1:8000/にアクセスしてください。

すべての接続が正しく行われていれば、次のように表示されるシンプルなWebページが表示されるはずです:

これで完了です。あなたの最初のDjango "Hello World"アプリケーションが、ライブでコンテンツを提供しています！ これは小さな一歩ですが、PythonからDjangoのURLルーティングまで、すべてが正しく設定されていることを確認します。あなたは正式にDjango開発への旅を始めました。