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.
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ĩa | Ví dụ |
|---|---|---|
| Project | Toàn bộ website: cấu hình chung, danh sách app, URL gốc | Cổng thông tin trường |
| App | Gói chức năng độc lập, tái sử dụng được giữa các project | tuyen_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 membersCấu trúc
| Tệp | Vai trò |
|---|---|
| manage.py | Công cụ dòng lệnh của dự án |
| my_tennis_club/settings.py | Cấu hình: app, CSDL, ngôn ngữ, múi giờ |
| my_tennis_club/urls.py | Bảng định tuyến gốc |
| members/models.py | Model của app |
| members/views.py | View 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 NamThực hành
- Tạo project my_tennis_club và chạy thử.
- Tạo app members, đăng ký vào INSTALLED_APPS.
- Đổ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.

