Panduan Memulai Django: Membangun Aplikasi Web Pertama Anda dengan Cepat

Django adalah framework Web Python tingkat tinggi, yang bertujuan untuk pengembangan cepat dan desain yang bersih. Ia mengikuti arsitektur Model-Template-View (MTV), mendorong penggunaan kembali kode dan modularitas. Panduan ini akan memandu Anda langkah demi langkah untuk membuat aplikasi Django sederhana, memungkinkan Anda untuk memulai dengan cepat.

1. Pengaturan Lingkungan

Pertama, Anda perlu memastikan bahwa Python terinstal di sistem Anda. Django merekomendasikan penggunaan Python 3.6 atau versi yang lebih baru.

1.1 Instalasi Python

Jika sistem Anda belum menginstal Python, Anda dapat mengunduh dan menginstalnya dari Situs Web Python.

1.2 Membuat Lingkungan Virtual (Virtual Environment)

Untuk mengisolasi dependensi antar proyek yang berbeda, sangat disarankan untuk menggunakan lingkungan virtual.

Buka terminal atau command prompt.
Buat direktori proyek, misalnya myproject:
```
mkdir myproject
cd myproject
```
Buat dan aktifkan lingkungan virtual:
```
python3 -m venv venv  # Atau python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate  # Windows
```
Setelah mengaktifkan lingkungan virtual, prompt terminal Anda akan menampilkan (venv), yang menunjukkan bahwa Anda menggunakan lingkungan virtual.

1.3 Instalasi Django

Di lingkungan virtual yang aktif, gunakan pip untuk menginstal Django:

pip install Django

Verifikasi apakah instalasi berhasil:

python -m django --version

Anda seharusnya dapat melihat nomor versi Django.

2. Membuat Proyek Django

Setelah menginstal Django, Anda dapat membuat proyek Django baru.

Masih di direktori proyek Anda (myproject), jalankan perintah berikut:
```
django-admin startproject mysite
```
Ini akan membuat direktori bernama mysite di direktori myproject, yang berisi file kerangka proyek Django.
Masuk ke direktori mysite:
```
cd mysite
```
Struktur direktori proyek Django adalah sebagai berikut:
```
mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py
```
- manage.py: Alat baris perintah untuk mengelola proyek Django.
- mysite/: Paket Python yang berisi konfigurasi proyek.
  - __init__.py: File kosong yang memberi tahu Python bahwa direktori ini harus diperlakukan sebagai paket Python.
  - settings.py: File konfigurasi proyek, seperti pengaturan database, mode debug, dll.
  - urls.py: Konfigurasi perutean URL, memetakan URL ke fungsi tampilan.
  - asgi.py: File konfigurasi ASGI (Asynchronous Server Gateway Interface), digunakan untuk menerapkan aplikasi asinkron.
  - wsgi.py: File konfigurasi WSGI (Web Server Gateway Interface), digunakan untuk menerapkan aplikasi sinkron tradisional.## 3. Memulai Server Pengembangan

Django dilengkapi dengan server pengembangan ringan yang memudahkan Anda untuk mengembangkan dan menguji secara lokal.

Di direktori mysite, jalankan perintah berikut:
```
python manage.py runserver
```
Buka browser Anda, kunjungi http://127.0.0.1:8000/. Anda seharusnya melihat halaman "It worked! Congratulations on your first Django-powered page.".

4. Membuat Aplikasi Django

Sebuah proyek Django dapat berisi beberapa aplikasi. Mari kita buat aplikasi bernama myapp.

