Nauczmy się na przykładzie.
\nZ pomocą tego tutoriala przeprowadzimy cię przez stworzenie prostej aplikacji ankietowej.
\nBędzie się ona składać z dwóch części:
\nPublicznej strony, która pozwala ludziom obejrzeć ankiety i głosować w nich.
Panelu administracyjnego, który pozwala ci dodawać, zmieniać i usuwać ankiety.
Będziemy zakładać, że masz już zainstalowane Django. Możesz sprawdzić, czy Django jest zainstalowane i w jakiej wersji uruchamiając następującą komendę w prompcie powłoki (wskazywanym przez prefix $):
\nLinux / macOS
$ python -m django --version\nWindows
...\\> py -m django --version\nJeśli Django jest zainstalowane, powinieneś zobaczyć wersję swojej instalacji. Jeśli nie jest, dostaniesz błąd „No module named django”.
\nTen tutorial jest napisany dla Django 2.1, które wspiera Pythona 3.5 i wyższe. Jeśli wersja Django się nie zgadza, możesz przełączyć się na swoją wersję Django używając przełącznika wersji w prawym dolnym rogu tej strony lub możesz zaktualizować Django do najnowszej wersji. Jeśli używasz starszej wersji Pythona, sprawdź Której wersji Pythona mogę użyć z Django?, aby znaleźć kompatybilną wersję Django.
\nZobacz Jak zainstalować Django, by znaleźć wskazówki jak usunąć stare wersje Django i zainstalować nową.
\n\nJeśli po raz pierwszy korzystasz z Django, będziesz musiał zająć się wstępną konfiguracją. Konkretnie, będziesz potrzebował wygenerować trochę kodu, który stworzy projekt Django – zbiór ustawień dla instacji Django, wliczając konfigurację bazy danych, ustawienia specyficzne dla Django i specyficzne dla aplikacji.
\nZ linii komend, wejdź cd do katalogu, gdzie chciałbyś przechowywać swój kod, następnie uruchom następującą komendę:
Linux / macOS
$ django-admin startproject mysite\nWindows
...\\> django-admin startproject mysite\nStworzy ona katalog mysite w twoim bieżącym katalogu. Jeśli nie zadziałała, zobacz Problemy z uruchomieniem django-admin.
Spójrzmy co stworzyło startproject:
mysite/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n wsgi.py\nTe pliki to:
\nZewnętrzny katalog główny mysite/ jest tylko pojemnikiem na twój projekt. Jego nazwa nie ma znaczenia dla Django; możesz zmienić jego nazwę na dowolną, jaką chcesz.
manage.py: Narzędzie linii komend, które pozwala ci oddziaływać z tym projektem Django na wiele sposobów. Możesz przeczytać szczegóły na temat manage.py w django-admin and manage.py.
Wewnętrzny katalog mysite/ jest właściwym pakietem Pythona dla twojego projektu. Jego nazwa jest nazwą pakietu Pythona, którą musisz używać, aby zaimportować cokolwiek w tym pakiecie (np. mysite.urls).
mysite/__init__.py: Pusty plik, który mówi Pythonowi, że ten katalog powinien być uważany za pakiet Pythona. Jeśli jesteś początkujący w Pythonie, przeczytaj więcej o pakietach w oficjalnej dokumentacji Pythona.
mysite/settings.py: Ustawienia/konfiguracja dla tego projektu Django. Django settings powie ci wszystko o tym, jak działają ustawienia.
mysite/urls.py: Deklaracje URL-i dla tego projektu Django; „spis treści” twojej strony opartej na Django. Możesz przeczytać więcej o URL-ach w URL dispatcher.
mysite/wsgi.py: Punkt wejściowy dla serwerów WWW kompatybilnych z WSGI do serwowania twojego projektu. Zobacz How to deploy with WSGI dla większej ilości szczegółów.
Zweryfikujmy czy twój projekt Django działa. Przejdź do zewnętrzenego katalogu mysite, jeśli jeszcze tego nie zrobiłeś, i uruchom następujące polecenia:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nZobaczysz następujące wyjście w linii komend:
\nPerforming 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 sie 2026 - 15:50:53\nDjango version 2.1, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\n
Wystartowałeś serwer deweloperski Django, lekki web-serwer napisany w całości w Pythonie. Zawarliśmy go w Django, abyś mógł dewelopować rzeczy błyskawicznie, nie musząc zajmować się konfiguracją produkcyjnego serwera – jak na przykład Apache – dopóki nie będziesz gotowy na produkcję.
\nTeraz jest dobry moment, by zwrócić na to uwagę: nie używaj tego serwera w czymkolwiek podobnym do produkcyjnego środowiska. Jest on przewidziany tylko do użytku podczas dewelopmentu. (Jesteśmy w świecie tworzenia web-frameworków, nie web-serwerów.)
\nKiedy serwer jest już uruchomiony, odwiedź http://127.0.0.1:8000/ w swojej przeglądarce internetowej. Zobaczysz stronę „Gratulacje!” ze startującą rakietą. Zadziałało!
\n\n\nTeraz, kiedy twoje środowisko – „projekt” – jest uruchomione, jesteś gotowy zabrać się do pracy.
\nKażda aplikacjia, którą piszesz w Django, składa się z pakietu Pythona, który realizuję pewną konwencję. Django zawiera narzędzie, które automatycznie generuje podstawową strukturę katalogów aplikacji, abyś mógł skupić się na pisaniu kodu zamiast na tworzeniu katalogów.
\n\nTwoje aplikacje mogą żyć gdziekolwiek na twojej ścieżce Pythona. W tym tutorialu stworzymy aplikację ankietową tuż obok twojego pliku manage.py, aby mogła być zaimportowana jako jego własny moduł najwyższego poziomu, zamiast podmodułu mysite.
Aby stworzyć swoją aplikację, upewnij się, że jesteś w tym samym katalogu co manage.py i wpisz tę komendę:
Linux / macOS
$ python manage.py startapp polls\nWindows
...\\> py manage.py startapp polls\nStworzy ona katalog polls, który jest tak rozplanowany:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n views.py\nTa struktora katalogów będzie domem dla aplikacji ankietowej.
\nNapiszmy pierwszy widok. Otwórz plik polls/views.py i umieść tam następujący pythonowy kod:
from django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\nTo jest najprostszy widok, jaki jest możliwy w Django. Aby go wywołać, potrzebujemy zmapować go na URL – i do tego potrzebujemy URLconf.
\nAby stworzyć URLconf w katalogu ankiet, stwórzmy plik o nazwie urls.py. Katalog twojej aplikacji powinien teraz wyglądać tak:
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\nW pliku polls/urls.py zawrzyj następujący kod:
from django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path('', views.index, name='index'),\n]\nNastępnym krokiem jest wskazanie URLconfowi w korzeniu na moduł polls.urls. W mysite/urls.py dodaj import dla django.urls.include i wstaw include() na listę urlpatterns, aby mieć:
from django.contrib import admin\nfrom django.urls import include, path\n\nurlpatterns = [\n path('polls/', include('polls.urls')),\n path('admin/', admin.site.urls),\n]\nFunkcja include() function pozwala na odniesienia do innych URLconfów. Kiedykolwiek Django napotyka include(), odcina tę część URL-a, która została dopasowana do tego punktu i wysyła pozostłą część ciągu znaków do zaincludowanego URLconfa, do dalszego przetworzenia.
Pomysłem leżącym za include() jest ułatwienie podłączania URL-i. Skoro ankiety są w swoim własnym URLconfie (polls/urls.py), mogą być umieszczone pod „/polls/” lub pod „/fun_polls/” lub pod „/content/polls/” lub dowolnym innym początkiem ścieżki i aplikacja wciąż będzie działać.
Podłączyłeś właśnie widok index do URLconf. Zweryfikujmy, czy działa. Uruchom następujące polecenie:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nPrzejdź do http://localhost:8000/polls/ w swojej przeglądarce. Powinieneś zobaczyć napis „Hello, world. You’re at the polls index.”, który zdefiniowałeś w widoku index.
Do funkcji path() są przekazane cztery argumenty, dwa wymagane: route i view oraz dwa opcjonalne: kwargs i name. Warto w tym momencie dowiedzieć się, do czego służą.
path(): routeLink to this heading#route jest ciągiem znaków, który zawiera wzorzec URL. Django zaczyna od pierwszego wzorca i idzie w dół listy, porównując zażądany URL z wszystkimi wzorcami aż odnajdzie taki, który pasuje.
Wzorce nie przeszukują parametrów GET i POST lub nazwy domeny. Na przykład, w żądaniu do https://www.example.com/myapp/, URLconf będzie szukał myapp/. W żądaniu do https://www.example.com/myapp/?page=3, URLconf też będzie szukał myapp/.
path(): viewLink to this heading#Kiedy Django znajdzie pasujący wzorzec, wywołuje podaną funkcję widoku z obiektem HttpRequest jako pierwszym argumentem i dowolnymi „złapanymi” wartościami ze ścieżki jako argumentami nazwanymi. Za chwilę damy tego przykład.
path(): kwargsLink to this heading#Arbitralne argumenty słownikowe mogą być przekazane w słowniku do docelowego widoku. Nie będziemy używać tej funkcjonalności Django w tym tutorialu.
\npath(): nameLink to this heading#Nazwanie twojego URL-a pozwala odwołać się do niego jednoznacznie z każdego miejsca w Django, szczególnie z wnętrza szablonów. Ta potężna cecha pozwala ci na robienie globalnych zmian we wzorcach URL projektu przez zmianę w pojedynczym pliku.
\nJeśli czujesz się dobrze z przepływem żądań i odpowiedzi, przeczytaj drugą część tego tutoriala, aby zacząć pracę z bazą danych.
\n