前提

MacでPyCharmを使って開発します。
多くの文献がそうであるように、仮想環境を構築して基本的には(venv)の中で作業をしていきます。

省略していますが

このように書いているのはターミナルに打ってくださいねの意味ですが、仮想環境にいる状態で(つまり$source venv/bin/activateした状態で)、

(venv)$

打ってくださいねの意味と思ってください。

プロジェクトの作成

PyCharmのトップ画面から Create New Projectする

preferencesのproject interpreterから＋ボタンで検索画面へ。

Djangoを検索しインストール。
サクセスメッセージが出たらインストール成功です。

$ django-admin.py startproject config .
$ python manage.py startapp accounts

さてここからはディレクトリ構成を意識しながらプロジェクトを構築していきます。

このようなディレクトリ構成をまず作っておきます。

settings.pyを編集する

1.MySQLの設定をする

今回はデータベースにMySQLを使用します。
デフォルトではsqlite3という軽量なデータを扱うのに向いたデータベースがセットされていますが、
今回はMySQLを使う仕様なので設定を変更していきます。

まずはMySQLをDjangoで使う為に、pymysqlというパッケージをインストールします

$pip install pymysql

これはパッケージというか、正式にいうとドライバのひとつですね。
ドライバとは何かというと、以下の説明をご覧ください。

最も基本的な定義では、ドライバーとはオペレーティングシステムとデバイスの間で相互のやり取りを可能にするソフトウェアコンポーネントのことです。たとえば、あるアプリケーションでデバイスからデータを読み取る必要がある場合を考えてみます。アプリケーションはオペレーティングシステムで実装された関数を呼び出し、オペレーティングシステムはドライバーで実装された関数を呼び出します。デバイスの設計と製造をした会社が作ったドライバーであれば、デバイスハードウェアとやり取りする方法を認識してデータを取得します。ドライバーがデバイスからデータを取得した後、データはオペレーティングシステムに返され、さらにアプリケーションへと返されます。
https://msdn.microsoft.com/ja-jp/library/windows/hardware/ff554678(v=vs.85).aspx

初心者にとってもわかりやすい説明ですが、もう少しわかりやすくいうとするならば、「必要なもの」ということです。

まずはDATABASESから

settings.py

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql', #mysqlに変更する
        'NAME': 'django_database', #作成するデータベースの名前
        'USER': 'root', #MySQLのユーザー名、自分はrootにしてあります
        'PASSWORD': '', #MySQLのパスワード、自分は設定していません
        'HOST': 'localhost', #MySQLのHOST、自分はlocalhostにしてあります
        'PORT': '', #MySQLのPORT、自分は指定していません
        'OPTIONS': {
            'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",
        },
        'TEST': {
            'NAME': 'test'
        }
    }
}

自分がインストールしたMySQLの設定の確認は以下を参照。

＄mysql -u root

※MySQLに入るのにユーザー名とパスワード使用の有無はわかっていないといけない

mysql> select host, user from mysql.user;

+-----------+---------------+
| host      | user          |
+-----------+---------------+
| localhost | mysql.session |
| localhost | mysql.sys     |
| localhost | root          |
+-----------+---------------+
3 rows in set (0.01 sec)

続いて、MySQLに入った状態からデータベースを作成してみましょう。
先ほどsettings.py で自分で書いた名前で作成してください

mysql> CREATE DATABASE django_database;
Query OK, 1 row affected (0.04 sec)

さらに、データベースが作れたかどうかはこちらで確認できます！

mysql> SHOW DATABASES;

+-------------------------------+
| Database                      |
+-------------------------------+
| django_database               |
+-------------------------------+

うまく作成できていることがわかったら、mysqlを抜けてください

次は、manage.pyのimport分の後ろに以下を足します

manage.py

import pymysql


pymysql.install_as_MySQLdb()

続いてmigrate、runserverしてみましょう

$python manage.py migrate
$python manage.py runserver

とりあえずサーバーが立ち上がることが確認できました。
もう少しsettings.py をいじっていきましょう

2.テンプレートを設定する

settings.py

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

'DIRS'がデフォルトでは空になっていると思いますが、これはビューが指定するテンプレートに対してどのディレクトリを優先するかを設定するものです。以上のように加筆しておきましょう

3.LANGUAGE_CODEとTIME_ZONE

ここは日本です。
日本人向けのサービスを作るので日本向けの設定にします。

settings.py

LANGUAGE_CODE = 'ja'

TIME_ZONE = 'Asia/Tokyo'

日本語は安心しますね。

その他細かいセッティングがありますが一旦ここまでにしておきます。

ログイン画面を作る

URLディスパッチャの設定

config/urls.py に書かれるurlpatterns = [] は、URLパターンにマッチするビュー関数を見つけてくる為のものです。

config/urls.py

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

このincludeを用いると、アプリケーションごとのurls.pyを読み込みます。これにより、「/accounts/」で始まるURLパターンの全てを「accounts」アプリケーションのaccounts/urls.pyに委譲しています。

accounts/urls.py


app_name = 'accounts'
urlpatterns = [
    path('login/', views.login, name='login'),
]

ビューの設定

accounts/views.py

from django.contrib.auth.views import LoginView as AuthLoginView


class LoginView(AuthLoginView):
    template_name = 'accounts/login.html'


login = LoginView.as_view()

config/settings.py に追記します

config/settings.py

LOGIN_URL = '/accounts/login/'

あくまでログインするところまでの実装なので最小限すぎるほど最小限の実装に留めます。

テンプレートを用意する

ログイン後リダイレクトする為のhome.htmlというページをtemplates直下に作っておきます
中身はあとで書いていきます。

$touch home.html

共通レイアウトに関してはbase.htmlにまとめます

templates/base.html

<!doctype html>
{% load static %}
<html lang="ja">
<head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Sample_title</title>
</head>
<body>
<div class="ui container">
    {% block content %}{% endblock %}
</div>
</body>
</html>

ミニマムなログイン画面を作ります

templates/accounts/login.html

{% extends "base.html" %}
{% block page_title %}ログイン{% endblock %}

{% block content %}
<h2>ログイン</h2>
<form method="post">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">ログイン</button>
</form>
{% endblock %}

csrf_tokenを絶対忘れないでください。
ちなみにpython manage.py runserver して、
http://127.0.0.1:8000/accounts/login/
にアクセスすると

こんなにもシンプルで美しいログインページが現れます

続いてhome.html　を一応書いていきます。

templates/home.html

{% extends "base.html"%}
{% block title %}ホーム{% endblock %}
{% block content%}
<h2>ホーム</h2>
ようこそ {{user.get_username}} さん
{% endblock%}

これもシンプルで上質なページができそうな気がしてたまらないですね。

home.html へ接続する為に、config/urls.py を以下のように書き換えます。

config.urls/py

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', TemplateView.as_view(template_name='home.html'), name='home'),
    path('accounts/', include('django.contrib.auth.urls')),
]

http://127.0.0.1:8000/ にアクセスした画面

続いてログイン後のリダイレクト先をhomeに変更します。

config/settings.py

LOGIN_REDIRECT_URL = 'home'

ここまででとりあえず外枠を用意できたイメージです。
次回いよいよfacebook認証に取り掛かっていきます。

【Django】Djangoで開発環境の構築から、django-allauthを使いfacebookでユーザー認証を行うところまでのTips①

前提

プロジェクトの作成

settings.pyを編集する

1.MySQLの設定をする

2.テンプレートを設定する

3.LANGUAGE_CODEとTIME_ZONE

ログイン画面を作る

URLディスパッチャの設定

ビューの設定

テンプレートを用意する