Buka jendela terminal baru (pertahankan server pengembangan tetap berjalan).
Di direktori mysite, jalankan perintah berikut:
```
python manage.py startapp myapp
```
Ini akan membuat direktori bernama myapp di direktori mysite, yang berisi kerangka file aplikasi Django.
Struktur direktori aplikasi Django adalah sebagai berikut:
```
myapp/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py
```
- __init__.py: File kosong yang memberi tahu Python bahwa direktori ini harus diperlakukan sebagai paket Python.
- admin.py: Digunakan untuk mengonfigurasi backend admin Django.
- apps.py: Konfigurasi aplikasi.
- migrations/: Digunakan untuk mengelola migrasi database.
- models.py: Mendefinisikan model data (tabel database).
- tests.py: Menulis kasus pengujian.
- views.py: Mendefinisikan fungsi tampilan, menangani permintaan dan mengembalikan respons.

Di mysite/settings.py, tambahkan myapp ke daftar INSTALLED_APPS:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'myapp',  # Tambahkan myapp
]

5. Membuat Tampilan Sederhana

Sekarang kita akan membuat tampilan sederhana untuk menampilkan "Hello, Django!" di browser.

Edit file myapp/views.py, tambahkan kode berikut:

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, Django!")

Buat file myapp/urls.py, dan petakan URL ke fungsi tampilan:```python from django.urls import path from . import views

urlpatterns = [ path('', views.index, name='index'), ]

Sertakan myapp/urls.py ke dalam mysite/urls.py:

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

urlpatterns = [
    path('admin/', admin.site.urls),
    path('myapp/', include('myapp.urls')),  # Tambahkan konfigurasi URL myapp
]

Akses http://127.0.0.1:8000/myapp/. Anda seharusnya melihat halaman "Hello, Django!".

6. Membuat Sebuah Model

Mari kita buat sebuah model sederhana untuk menyimpan beberapa data.

Edit file myapp/models.py, tambahkan kode berikut:

from django.db import models

class Question(models.Model):
    question_text = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')

    def __str__(self):
        return self.question_text

Ini mendefinisikan sebuah model bernama Question, yang berisi dua field: question_text (CharField) dan pub_date (DateTimeField).

Buat dan terapkan migrasi database:
```
python manage.py makemigrations myapp
python manage.py migrate
```
Perintah makemigrations akan membuat file migrasi berdasarkan model Anda, perintah migrate akan menerapkan migrasi ke database.

7. Menggunakan Admin Backend Django

Django menyediakan admin backend yang kuat, yang dapat dengan mudah mengelola data Anda.

Buat pengguna super:
```
python manage.py createsuperuser
```
Ikuti petunjuk untuk memasukkan nama pengguna, email, dan kata sandi.

Edit file myapp/admin.py, daftarkan model Question:

from django.contrib import admin
from .models import Question

admin.site.register(Question)

Akses http://127.0.0.1:8000/admin/, gunakan pengguna super yang Anda buat untuk login. Anda seharusnya melihat modul "Questions", yang dapat menambah, mengedit, dan menghapus pertanyaan.

8. Menggunakan Template

Menggunakan template dapat menghasilkan halaman HTML dengan lebih fleksibel.

Di direktori myapp, buat direktori bernama templates, dan di direktori templates, buat direktori bernama myapp ( myapp/templates/myapp ).
Di direktori myapp/templates/myapp, buat file bernama index.html, tambahkan kode berikut:
```
    Hello, Django!


    The current time is: {{ current_time }}
```

Edit file myapp/views.py, gunakan template:

from django.shortcuts import render
import datetime

def index(request):
    now = datetime.datetime.now()
    return render(request, 'myapp/index.html', {'current_time': now})

Fungsi render akan memuat template, dan meneruskan data ke template untuk dirender.

Kunjungi kembali http://127.0.0.1:8000/myapp/. Anda seharusnya dapat melihat halaman yang berisi waktu saat ini.

9. Kesimpulan

Melalui panduan ini, Anda telah memahami konsep dasar dan cara menggunakan Django, termasuk pengaturan lingkungan, membuat proyek dan aplikasi, mendefinisikan model, membuat tampilan, dan menggunakan template. Ini hanyalah permulaan, Django menyediakan fitur yang kaya, Anda dapat terus belajar dan menjelajah, membangun aplikasi Web yang lebih kompleks.