PythonのWEBフレームワークDjangoの使い方 プロジェクトの作成

前回の「MacにPythonのWEBフレームワークDjangoをインストールする方法」では準備が整いました。

PythonのWEBフレームワークDjangoの使い方 プロジェクトの作成について説明します。
プロジェクトの作成と開発サーバーを起動しブラウザからアクセスします。

It worked!

環境

MacにPythonのWEBフレームワークDjangoをインストールする方法」で構築した環境を例に説明します。

ディレクトリに移動し仮想環境に入る

ディレクトリに移動します。

cd ~/my_django

以下のコマンドでPythonの仮想環境を有効にしましょう。

source myvenv/bin/activate

プロンプトの先頭の表示が「(myvenv)」に変わればPython仮想環境が有効です。

(myvenv)<マシン名>:my_django <ユーザー名>$」

プロジェクトの作成

プロジェクトを作成します。
プロジェクトとは、開発するWebアプリケーションに関するものをあつめたものです。
「startproject」コマンドを実行しましょう。
※末尾の「.」(ドット)まで入力してください。

(myvenv)<マシン名>:my_django <ユーザー名>django-admin startproject mysite .

「startproject」で作成されたディレクトリを確認してみましょう。
ディレクトリ構成を確認するには、「tree」コマンドが便利です。
「tree」コマンドを導入していない場合は、「ディレクトリ構造を階層的に表示するTreeコマンドのインストール方法」を参照しインストールしてください。

(myvenv)<マシン名>:my_django <ユーザー名>tree -L 2
.
├── manage.py
├── mysite
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
└── myvenv
 ├── bin
 ├── include
 ├── lib
 ├── pip-selfcheck.json
 └── pyvenv.cfg

それぞれのファイルの役割

  • my_django 名前は Django に関係しませんので、好きな名前に変更できます。
  • manage.py: Django プロジェクトに対する様々な操作を行うための コマンドラインユーティリティです。詳しくは django-admin.py と manage.py を参照してください。
  • mysite/ ディレクトリは、このプロジェクトPython パッケージの名前でです。 import の際に 使用する名前です (例 import mysite.settings) 。
  • mysite/__init__.py: このディレクトリが Python パッケージであることを Python に知らせるための空のファイルです。(Python の初心者は、 Python の公式 ドキュメントの パッケージの詳しい説明 を読んで下さい。)
  • mysite/settings.py: Django プロジェクトの設定ファイルです。 設定の仕組みは Django の設定を参照してください。
  • :file:mysite/urls.py: Django プロジェクトの URL 宣言、いうなれば Django サイトにおける「目次」に相当します。詳しくは URL ディスパッチャ を参照 してください。
  • mysite/wsgi.py: WSGI互換のある Web サーバでプロジェクトを動かすための エントリーポイントです。詳しくは WSGI 環境にデプロイする方法 を参照 してください。

参考:はじめての Django アプリ作成、その 1 — Django 1.4 documentation

開発用サーバーの起動と確認

開発用WEBサーバーを動かして、Webサイトがうまく動いているか確認します。

開発用サーバーを起動

開発用サーバーを起動させるには、以下のコマンドを実行しましょう。

(myvenv)<マシン名>:my_django <ユーザー名>python manage.py runserver

以下のように表示されたら開発用サーバーが起動できています。

(myvenv)<マシン名>:my_django <ユーザー名>python manage.py runserver
Performing system checks...

System check identified no issues (0 silenced).
August 07, 2017 - 20:40:01
Django version 1.11.4, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

ブラウザから動作確認

WEBサイトの動作を確認します。
ブラウザから以下のアドレスにアクセスしてください。

http://127.0.0.1:8000/

「It worked!」と表示されれば成功です!

It worked!

開発用サーバーを終了するには?

なお、開発用WEBサーバーを終了する場合は、「control + C」 を押します。