本当に初めての人でもわかるDjango入門チュートリアル

こんにちわ！ 管理人のsinyです。
この記事はDjango入門者向けのチュートリアルです。
Django入門者向けにDjango開発を始めるにあたって必要となるタスク全般の基礎知識についてまとめました。

一般的なチュートリアル記事より手順を詳細に記載していますので、この記事を通じてDjangoに関わる人が一人でも増えたら幸いです！

また、Django入門者向けのチュートリアルノートも配信していますので、こちらもぜひチェックしてみてください。

特に初心者の方で、本記事の内容について質問がありましたら、問合せフォーム、またはTwitterから受け付けていますのでお気軽にどうぞ。

Django開発環境について(2019年3月17日更新）

本チュートリアルでは、以下の環境でDjangoを開発することを前提に記載しています。

sinyblog

Python開発環境構築入門【初心者向け】

http://sinyblog.com/python/env_construction/

こんにちわ！ 管理人のsinyです。この記事では、Python初心者向けにAnacondaを利用したPython開発環境の構築方法について丁寧に説明します。この記事ではWindows10環境を前提としています。構築環境の概要この記事では以下の環境を構築します。区分バージョンOSWindows10Python3.6.52018年12月時点でPythonの最新バージョンは3.7ですが、最新バージョンではうまく動作しないライブラリー等も見受けられるため、比較的安定していると思われる1世代前の3.6を導入することとします。AnacondaのインストールWindowsPC上でpythonの開発環境...

それでは、Djangoチュートリアルを進めていきます。

仮想環境の作成

Djangoの開発を進めていくと様々なライブラリーを利用することになりますが、開発案件毎に

異なるバージョンを利用したいというニーズが出てきます。

Aシステム開発ではDajngo1.6を使っているけ

ど新規B案件ではDjango2.0を利用したい！

そんな時は仮想環境を利用すればいいですよ！
ローカルPC環境内に仮想環境を作成することで、

開発プロジェクト毎に独立した開発環境を準備

することができます。

開発環境の作成は非常に簡単です。

WindowsのMS-DOS画面を起動したら、以下のコマンドを実行してください。

mkdir c:\django\venv
cd c:\django\venv
python -m venv tutorial

.\tutorial\Scripts\activate

すると、以下のように(仮想環境名） c:\django\venvという表示に変わります。

deactivate

Djangoモジュールのインポート

Djangoで開発するためには、必要に応じてモジュールをインストールする必要があります。
モジュールのインストールはPythonのパッケージ管理システム（pipコマンド）を使って行います。

モジュールのインポート（通常の場合）

まず最初に、pipコマンド自体を最新バージョンにアップデートします。
仮想環境を有効化した状態で、以下のコマンドを実行します。

python -m pip install --upgrade pip

「Successfully installed pip-xx.x」というメッセージが表示されたことを確認します。

それでは、続いてDjango本体のインストールを行います。
今回はDjangoのバージョン2.0.6を導入します。
以下のコマンドを実行してください。

pip install django==2.0.6 

モジュールのインストールは「pip install [モジュール名]==[バージョン] 」という形式で実行します。

「Successfully installed django-2.0.6」というメッセージが表示されたことを確認します。

つづいてdjangoがインストールされているか確認してみましょう。

インストールされているモジュールを確認するには[pip list]コマンドを実行します。

(tutorial) c:\django\venv;pip list
Package    Version
---------- -------
Django     2.0.6
pip        18.1
pytz       2018.7
setuptools 39.0.1

Package列にモジュール名、Version列にバージョンが表示されます。
上記4行目を見るとバージョン2.0.6のDjangoがインストールされていることが確認できます。

モジュールのインポート（Proxy環境の場合）

個人開発のケースではあまり問題にならないと思いますが、社内ネットワーク環境下でモジュールのインポートを行う場合、大抵のケースでProxyの問題でインポートエラーとなります。

Proxy環境下でpip installコマンドを実行する場合は以下の形式でコマンドを実行する必要があります。

pip install [モジュール名] --proxy [プロキシアドレス]:[ポート番号]

以下は具体例です。

pip install django==2.0.6 --proxy http://10.155.3.123:80

Proxy環境下でモジュールをインポートする度に毎回proxyオプションを指定するのは結構面倒くさいので、以下の設定を一度行っておくと便利です。

①Anacondaのルートフォルダに.condarcファイルを作成します。

②作成した.condarcファイルを開いて以下を記述して保存します。

proxy_servers:
    http: http://[プロキシアドレス]:[ポート番号]
    https: https://[プロキシアドレス]:[ポート番号]

以上でモジュールのインポート手順の説明は終わりです。

Djangoプロジェクトの作成

Djangoでは「プロジェクト」と「アプリケーション」という2階層で構成されています。
開発するシステムに対して1つのプロジェクト(単なるフォルダ）というものを作成します。

そして、プロジェクト（フォルダ）の配下にアプリケーションを作成するという流れになります。

プロジェクトは開発するシステムに対して1つだけ作成し、1つのプロジェクトに対して複数のアプリケーションを作成することができます。

アプリケーションはどのような単位

で作成するのでしょうか？

アプリケーションは機能ごとに作成するイメージです。

例えば・・・

アプリケーション①：ユーザ管理機能

アプリケーション②：在庫管理機能

アプリケーション③：受発注管理機能

といったイメージです。

実際の開発は、アプリケーションフォルダ内にpythonのコードファイル(拡張子が.py)を作成して
コーディングしていくことになります。

それでは、プロジェクトの作成に進みましょう。

プロジェクトの作成は以下のコマンドで行います。

django-admin startproject [プロジェクト名]

cd c:\django

django-admin startproject tutorial

開発サーバの起動

cd c:\django\tutorial

python manage.py runserver

http://127.0.0.1:8000/にアクセスして以下の画面が表示されればOKです！

言語設定（英語⇒日本語）

LANGUAGE_CODE = 'en-us'
TIME_ZONE = 'UTC'

LANGUAGE_CODE = 'ja'
TIME_ZONE = 'Asia/Tokyo'

データベースの設定

sqliteの場合

DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
}
}

MySQLの場合

データベースにMySQLを利用する場合は、以下のような設定になります。

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'データベース名',
        'USER': 'DB接続ユーザ名',
        'PASSWORD': 'パスワード',
        'HOST': 'dbサーバ名',
        'OPTIONS': {
            'charset': 'utf8mb4',
        },
    }
}

