さあ、例を交えながら学んでゆきましょう。
\nこのチュートリアルでは、簡単な投票 (poll) アプリケーションの作成に取り組ん でもらいます。
\nPoll アプリケーションは 2 つの部分からなります:
\nユーザが投票したり結果を表示したりできる公開用サイト
投票項目の追加、変更、削除を行うための管理 (admin) サイト
Django は既にインストール済み として、説明を進めます。 Django がインストールされている、どのバージョンか調べるには、以下のコマンドを実行します:
\n$ python -m django --version\nDjango がインストールされていれば、インストールされている Django のバージョンがわかります。もしなければ "No module named django" とエラーが表示されます。
\nこのチュートリアルは Django 1.10 と Python 3.4 以降を対象に書かれています。 Django のバージョンが合わなければ、このページの右下のバージョンスイッチャーを使用して、インストールされている Django のバージョンのチュートリアルを参照するか、最新の Django にアップデートしてください。 Python 2.7 を使用している場合は、コメントで説明されているように、サンプルコードを調整する必要があります。
\nDjango のインストール方法 を見て、 Django の旧バージョンを削除してより新しいものをインストールしてください。
\n\n初めて Django を使うのなら、最初のセットアップを行う必要があります。通常は、 Django の プロジェクト (project) を構成するコードを自動生成します。プロジェクトとは、データベースの設定や Django 固有のオプション、アプリケーション固有の設定などといった、個々の Django インスタンスの設定を集めたものです。
\nコマンドラインから、コードを置きたい場所に cd して、以下のコマンドを 実行してください。
$ django-admin startproject mysite\n現在のディレクトリに mysite ディレクトリが作成されます。動作しなければ Problems running django-admin を参照してください。
startproject が何を作成したかをみてみましょう:
mysite/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n wsgi.py\nファイルはそれぞれ以下のような役割を持っています:
\n外側の mysite/ ルートディレクトリは、このプロジェクトのただの入れ物です。 この名前は Django に関係しませんので、好きな名前に変更できます。
manage.py: Django プロジェクトに対する様々な操作を行うためのコマンドラインユーティリティです｡詳しくは django-admin and manage.py 内の manage.py を参照してください｡
内側の mysite/ ディレクトリは、このプロジェクトの本当の Python パッケージです。この名前が Python パッケージの名前であり、 import の際に 使用する名前です (例えば import mysite.urls) 。
mysite/__init__.py: このディレクトリが Python パッケージであることを Python に知らせるための空のファイルです。Python の初心者は、 Python の公式 ドキュメントの more about packages を読んで下さい。
mysite/settings.py: Django プロジェクトの設定ファイルです。 設定の仕組みは Djangoの設定 を参照してください。
mysite/urls.py: Django プロジェクトの URL 宣言、いうなれば Django サイトにおける「目次」に相当します。詳しくは URL dispatcher を参照 してください。
mysite/wsgi.py: プロジェクトをサーブするためのWSGI互換Webサーバーとのエントリーポイントです。詳細は WSGI とともにデプロイするには を参照してください。
Django のプロジェクトがうまく動作するか確認しましょう。外側の mysite ディレクトリに移動ができたら下記のコマンドを実行してください:
$ python manage.py runserver\nコマンドライン上で下記の出力が確認できるでしょう:
\nPerforming system checks...\n\nSystem check identified no issues (0 silenced).\n\nYou have unapplied migrations; your app may not work properly until they are applied.\nRun 'python manage.py migrate' to apply them.\n\n2026年08月09日 - 15:50:53\nDjango version 1.10, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\n
これで、 Django 開発サーバを起動しました。 Django 開発サーバは Python だけで書かれた軽量な Web サーバです。このサーバは、開発を迅速に行い、運用に適した状態になるまで Apache のような運用サーバの設定をいじらなくても良いようにするためのものです。
\nここでちょっと注意しておきましょう。このサーバは開発中の利用だけを考えて作られています。絶対に運用環境では 使わないでください (筆者たちの専門は Web フレームワークであって、Web サーバではありません)。
\nさあ、これでサーバが起動したので、ブラウザで http://127.0.0.1:8000/ にアクセスしてみてください。 “Welcome to Django” と表示された、明るいパステル調のライトブルーのページが出るはずです。やりましたね！
\n\n\nさあ、これで自分用の環境、すなわちプロジェクトが立ち上がり、作業にとりかかる準備ができました。
\nDjango 内に追加する各アプリケーションは以下の規則に従った Python パッケージで構成されます。 Django には基本的なディレクトリ構造を自動生成するユーティリティが含まれているので、ディレクトリを作ることでなくコードを書くことに集中できます。
\n\nアプリケーションは Python path のどこにでも置けます。このチュートリアルでは投票アプリケーションを manage.py のすぐ隣に作ります。なので、 mysite のサブモジュールとしてでなく、トップレベルのモジュールとしてインポートできます。
アプリケーションを作るには、 manage.py と同じディレクトリに入って、このコマンドを実行します:
$ python manage.py startapp polls\nこのコマンドは polls というディレクトリを作成します。中身はこのようになっています:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n views.py\nこのディレクトリ構造が、 poll アプリケーションの全体像です。
\n最初のビューを書いてみましょう。 polls/views.py を開いて、以下の Python コードを書いてください:
polls/views.pyfrom django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\nDjango上で最も単純なビューです。ビューを呼ぶために、 URL を対応付けしてやる必要があります。 URLconf が必要ですね。
\npolls ディレクトリに URLconf を作るには urls.py というファイルを作ります。アプリのディレクトリはこのようになっているはずです:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n urls.py\n views.py\npolls/urls.py ファイルには以下のコードを書いてください:
polls/urls.pyfrom django.conf.urls import url\n\nfrom . import views\n\nurlpatterns = [\n url(r'^$', views.index, name='index'),\n]\n次のステップはルートのURLconfに polls.urls モジュールの記述を反映させることです。 mysite/urls.py に django.conf.urls.include のimportを追加して、 urlpatterns のリストに include() を挿入します。するとこのようになります:
mysite/urls.pyfrom django.conf.urls import include, url\nfrom django.contrib import admin\n\nurlpatterns = [\n url(r'^polls/', include('polls.urls')),\n url(r'^admin/', admin.site.urls),\n]\ninclude() は他の URLconfs への参照を許可します。 include() のための正規表現は、 $ ( 文字列の終わりに一致する文字 ) よりもむしろトレイリングスラッシュとなることを覚えておいてください。Django が include() に遭遇すると、いつも一致した箇所を URL から切り落とし、次の処理のために残りの文字列を include された URLconf へ渡します。
include() の背景にある考えは、 URL のプラグ & プレイを簡単に作ることです。 polls には独自の URLconf (polls/urls.py) を持っているので、 "/polls/" 、 "/fun_polls/" や、 "/content/polls/" といった、どんなパスルート下にも置けて、どこに置いてもきちんと動作します。
これで"index"ビューをURLconfに接続を接続しました。下記のコマンドを実行して、動作を確認しましょう:
\n$ python manage.py runserver\nブラウザで http://localhost:8000/polls/ にアクセスすると、"Hello, world. You're at the polls index." と表示されるのが確認できるでしょう。これはビューの``index``で定義したものです。
\nurl() 関数は4つの引数を受け取り、そのうち2つが必須です。 regex と view 、オプションで kwargs と name です。ここで引数が何のためにあるものかを見ておきましょう。
url() 引数: regexLink to this heading#"regex" という単語は省略形で、一般的に "regular expression" という意味があります。これは文字列にマッチするパターンの構文で、この場合はURLパターンにあたります。 Django ははじめの正規表現から開始し、リストを順に下に見ていきます。リクエストされたURLと各正規表現を、マッチするものが見つかるまで比較します。
\nこれらの正規表現はGETやPOSTパラメーター、そしてドメイン名をサーチ検索しないことに注意します。例えば、 https://www.example.com/myapp/ へのリクエストにおいては、URLconfは myapp/ を見ます。 https://www.example.com/myapp/?page=3 へのリクエストにおいても、URLconfは myapp/ を見ます。
正規表現についてわからないことがあれば Wikipediaのエントリー と re モジュールのドキュメントを参照してください。オライリーから出版されている Jeffery Friendl の "Mastering Reglar Expressions" も参考になります。しかし実際問題としては、正規表現のエキスパートになる必要はありません。単純なパターンをキャプチャする方法を知っていれば十分です。それに複雑な正規表現はルックアップのパフォーマンスが悪いので、正規表現のフルパワーに依存するのはよくありません。
パフォーマンスノート: 正規表現は URLconf モジュールが読み込まれた最初にコンパイルされるので、高速に動作します (先ほど述べたように複雑すぎない場合)。
\nurl() 引数: viewLink to this heading#Django がマッチする正規表現を見つけると、 Django は所定のビュー関数を呼び出します。その際は HttpRequest オブジェクトを第一引数に、その他、正規表現から「キャプチャされた」値を他の引数に関数を呼び出します。正規表現が単純にキャプチャをしている場合は位置引数として、名前付きでキャプチャしている場合はキーワード引数として呼び出します。少し例を提示します。
url() 引数: kwargsLink to this heading#任意のキーワード引数を辞書として対象のビューに渡せます。この機能はチュートリアルでは使いません。
\nurl() 引数: nameLink to this heading#URL に名前付けをしておけば Django のどこからでも明確に参照でき、とくにテンプレートの中で有効です。この便利な機能のおかげで、プロジェクトのURLにグローバルな変更を加える場合にも1つのファイルを変更するだけで済むようになります。
\n基本的なリクエストとレスポンスのフローがお好みの場合は、データベースを使った作業を始めるために チュートリアルその2 を読みましょう。
\n