Ο μόνος τρόπος να μάθετε να γράφετε Django apps (εφαρμογές) και γενικά να δουλεύετε με το Django είναι μέσα από παραδείγματα.
\nΜέσα από αυτόν τον οδηγό, θα φτιάξουμε παρέα μία απλή εφαρμογή (application) ψηφοφορίας (poll app). Κάθε ερώτηση θα απαρτίζεται από ένα σετ απαντήσεων, από τις οποίες ο χρήστης θα μπορεί να επιλέξει μία κάθε φορά.
\nΗ εφαρμογή θα αποτελείται από δύο μέρη:
\nΈνα κοινό-δημόσιο site που θα επιτρέπει στους χρήστες να βλέπουν τις διαθέσιμες ψηφοφορίες (γκάλοπ, αν προτιμάτε) και να ψηφίζουν.
Ένα διαχειριστικό (admin) site το οποίο θα επιτρέπει σε εσάς (που θα είστε ο διαχειριστής) να προσθέτετε νέες, να αλλάζετε ήδη υπάρχουσες αλλά και να διαγράφετε ψηφοφορίες.
Υποθέτουμε ότι έχετε ήδη εγκαταστήσει το Django στον υπολογιστή σας. Μπορείτε να δείτε αν το Django έχει εγκατασταθεί (και αν ναι, ποια έκδοση διαθέτετε) πληκτρολογώντας στην κονσόλα (γραμμή εντολών):
\n$ python -m django --version\nΑν το Django είναι εγκατεστημένο, θα δείτε την έκδοση του. Αν δεν είναι, θα δείτε ένα σφάλμα λέγοντας σας ότι “δεν υπάρχει κάποιο module με το όνομα django” (no module named django).
\nΑυτός ο οδηγός έχει γραφτεί χρησιμοποιώντας την έκδοση 1.10 του Django και με την Python 3.4 ή μεγαλύτερη. Αν η δική σας έκδοση του Django δεν ταιριάζει με την παρούσα, μπορείτε να ανατρέξετε στον αντίστοιχο οδηγό της δικής σας έκδοσης (κάτω δεξιά επιλέγετε έκδοση), ή να αναβαθμίσετε την εγκατεστημένη σας έκδοση του Django στην τρέχουσα σταθερή έκδοση. Αν χρησιμοποιείτε ακόμη την Python 2.7, θα χρειαστεί να κάνετε μερικές αλλαγές στον κώδικα (όπως φαίνεται στα σχόλια) για να λειτουργήσει όπως πρέπει.
\nΔείτε See πως να εγκαταστήσετε το Django για συμβουλές απεγκατάστασης τυχόν παλιών εκδόσεων και εγκατάστασης της καινούργιας.
\n\nΑν αυτή είναι η πρώτη φορά που χρησιμοποιείτε το Django, θα χρειαστεί να ρυθμίσετε κάποια πράγματα στην αρχή. Θυμηθείτε ότι οι σωστές βάσεις δημιουργούν σταθερά σπίτια. Πιο συγκεκριμένα, θα χρειαστεί να τρέξετε μια Django εντολή η οποία θα δημιουργήσει αυτόματα ένα Django project – το οποίο δεν είναι τίποτε άλλο παρά ένας φάκελος (μια συλλογή από ρυθμίσεις, αν θέλετε) που περιέχει διάφορα αρχεία, όπως ρυθμίσεις της βάσης δεδομένων, διάφορες επιλογές του Django και ρυθμίσεις που αφορούν το application σας. Αν μπερδευτήκατε, μην ανησυχείτε, θα διαλευκανθούν όλα καθώς προχωράμε στον οδηγό.
\nΑπό κονσόλα τρέξτε την εντολή, cd και τον φάκελο που θα θέλατε να αποθηκευτεί το Django project σας. Μετά τρέξτε την ακόλουθη εντολή:
$ django-admin startproject mysite\nΣυγχαρητήρια! Μόλις δημιουργήσατε το πρώτο σας Django project. Αυτή η εντολή θα δημιουργήσει αυτόματα (μέσα στον φάκελο που κάνατε cd) ένα φάκελο με το όνομα mysite. Αν δεν δούλεψε, δείτε στα προβλήματα τρέχοντας το django-admin.
Ας δούμε τώρα τι δημιούργησε η εντολή startproject:
mysite/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n wsgi.py\nΑυτά τα αρχεία είναι:
\nΟ φάκελος mysite/ είναι ο root φάκελος του project σας. Το όνομα του δεν ενδιαφέρει το Django. Μπορείτε να το μετονομάσετε όπως θέλετε (είναι το όνομα που δώσατε στην εντολή django-admin startproject).
manage.py: Αυτό το αρχείο αποτελεί εντολή (κονσόλας) την οποία μπορείτε να χρησιμοποιήσετε (και θα το κάνετε) για να αλληλεπιδράτε με το project σας για διάφορους λόγους (π.χ δημιουργία πινάκων στη database, εκκίνηση του προ-εγκατεστημένου server κλπ). Μπορείτε να διαβάσετε όλες τις λεπτομέρειες σχετικά με το αρχείο manage.py στο django-admin and manage.py.
Ο εσωτερικός φάκελος mysite/ είναι ένα τυπικό Python package για το project σας. Το όνομα του (έχει σημασία) θα το χρησιμοποιήσετε για να κάνετε import οτιδήποτε σε άλλα Python packages (π.χ import mysite.urls).
mysite/__init__.py: Ένα κενό αρχείο που λέει στην Python ότι αυτός ο φάκελος θα πρέπει να θεωρηθεί ως Python package. Αν είστε καινούργιος στην Python, διαβάστε περισσότερα σχετικά με τα packages στην επίσημη ιστοσελίδα της Python.
mysite/settings.py: Ένα αρχείο που κρατά όλες τις ρυθμίσεις/παραμέτρους για αυτό το Django project (είναι η καρδιά ενός project). Το άρθρο Django settings θα σας εξηγήσει όλα όσα χρειάζεστε σχετικά με το πως δουλεύουν οι ρυθμίσεις αυτές.
mysite/urls.py: Το αρχείο αυτό κρατά τους ορισμούς των URLs για αυτό το project. Με άλλα λόγια είναι ένας «πίνακας περιεχομένων» του Django site σας. Μπορείτε να διαβάστε περισσότερα για τα URLs στο άρθρο URL dispatcher.
mysite/wsgi.py: Αυτό το αρχείο αποτελεί ένα σημείο εισόδου για τους Web servers οι οποίοι είναι συμβατοί με το WSGI specification. Δείτε περισσότερα στο άρθρο πως να δουλέψω με το WSGI για περισσότερες λεπτομέρειες.
Τώρα που δημιουργήσαμε ένα Django project, θα πρέπει να σιγουρευτούμε ότι λειτουργεί. Από κονσόλα (γραμμή εντολών) μεταβείτε στο root φάκελο του project σας (mysite) και τρέξτε την ακόλουθη εντολή:
$ python manage.py runserver\nΘα δείτε την ακόλουθη έξοδο, στη κονσόλα:
\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 Αυγούστου 2026 - 15:50:53\nDjango version 1.10, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\n
Μόλις εκκινήσατε τον Django development server, ένας ελαφρύς Web server γραμμένος αμιγώς σε Python. Συμπεριλάβαμε αυτή τη λειτουργία στο Django για να βλέπετε και να αναπτύσσετε το project σας γρήγορα, χωρίς να χρειαστεί να ασχολείστε με ρυθμίσεις του production server (όπως ο Apache), μέχρις ότου φθάσετε στο σημείο και ανεβάσετε το site σας στο internet.
\nΤώρα είναι ένα καλό σημείο να σημειωθεί το εξής: ποτέ μα ποτέ μην χρησιμοποιήσετε αυτό τον server (Django developemnt server) σε παραγωγικό περιβάλλον (production environment). Έχει σχεδιαστεί αποκλειστικά για αναπτυξιακούς λόγους (δηλαδή μόνο για να τρέχει τοπικά στον υπολογιστή σας). Εξάλλου εμείς ασχολούμαστε με τη δημιουργία Web frameworks και όχι Web servers.
\nΤώρα που ο server τρέχει, επισκεφτείτε τη διεύθυνση http://127.0.0.1:8000/ με τον αγαπημένο σας περιηγητή (firefox, chrome κλπ). Θα δείτε μια σελίδα με ένα μήνυμα καλωσορίσματος από το Django σε ανοιχτά μπλε χρώματα. Συγχαρητήρια, δούλεψε!
\n\n\nΤώρα που το περιβάλλον εργασίας σας – το «project» – είναι έτοιμο, μπορείτε να ξεκινήσετε να δημιουργείτε.
\nΚάθε application που γράφετε στο Django αποτελείται από ένα Python package (ένας φάκελος που περιέχει το αρχείο __init__.py) το οποίο πρέπει να ακολουθεί ορισμένους κανόνες. Για άλλη μια φορά, το Django σας παρέχει την ανάλογη εντολή για να δημιουργήσετε αυτόματα τη δομή αυτού του φακέλου (Python package) ούτως ώστε να επικεντρωθείτε στο να γράψετε κώδικα παρά στο να δημιουργείτε φακέλους και υποφακέλους.
Τα apps σας μπορούν να βρίσκονται οπουδήποτε ορίζει το Python path σας. Σε αυτό τον οδηγό, θα δημιουργήσουμε το app ψηφοφορίας (το φάκελο δηλαδή) στην ίδια θέση που βρίσκεται και το αρχείο manage.py προκειμένου να μπορεί να γίνει imported ως ένα δικό του top-level module, παρά ένα submodule του mysite. Θα καταλάβετε τι εννοούμε με αυτό στη συνέχεια.
Για να δημιουργήσετε το app, σιγουρευτείτε ότι βρίσκεστε στο ίδιο επίπεδο με το αρχείο manage.py και πληκτρολογήστε την εντολή:
$ python manage.py startapp polls\nΣυγχαρητήρια και πάλι! Μόλις φτιάξατε την πρώτη σας εφαρμογή στο Django. Βέβαια δεν κάνει τίποτα ακόμα αλλά θα φτάσουμε και εκεί. Η εντολή θα δημιουργήσει ένα φάκελο polls, ο οποίος αναπτύσσεται ως εξής:
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Ας γράψουμε το πρώτο μας view. Ανοίξτε το αρχείο polls/views.py και γράψτε τον ακόλουθο Python κώδικα:
polls/views.pyfrom django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\nΑυτή είναι η πιο απλή μορφή view στο Django. Για να καλέσετε το view, θα πρέπει να το συσχετίσουμε με ένα URL - και γι” αυτό θα χρειαστούμε ένα URLconf.
\nΓια τη δημιουργία του URLconf στον φάκελο polls, δημιουργήστε ένα αρχείο με το όνομα urls.py. Ο φάκελος της εφαρμογής σας θα πρέπει να δείχνει έτσι:
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Μέσα στο αρχείο polls/urls.py συμπεριλάβετε τον παρακάτω κώδικα:
polls/urls.pyfrom django.conf.urls import url\n\nfrom . import views\n\nurlpatterns = [\n url(r'^$', views.index, name='index'),\n]\nΤο επόμενο βήμα είναι να συσχετίσουμε το URLconf που υπάρχει στο φάκελο mysite του project μας (mysite/mysite/urls.py) με αυτό που υπάρχει στο polls app (mysite/polls/urls.py). Στο αρχείο mysite/urls.py, προσθέστε ένα import για το django.conf.urls.include και προσθέστε τη συνάρτηση include() μέσα στην λίστα urlpatterns. Δηλαδή:
mysite/urls.pyfrom 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Η συνάρτηση include() επιτρέπει να αναφερθούμε σε άλλα URLconfs. Σημειώστε ότι τα regular expressions για τη συνάρτηση include() δεν περιέχουν το $ (ταίριασμα του τέλους ενός string) αλλά μία καταληκτική κάθετο (/). Οποτεδήποτε το Django συναντήσει τη συνάρτηση include(), κόβει το κομμάτι (από ολόκληρο το URL που ζητήθηκε) που έχει ταιριάξει μέχρι τώρα και στέλνει το υπόλοιπο στο περιλαμβανόμενο URLconf για περαιτέρω επεξεργασία.
Η ιδέα πίσω από την include() είναι να κάνουμε εύκολη τη σύνδεση και άμεση λειτουργία (plug-and-play) των URLs. Εφόσον οι ψηφοφορίες έχουν το δικό τους URLconf (polls/urls.py), τότε το URL που θα οδηγεί σε αυτές μπορεί να είναι το «/polls/», ή το «/fun_polls/», ή «/content/polls/» ή οτιδήποτε άλλο νομίζετε. Ότι και να χρησιμοποιήσετε το app σας θα λειτουργεί!
Τώρα έχετε συνδέσει την index view με το URLconf. Ας επιβεβαιώσουμε ότι όλα λειτουργούν, τρέχοντας τον development server:
$ python manage.py runserver\nΕπισκεφτείτε την σελίδα http://localhost:8000/polls/ με τον browser σας και θα πρέπει να δείτε το κείμενο «Hello, world. You’re at the polls index.», το οποίο γράψαμε στην index view.
Η συνάρτηση url() δέχεται τέσσερα ορίσματα (arguments), δύο από τα οποία είναι απαραίτητα: το regex και το view, ενώ τα άλλα δύο είναι προαιρετικά: τα kwargs και το name.\nΣε αυτό το σημείο αξίζει να αναφερθούμε σε καθένα από αυτά τα ορίσματα καθώς είναι πολύ σημαντικά.
url() argument: regexLink to this heading#Ο όρος «regex» αναφέρεται συνήθως ως αρκτικόλεξο του «regular expression»,\nτο οποίο είναι ένα είδους συντακτικό για ταίριασμα χαρακτήρων μέσα σε strings ή στην προκειμένη περίπτωση για ταίριασμα url μοτίβων (url patterns). Το Django ξεκινά να διαβάζει με τη σειρά όλα τα regexes ξεκινώντας από το πρώτο, συγκρίνοντας το ζητούμενο URL (π.χ ο χρήστης έβαλε στη γραμμή διευθύνσεων το http://www.example.com/info/contact) με κάθε regular expression μέχρι να βρει ένα που να ταιριάζει.
Σημειώστε ότι αυτά τα regular expressions δεν ψάχνουν σε GET ή POST παραμέτρους ή στο domain name. Για παράδειγμα, για ένα request στο https://www.example.com/myapp/, το URLconf θα κοιτάξει στο myapp/. Για ένα request στο https://www.example.com/myapp/?page=3, το URLconf θα κοιτάξει, επίσης, στο myapp/.
Αν χρειάζεστε βοήθεια με τα regular expressions, δείτε το άρθρο στο Wikipedia και το εγχειρίδιο (documentation) στο module re της Python. Επίσης, το βιβλίο των εκδόσεων O’Reilly με τον τίτλο «Mastering Regular Expressions» από τον Jeffrey Friedl είναι κάτι παραπάνω από φανταστικό. Στην πράξη, ωστόσο, δεν χρειάζεται να είστε ειδήμων στις regular expressions, καθώς το πιο συνήθες πράγμα που θα κάνετε είναι να αιχμαλωτίζετε απλά μοτίβα. Στην πραγματικότητα, οι πολύπλοκες regexes μπορούν να επιδράσουν αρνητικά στην επίδοση του ψαξίματος για το αντίστοιχο URL. Οπότε, το πιο πιθανό είναι ότι δεν θα χρειαστείτε όλη τη δύναμη των regexes.
Για το τέλος, μια σημείωση σχετικά με την επίδοση: αυτά τα regular expressions μεταγλωττίζονται (compiled) την πρώτη φορά που το URLconf module φορτώνεται. Αυτό τα καθιστά εξαιρετικά γρήγορα από άποψη ταχύτητας (εφόσον τα μοτίβα δεν είναι περίπλοκα, όπως αναφέρθηκε παραπάνω).
\nurl() argument: viewLink to this heading#Όταν το Django βρει καποιο regular expression που να ταιριάζει με το ζητούμενο URL, καλεί την εκάστοτε δηλωμένη view συνάρτηση, με ένα HttpRequest object ως πρώτο όρισμα και τυχόν “αιχμάλωτες” τιμές από τα regular expressions ως τα υπόλοιπα ορίσματα. Αν τα regexes χρησιμοποιούν απλά captures, τότε οι τιμές περνούν ως positional arguments. Αν, από την άλλη, χρησιμοποιούν named captures, τότε οι τιμές περνούν ως keyword arguments. Θα δώσουμε ένα παράδειγμα αυτού σε επόμενο οδηγό.
url() argument: kwargsLink to this heading#Επίσης, στο Django view μπορούν να περαστούν, προαιρετικά και αυθαίρετα keyword arguments. Σε αυτό τον οδηγό δεν θα χρησιμοποιήσουμε αυτή τη δυνατότητα.
\nurl() argument: nameLink to this heading#Υπάρχει επίσης το πολύ δυνατό χαρακτηριστικό του Django, με το οποίο μπορείτε να ονομάσετε τα URL σας και να αναφέρεστε σε αυτά μόνο με το όνομα τους παρά με την διεύθυνση τους. Αυτό, θα το χρησιμοποιείτε συνέχεια στα templates σας (π.χ μέσα σε ένα <a href> HTML tag). Με αυτό τον τρόπο μπορείτε να αλλάζετε τις διευθύνσεις των URL πειράζοντας μόνο ένα αρχείο (urls.py) παρά να ψάχνετε σε άλλα μέρη (π.χ στα template σας) για να ανανεώσετε το URL (αφού, αλλιώς θα είχατε γράψει ολόκληρη τη διεύθυνση URL).
Όταν αισθανθείτε άνετα με αυτό τον οδηγό και με τη λειτουργία της Web request-Web response διαδικασίας μπορείτε να συνεχίσετε στο δεύτερο μέρος αυτού του οδηγού για να εργαστείτε με τη βάση δεδομένων.
\n