Nel seguito useremo spesso le espressioni "sito" e "applicazione" Django, prima di iniziare chiariamo il loro significato. Ogni applicazione Django fa parte di un sito Django e un sito Web e può contenere più applicazioni, ognuna con uno scopo preciso (un portale, un blog, etc.).
Questa struttura si riflette sull'organizzazione sul filesystem del sito Django: il sito viene memorizzato in una directory contenente gli script python di configurazione del sito (che descriveremo di seguito) e una cartella per ciascuna applicazione.
miosito/ __init__.py settings.py urls.py applicazione1/ __init__.py models.py views.py applicazione2/ ...
È possibile configurare Django per gestire più siti in una singola istanza del framework.
Creare un sito
Un sito viene creato mediante il comando
django-admin.py startproject miosito
che crea la cartella miosito
nella directory corrente. La cartella miosito
conterrà tutti i file del progetto tra cui:
Nome del file | Descrizione |
---|---|
__init__.py | file vuoto che indica che la cartella rubrica è un package Python |
manage.py | una utility a linea di comando che permette di interagire con il progetto |
settings.py | contiene i parametri di configurazione del progetto |
urls.py | contiene la dichiarazione degli URL gestiti dal progetto |
Creare un'applicazione
Per creare l'applicazione app
in miosito
lanciamo il comando
manage.py startapp app
che, a sua volta, crea una cartella app
nella cartella miosito
. Questa nuova cartella conterrà:
Nome del file | Descrizione |
---|---|
__init__.py | file vuoto che indica che la cartella app è un package Python |
models.py | contiene le definizioni delle classi Model |
views.py | contiene le definizioni delle View dell'applicazione |
Nel corso della guida vedremo come utilizzare e modificare questi file.