{"title":"Menulis aplikasi Django pertama anda, bagian 1","version":"1.11","locale":"id","docname":"intro/tutorial01","url":"/id/1.11/intro/tutorial01/","canonical":"https://djangodocs.dev/id/1.11/intro/tutorial01/","summary":"Mari kita belajar berdasarkan contoh. Melalui tutorial ini, kami akan memandu anda melalui pembuatan aplikasi jejak pendapat dasar. Dia akan terdiri dari dua…","html":"

Menulis aplikasi Django pertama anda, bagian 1Link to this heading#

\n

Mari kita belajar berdasarkan contoh.

\n

Melalui tutorial ini, kami akan memandu anda melalui pembuatan aplikasi jejak pendapat dasar.

\n

Dia akan terdiri dari dua bagian:

\n\n

Kami akan beranggapan anda telah mempunyai Django installed. Anda dapat memberitahu Django terpasang dan versi mana dengan menjalankan perintah berikut dalam sebuah shell prompt (ditunjukkan oleh awalan $):

\n
Shell
$ python -m django --version\n
\n

Jika Django telah terpasang, anda harus melihat versi dari pemasangan anda. Jika dia tidak, anda akan mendapatkan kesalahan mengatakan "Tidak ada modul bernama django".

\n

Tutorial ini ditulis untuk Django 1.11 dan Phyton 3.4 atau kemudian. Jika versi DJango tidak cocok, anda dapat mengacu ke tutorial untuk versi Django anda dengan menggunakan pengganti versi di pojok bawah kanan halaman ini, atau perbaharui Django ke versi terbaru. Jika anda masih menggunakan Phyton 2.7, anda akan butuh menyesuaikan sedikit contoh kode , seperti digambarkan di komentar.

\n

Lihat How to install Django untuk saran bagaimana memindahkan versi lama Django dan memasang satu yang baru.

\n\n
\n

Membuat proyekLink to this heading#

\n

Jika ini adalah pertama kali anda menggunakan Django, anda harus berhati-hati dari beberapa pengaturan awal. Yaitu, anda butuh membangkitkan-otomatis beberapa kode yang membangun Django project -- kumpulan dari pengaturan untuk contoh DJango, termasuk konfigurasi basisdata, pilihan khusus-Django dan pengaturan khusus-aplikasi.

\n

Dari baris perintah, cd kedalam direktori dimana anda ingin menyimpan kode anda, lalu jalankan perintah berikut:

\n
Shell
$ django-admin startproject mysite\n
\n

Ini akan membuat direktori mysite di direktori anda saat ini. Jika itu tidak bekerja, lihat Masalah menjalankan django-admin.

\n\n\n

Mari kita lihat seperti apa startproject dibuat:

\n
Code
mysite/\n    manage.py\n    mysite/\n        __init__.py\n        settings.py\n        urls.py\n        wsgi.py\n
\n

Berkas ini adalah:

\n\n
\n
\n

Peladen pengembanganLink to this heading#

\n

Mari kita periksa proyek Django anda bekerja. Perubahan di dalam direktori mysite terluar, jika anda belum siap, dan jalankan perintah berikut:

\n
Shell
$ python manage.py runserver\n
\n

Anda akan melihat keluaran berikut pada baris perintah:

\n
Performing system checks...\n\nSystem check identified no issues (0 silenced).\n\nYou have unapplied migrations; your app may not work properly until they are applied.\nRun 'python manage.py migrate' to apply them.\n\n09 Agu, 2026 - 15:50:53\nDjango version 1.11, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.
\n\n

Anda telah memulai peladen pengembangan Django, peladen Jaringan ringan ditulis murni di Phyton. Kami telah memasukkan ini dengan Django sehingga anda dapat mengembangkan hal dengan cepat, tanpa harus berurusan dengan konfigurasi peladen produksi -- seperti Apache -- sampai anda siap untuk produksi.

\n

Sekarang adalah waktu bagus untuk mencatat jangan gunakan peladen ini dalam menyerupai apapun lingkungan produksi. Ini hanya diperuntukkan untuk digunakan selama pengembangan. (Kami didalam bisnis pembuatan kerangka jaringan, bukan peladen Jaringan.)

\n

Sekarang peladen sedang berjalan, kunjungi http://127.0.0.1:8000/ dengan perambah jaringan anda. Anda akan melihat halaman "Selamat datang ke Django", dalam nyaman, pastel cahaya-bitu. Dia bekerja!

\n\n\n
\n
\n

Membuat aplikasi jejak pendapatLink to this heading#

\n

Sekarang bahwa lingkungan anda -- sebuah "proyek" -- sedang diatur, anda sudah untuk siap memulai pekerjaan.

\n

Setiap aplikasi anda tulis dalam Django terdiri dari paket Phyton yang mengikuti ketentuan tertentu Django datang dengan kegunaan yang otomatis membangkitkan struktur direktori dasar dari sebuah aplikasi, sehingga anda dapat fokus pada menulis kode daripada membuat direktori.

\n\n

Aplikasi anda dapat tinggal dimana saja pada Python path anda. Di tutorial ini, kami akan membuat jejak pendapat kami dekat berkas manage.py anda sehingga itu dapat diimpor sebagai modul tingkat-atas sendiri, daripada submodul dari mysite.

\n

Untuk membuat aplikasi anda, pastikan anda berada di direktori sama sebagai manage.py dan ketik perintah ini:

\n
Shell
$ python manage.py startapp polls\n
\n

Itu akan membuat direktori polls, yang ditata seperti ini:

\n
Code
polls/\n    __init__.py\n    admin.py\n    apps.py\n    migrations/\n        __init__.py\n    models.py\n    tests.py\n    views.py\n
\n

Struktur direktori ini akan merumahkan aplikasi jejak pendapat.

\n
\n
\n

Tulis tampilan pertama andaLink to this heading#

\n

Mari kita menulis tampilan pertama. Buka berkas polls/views.py dan taruh kode Phyton berikut didalamnya:

\n
polls/views.py
Code
from django.http import HttpResponse\n\n\ndef index(request):\n    return HttpResponse("Hello, world. You're at the polls index.")\n
\n

Ini adalah kemungkinan tampilan sederhana di Django. Untuk memanggil tampilan, kami butuh memetakannya ke URL - dan untuk ini kami butuh URLconf.

\n

Untuk membuat URLconf dalam direktori jejak pendapat, buat berkas disebut urls.py. Direktori aplikasi anda seharusnya kelihatan seperti:

\n
Code
polls/\n    __init__.py\n    admin.py\n    apps.py\n    migrations/\n        __init__.py\n    models.py\n    tests.py\n    urls.py\n    views.py\n
\n

Di berkas polls/urls.py sertakan kode berikut:

\n
polls/urls.py
Code
from django.conf.urls import url\n\nfrom . import views\n\nurlpatterns = [\n    url(r'^$', views.index, name='index'),\n]\n
\n

Langkah selanjutnya adalah menunjuk akar URLconf pada modul polls.urls. Dalam mysite/urls.py, tambahkan impor untuk django.conf.urls.include dan masukkan sebuah include() di daftar urlpatterns, jadi anda mempunyai:

\n
mysite/urls.py
Code
from django.conf.urls import include, url\nfrom django.contrib import admin\n\nurlpatterns = [\n    url(r'^polls/', include('polls.urls')),\n    url(r'^admin/', admin.site.urls),\n]\n
\n

Fungsi include() mengizinkan memberi petunjuk URLconf lain. Catat bahwa regular expression untuk fungsi include() tidak mempunyai sebuah $ (karakter cocok end-of-string) tetapi daripada garis miring. Kapanpun Django menjumpai include(), dia memotong apapun bagian dari URL dicocokkan ke titik itu dan mengirim deretan karakter tersisi ke URLconf disertakan untuk pengolahan lebih lanjut.

\n

Ide dibelakang include() adalah membuatnya mudah untuk pasang-dan-main URL. Sejak jejak pendapat berada di URLconf sendiri (polls/urls.py), mereka dapat ditempatkan dibawah "/polls/", atau dibawah "/fun_polls/", atau dibawah "/content/polls/", atau jalur akar lain, dan aplikasi akan masih bekerja.

\n\n\n

Anda sekarang telah mengikat sebuah tampilan index kedalam URLconf. Mari kita periksa dia bekerja, jalankan perintah berikut:

\n
Shell
$ python manage.py runserver\n
\n

Pergi ke http://localhost:8000/polls/ di perambah anda, dan anda seharusnya melihat teks "Halo, dunia. Anda sedang berada di index jejak pendapat.", yang anda tentukan di tampilan index.

\n

Fungsi url() dilewati empat argumen, dua wajib: regex dan view, dan dua pilihan: kwargs, and name. Pada titik ini, sangatlah bernilai meninjau kembali untuk apa argumen ini.

\n
\n

url() argument: regexLink to this heading#

\n

Istilah "regex" adalah umum digunakan bentuk pendek berarti "regular expression", yang merupakan sintaksis untuk corak pencocokan di deretan karakter, atau di kasus ini, corak url. Django memulai regular expression pertama dan membuatnya turun ke bawah, membandingkan URL diminta terhadap setiap regular expression sampai dia menemukan satu yang cocok.

\n

Catat bahwa regular expression ini tidak mencari parameter GET dan POST, atai nama ranah. Sebagai contoh, di permintaan ke https://www.example.com/myapp/, URLconf akan mencari myapp/. Di permintaan ke https://www.example.com/myapp/?page=3, URLconf akan juga mencari untuk myapp/.

\n

Jika anda butuh bantuan dengan regular expression, lihat masukan Wikipedia dan dokumentasi dari modul re. Juga, buku O'Reilly "Mastering Regular Expressions" oleh Jeffrey Friedl sungguh hebat. Dalam praktiknya, bagaimanapun, anda tidak butuh menjadi ahli di regular expression, anda hanya butuh mengetahui bagaimana mengambil corak sederhana. Faktanya, regular expression rumit dapat mempunyai penampilan pencarian buruk, jadi anda mungkin jangan bergantung pada kekuatan penuh dari regex.

\n

Akhirnya, catatan penampilan: regular expression ini disusun pertama kali modul URLconf dimuat. Mereka sangat cepat (selama pencarian tidak terlalu rumit seperti catatan diatas).

\n
\n
\n

Tampilan url() argument:Link to this heading#

\n

Ketika Django menemukan kecocokan regular expression, Django memanggil fungsi tampilan yang ditentukan dengan obyek HttpRequest sebagai argumen pertama dan nilai "tertangkap" apapun dari regular expression sebagai argumen lain. Jika regex menggunakan penangkapan sederhana, nilai dilewatkan sebagai argumen penempatan; jika dia menggunakan penangkapan nama, nilai dilewatkan sebagai argumen kata kunci. Kami akan memberikan sebuah contoh dari ini sedikit.

\n
\n
\n

url() argument: kwargsLink to this heading#

\n

Argumen kata kunci yang berubah-ubah dapat dilewatkan di kamus ke tampilan sasaran. Kami tidak akan menggunakan fitur Django ini di tutorial ini.

\n
\n
\n

url() argument: nameLink to this heading#

\n

Menamai URL anda membiarkan anda menunjuk ke kejelasannya dari di tempat lain di Django, khususnya dari dalam cetakan. Fitur kuat ini mengizinkan anda membuat perubahan global pada corak URL dari proyek anda selagi hanya menyentuh berkas tunggal.

\n

Ketika anda nyaman dengan permintaan dasar dan aliran tanggapan, baca bagian 2 dari tutorial ini utuk memulai bekerja dengan basisdata.

\n
\n
","rootId":"writing-your-first-django-app-part-1","toc":[{"title":"Membuat proyek","anchor":"creating-a-project","children":[]},{"title":"Peladen pengembangan","anchor":"the-development-server","children":[]},{"title":"Membuat aplikasi jejak pendapat","anchor":"creating-the-polls-app","children":[]},{"title":"Tulis tampilan pertama anda","anchor":"write-your-first-view","children":[{"title":"url() argument: regex","anchor":"url-argument-regex","children":[]},{"title":"Tampilan url() argument:","anchor":"url-argument-view","children":[]},{"title":"url() argument: kwargs","anchor":"url-argument-kwargs","children":[]},{"title":"url() argument: name","anchor":"url-argument-name","children":[]}]}],"breadcrumbs":[{"docname":"intro/index","title":"Mulai","url":"/id/1.11/intro/"}],"prev":{"docname":"intro/install","title":"Panduan pasang cepat","url":"/id/1.11/intro/install/"},"next":{"docname":"intro/tutorial02","title":"Menulis aplikasi Django kedua anda, bagian 2","url":"/id/1.11/intro/tutorial02/"},"formats":{"html":"/id/1.11/intro/tutorial01/","markdown":"/id/1.11/intro/tutorial01.md","json":"/id/1.11/intro/tutorial01.json"},"source":"https://github.com/django/django/blob/stable/1.11.x/docs/intro/tutorial01.txt","official":"https://docs.djangoproject.com/id/1.11/intro/tutorial01/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","fr","ja","id","pt-br","ko","es","el","pl"]}