接続するデータベースはあらかじめ作成しておく必要があります。
また、OPTIONSとしてデータベースのcharasetを指定することができます。

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

webシステムを開発するためにはDjangoのアプリケーションを作成する必要があります。

python manage.py startapp kakeibo

モデルの作成

from django.db import models
# Create your models here.

from django.db import models　　　
# Create your models here.

class Category(models.Model): 
    class Meta:
        #テーブル名の指定
        db_table ="category"

　　#カラム名の定義
    category_name = models.CharField(max_length=255,unique=True)

from django.db import models

class Category(models.Model):

class Meta:
    #テーブル名の指定
    db_table ="category"

category_name = models.CharField(max_length=255,unique=True)

class Kakeibo(models.Model):
    class Meta:
        #テーブル名
        db_table ="kakeibo"

    #カラムの定義
    date = models.DateField(verbose_name="日付",default=datetime.now)
    category = models.ForeignKey(Category, on_delete = models.PROTECT, verbose_name="カテゴリ")
    money = models.IntegerField(verbose_name="金額", help_text="単位は日本円")
    memo = models.CharField(verbose_name="メモ", max_length=500)

class Kakeibo(models.Model):

class Meta:
    #テーブル名
    db_table ="kakeibo"

#カラムの定義
date = models.DateField(verbose_name="日付",default=datetime.now)
category = models.ForeignKey(Category, on_delete = models.PROTECT, verbose_name="カテゴリ")
money = models.IntegerField(verbose_name="金額", help_text="単位は日本円")
memo = models.CharField(verbose_name="メモ", max_length=500)

from django.db import models
from datetime import datetime #追加する

date = models.DateField(verbose_name="日付",default=datetime.now)

