Django筆記

這裏是偏碎片化的記錄，另可參考：Django Unleashed筆記。

建立新專案

django-admin startproject [網站目錄名]

跑伺服器

cd [網站目錄名]; ./manage.py runserver [Port number]

app vs project

app 可以算是一個 project 的功能大分區。但不知道 app 能不能夠共用資料。

Model, View, Url

子結構說明

urls.py - url 網頁路徑傳送門
views.py - 顯示的方式

urls.py 基礎

假設urls.py 的所屬目錄包含 views.py，views.py有user這個函數，我們要傳字串/user/abc 的 abc 當成 user 函數的 username 變數，則可以這樣設定：

from django.contrib import admin
from django.urls import path

from . import views

urlpatterns = [
    path('/users/<slug:username>', views.user),
    path('admin/', admin.site.urls),
]

view.py

處理 POST body 裏的 json

    if request.method == 'POST':
        post_body_orig = request.body.decode('utf-8')
        post_body_json = json.loads(post_body_orig)
        post_text = post_body_json["text"]
        print(f"結果：{post_text}")

回傳 json（ActivityPub 用）

假設要做 ActivityPub協定，回傳 json 的話，可以這樣設定：

from django.http import Http404, HttpResponse
import json

from . import config # import the config variables in the file './config.py'.

def user(request, username):
    user_json = {"@context": "https://www.w3.org/ns/activitystreams",
        "id": config.site_url + "/users/" + username,
        "inbox": config.site_url +  "/users/" + username + "/inbox",
        "outbox": config.site_url + "/users/" + username + "/outbox",
        "type": "Person", # the json for the type
        "name": username , # user name
        } 

    if username != 'John':
        raise Http404() # throw 404
    else:
        # return json file with setting content_type
       return HttpResponse(json.dumps(user_json), content_type="application/activity+json")

如果不是 John，就回傳 Http404()。

model.py

models.DateField儲存日期，models.DateTimeField儲存日期時間。參考：Model field reference。

伺服器類設定

設定Gunicorn（這可能沒有用）

   /etc/systemd/system/gunicorn.service


Group=www-data
WorkingDirectory=/root/lianlok                
ExecStart=/usr/local/bin/gunicorn（或其他絕對路徑） --access-logfile - --workers 3 --bind unix:/run/gunicorn.sock lianlok.wsgi:application
[Install]
WantedBy=multi-user.target

設定 nginx

site-available 裏面的 test 設定檔為：

前提要先 ./manage.py runserver 8080。

server {
listen 80;
server_name 127.0.0.1;

# https://docs.djangoproject.com/en/dev/howto/static-files/#serving-static-files-in-production
# location /static/ { # STATIC_URL
#    alias /home/www/example.com/static/; # STATIC_ROOT
#                  }

    access_log /root/log/lianlok-access.log;
    error_log /root/log/lianlok-error.log;

    location / {
            proxy_set_header Host $host;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Scheme $scheme;
            proxy_pass http://127.0.0.1:8080;
        }
}

setting.py 使用 SQLite

import os

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

使用者管理

用戶的 class

django.contrib.auth 的 User class，實作了相關的欄位（姓、名、密碼等），可以使用。
如果要擴充自定義 User，使用django.contrib.auth.models 的 AbstractBaseUser。

建立登入、登出、註冊帳號畫面

Django筆記(10) - 用戶的登入與登出
Django Tutorial Part 8: User authentication and permissions - MDN 包含申請帳號的頁面
[Django教學8Django UserCreationForm實作網站登入驗證及註冊功能分享] 註冊頁面介紹

佈署 (deploy) Django app

Django筆記/佈署Django專案

參考

關聯條目