django-tutorial

Django 基本教學 - 從無到有 Django-Beginners-Guide，教你建立自己的第一個 Django 程式 📝

Django 非常強大，尤其是 Django REST framework ( DRF )，打造 REST API 極為方便快速，

在這裡先帶大家進入 Django 的世界 😄

教學

請先確認電腦有安裝 Python

接著我們安裝 Django

請在你的命令提示字元 (cmd ) 底下輸入

pip install django

基本上安裝應該沒什麼問題，可以再使用 cmd 確認，如下圖

建立 Django Project

建議直接安裝 PyCharm ，然後新增一個 Django Project

用 PyCharm 建立 project 還有一個好處，就是一些設定會先幚你設定好，不用全部重新自己動手設設定。

執行 Django

直接點選 PyCharm 右上角執行程式 ( 一個是Debug模式 )，如下圖

正常來說，如果沒有任何錯誤，去瀏覽 http://127.0.0.1:8000/ 可以看到下圖，

如果你沒有安裝 PyCharm 或你喜歡下指令，就必須在命令提示字元 (cmd ) 底下輸入

python manage.py runserver

恭喜你~ 成功第一步了 😄

建立 Django App

先建立一個觀念，在 Django 中，通常我們會依照功能去建議一個 App ，例如範例的 musics ，代表他是管理音樂的部份。

有了這個觀念之後，我們動手開始做吧～

請在你的命令提示字元 (cmd ) 底下輸入

python manage.py startapp musics

如果順利執行，你會發現你的專案內多出一個 musics 資料夾

建立完請記得要將 App 加入設定檔

請在 settings.py 裡面的 INSTALLED_APPS 加入 musics (也就是你自己建立的 App 名稱)

Views

請先在 templates 裡面新增一個 hello_django.html ，並在裡面輸入下方程式碼 (下圖)

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    {{data}}
</body>
</html>

hello_django.html 裡面的第 8 行，只是透過 views.py 傳值過來而已。

關於第 8 行的用法，更多可以參考 Django Templates。

接著我們將 views.py 裡面新增下方程式碼 (下圖)

from django.shortcuts import render


# Create your views here.
def hello_view(request):
    return render(request, 'hello_django.html', {
        'data': "Hello Django ",
    })

views.py 裡面的第 7 行，就是回傳給 hello_django.html 的資料。

注意，最後還必須設定 URLconf。

URLconf

請再將 urls.py 裡面增加一些程式碼，如下圖

from django.conf.urls import url
from django.contrib import admin
from musics.views import hello_view

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'^hello/', hello_view),
]

簡單講，就是將 views.py import 進來 (第 18 行)，

並且設定他的 URL (第 22 行)

最後執行 Django ，然後瀏覽 http://127.0.0.1:8000/hello/

你應該會看到如下圖

接下來我們來看 Models

Models

定義出資料庫中的結構（schema），並且透過 Django 中的指令去建立資料庫。

Django 預設是使用 SQLite ，如果想要修改為其他的資料庫，可以在 settings.py 裡面進行修改。

首先，請先在 models.py 裡面增加下方程式碼 (下圖)

from django.db import models


# Create your models here.
class Music(models.Model):
    song = models.TextField(default="song")
    singer = models.TextField(default="AKB48")
    last_modify_date = models.DateTimeField(auto_now=True)
    created = models.DateTimeField(auto_now_add=True)

    class Meta:
        db_table = "music"

default : 代表默認值，也就是如果你沒有指定的話會用默認值。

auto_now_add : 新增時會幚你自動加上建立時間。

auto_now : 資料有更新時會幚你自動加上更新的時間。

更多可以參考 Django fields

接著在命令提示字元 (cmd ) 底下輸入

python manage.py makemigrations

python manage.py migrate

makemigrations ：會幚你建立一個檔案，去記錄你更新了哪些東西。

migrate ：根據 makemigrations 建立的檔案，去更新你的 DATABASE 。

執行完上面的指令之後，

你可以使用SQLiteBrowser 或 PyCharm 觀看 DATABASE，

你會發現多出一個 music 的 table ( 如下圖 )

有沒有注意到我們明明在 models.py 裡面就沒有輸入 id ，可是 database 裡面卻有 id 欄位，

這是因為 Django 預設會幫你帶入，所以可以不用設定。

Django ORM

先了解什麼是 CRUD ，他分別代表 Create, Retrieve, Update, Delete，

Django QuerySet API 可以讓你簡單的處理 CRUD 。

直接使用 Python Console 簡單介紹 Django ORM

記得必須先 import 你的 models

from musics.models import Music

Create

Music.objects.create(song='song1', singer='SKE48')

用SQLiteBrowser 或 PyCharm 觀看 DATABASE，如下圖，成功多了一比資料

或者

Music.objects.create()

為什麼沒帶參數也可以新增呢?

這是因為 models.py 裡的 song 以及 singer 有設定 default ，所以可以不用帶入參數。

Read

Music.objects.all()

Music.objects.get(pk=3)

Music.objects.filter(id=1)

Update

data=Music.objects.filter(id=1)

data.update(song='song_update')

執行完上述程式碼，就會發現資料被更新了 ( 如下圖 )

Delete

data=Music.objects.filter(id=4)

data.delete()

執行完上述程式碼，就會發現資料被刪除了

Admin Site

Django 內建有後台管理介面。

請先確定 settings.py 裡的 INSTALLED_APPS 裡有 django.contrib.admin

INSTALLED_APPS = [
    'django.contrib.admin',
    ......
]

設定 URL

接著使用命令提示字元 (cmd ) 建立超級使用者

python manage.py createsuperuser

註冊 model

我們可以註冊 model，讓後台可以操作 database

請在 admin.py 裡面新增下方程式碼，這段程式碼只是去註冊 model 而已

from django.contrib import admin

# Register your models here.
from django.contrib import admin
from musics.models import Music

admin.site.register(Music)

接著執行 Django ，然後到 http://127.0.0.1:8000/admin/，

應該會看到下圖，我的帳號/密碼設定為 twtrubiks/password123

現在，你可以在裡面對 Musics 執行新增、查詢、修改、刪除 (CRUD)，也可以管理使用者。

恭喜你，基本上到這裡，已經是一個非常簡單的 Django 程式了，趕快動手下去玩玩吧 😛

後記：

我是先接觸 Flask，後來才接觸到 Django ，

有些人一開始應該也會和我一樣覺得 Django 的設定很多，非常麻煩，

但其實了解他之後，會發現他並沒有想像中的那麼複雜，而且功能非常強大。

下一步可以參考更酷更強大的 Django-REST-framework 基本教學 - 從無到有 DRF-Beginners-Guide

執行環境

Python 3.4.3

Reference

Django

License

MIT license

AdleyLu / django-tutorial