money = models.IntegerField(verbose_name="金額", help_text="単位は日本円")

category = models.ForeignKey(Category, on_delete = models.PROTECT, verbose_name="カテゴリ")

[項目名] = models.ForeignKey([参照先 , on_delete = [オプション] ,[その他のフィールドオプション)
　　 ↓　　　　　　　　　　　　　  　↓　　　　　　　　　　　　　↓                     　↓
category = models.ForeignKey(Category, on_delete = models.PROTECT, verbose_name="カテゴリ")

from django.db import models
from datetime import datetime

class Category(models.Model):
    class Meta:
    #テーブル名
        db_table ="category"

    #カラム名の定義
    category_name = models.CharField(max_length=255,unique=True)

class Kakeibo(models.Model):
    class Meta:
    #テーブル名
        db_table ="kakeibo"

    #カラムの定義
    date = models.DateField(verbose_name="日付",default=datetime.now)
    category = models.ForeignKey(Category, on_delete = models.PROTECT, verbose_name="カテゴリ")
    money = models.IntegerField(verbose_name="金額", help_text="単位は日本円")
    memo = models.CharField(verbose_name="メモ", max_length=500)

Djangoマイグレーション

INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'kakeibo', #ここを追加 「最後の「,」を忘れずに！
]

それでは、マイグレーションを実行していきます。
マイグレーションには以下の２ステップあります。

python manage.py makemigrations kakeibo

python manage.py migrate

note（ノート）

 

2 Pockets

Djangoで毎月の出費を分析できる家計簿アプリをつくろう！【応用編】｜siny｜note

https://note.mu/shinya_hd/n/n9fc315792862

この技術ノートは、「Djangoで毎月の出費を分析できる家計簿アプリをつくろう！【基礎編】」の応用編となっています。 基礎編がまだの方は、以下の基礎編からチャレンジしてみてください。 さて、この技術ノートでは、「Djangoで毎月の出費を分析できる家計簿アプリをつくろう！【基礎編】」の応用編として以下の機能を実装していきます。 【毎月の合計額推移を分析する折れ線グラフ】 ※家計簿テーブルに登録されている全データをもとに、月単位、カテゴリ毎の合計出費額を自動計算して月毎の合計金額推移の折れ線グラフを...

 

Djangoで毎月の出費を分析できる家計簿アプリをつくろう！【応用編】

note（ノート）

 

2 Pockets

Djangoで毎月の出費を分析できる家計簿アプリをつくろう！【応用編】｜siny｜note

https://note.mu/shinya_hd/n/n9fc315792862

この技術ノートは、「Djangoで毎月の出費を分析できる家計簿アプリをつくろう！【基礎編】」の応用編となっています。 基礎編がまだの方は、以下の基礎編からチャレンジしてみてください。 さて、この技術ノートでは、「Djangoで毎月の出費を分析できる家計簿アプリをつくろう！【基礎編】」の応用編として以下の機能を実装していきます。 【毎月の合計額推移を分析する折れ線グラフ】 ※家計簿テーブルに登録されている全データをもとに、月単位、カテゴリ毎の合計出費額を自動計算して月毎の合計金額推移の折れ線グラフを...

Django Webアプリ開発コース（基礎編+応用編セット）

note（ノート）

 

1 Pocket

Django WEBアプリ開発コース｜siny｜note

https://note.mu/shinya_hd/m/m7c72d8925919

以下のコースをまとめた割引プランです。 ・Djangoで毎月の出費を分析できる家計簿アプリをつくろう！【基礎編】 ￥980・Djangoで毎月の出費を分析できる家計簿アプリをつくろう！【応用編】 ￥500￥1,500相当のチュートリアルを、セット割で￥1,000で販売します。Djangoの環境構築からCRUD WEBアプリ開発+α Djangoの応用事例を学習したい人にお勧めです。ボリュームは約13万字ありますので、200～300ページ程度の技術書と同等のボリュームがあると思います。初心者用に図解を多く（約90枚）取り入れて、説明も多く掲載しています。

この記事が良かったと思う方はTwitterフォロー(shiny)とリツイート頂けると嬉しいです！