Một project Django gồm nhiều app, mỗi app đảm nhận một chức năng (thành viên, bài viết, đơn hàng). Bài này tạo project, chạy máy chủ phát triển và tạo app đầu tiên.

40 phútCơ bản
Bạn sẽ học được
  • Tạo project bằng django-admin
  • Chạy runserver
  • Tạo app và đăng ký vào settings
  • Hiểu cấu trúc thư mục

Cơ sở lý thuyết

Django phân biệt project và app:

Khái niệmÝ nghĩaVí dụ
ProjectToàn bộ website: cấu hình chung, danh sách app, URL gốcCổng thông tin trường
AppGói chức năng độc lập, tái sử dụng được giữa các projecttuyen_sinh, tin_tuc, thu_vien
  • Kiến trúc MTV (Model–Template–View) của Django tương ứng MVC: Model là dữ liệu, Template là giao diện, View đóng vai trò Controller (xử lý yêu cầu); phần "C" thực chất do bộ định tuyến URL của framework đảm nhận.
  • settings.py: INSTALLED_APPS, DATABASES, TEMPLATES, STATIC, ngôn ngữ, múi giờ. Thông tin bí mật (SECRET_KEY, mật khẩu CSDL) nên đọc từ biến môi trường.
  • manage.py: công cụ dòng lệnh của project (runserver, makemigrations, migrate, createsuperuser, shell).
  • Một app thường có: models.py, views.py, urls.py, admin.py, tests.py, templates/, migrations/.
  • Nguyên tắc gắn kết cao, phụ thuộc thấp: mỗi app làm tốt một việc.

Tạo project và app

django-admin startproject my_tennis_club
cd my_tennis_club
python manage.py runserver        # mở http://127.0.0.1:8000
python manage.py startapp members

Cấu trúc

TệpVai trò
manage.pyCông cụ dòng lệnh của dự án
my_tennis_club/settings.pyCấu hình: app, CSDL, ngôn ngữ, múi giờ
my_tennis_club/urls.pyBảng định tuyến gốc
members/models.pyModel của app
members/views.pyView của app
members/admin.pyĐăng ký model vào trang Admin

Đăng ký app và tiếng Việt

# settings.py
INSTALLED_APPS = [
    "django.contrib.admin",
    # ...
    "members",
]
LANGUAGE_CODE = "vi"
TIME_ZONE = "Asia/Ho_Chi_Minh"

Ứng dụng thực tế

Bài toán: xây dựng cổng thông tin khoa gồm tin tức và quản lý đồ án tốt nghiệp – chia thành hai app độc lập, cấu hình tiếng Việt và giờ Việt Nam:

django-admin startproject cong_khoa .
python manage.py startapp tin_tuc
python manage.py startapp do_an
python manage.py runserver           # http://127.0.0.1:8000
# cong_khoa/settings.py
import os
SECRET_KEY = os.environ.get("DJANGO_SECRET_KEY", "chi-dung-khi-phat-trien")
DEBUG = os.environ.get("DJANGO_DEBUG", "1") == "1"
INSTALLED_APPS = [
    "django.contrib.admin", "django.contrib.auth", "django.contrib.contenttypes",
    "django.contrib.sessions", "django.contrib.messages", "django.contrib.staticfiles",
    "tin_tuc", "do_an",
]
LANGUAGE_CODE = "vi"
TIME_ZONE = "Asia/Ho_Chi_Minh"
USE_TZ = True                        # lưu giờ UTC trong CSDL, hiển thị theo giờ Việt Nam
Thực hành
  1. Tạo project my_tennis_club và chạy thử.
  2. Tạo app members, đăng ký vào INSTALLED_APPS.
  3. Đổi LANGUAGE_CODE thành vi, xem trang chào mừng tiếng Việt.
Tóm tắt bài học
  • Project chứa nhiều app.
  • manage.py runserver chạy máy chủ phát triển.
  • Đăng ký app trong INSTALLED_APPS.