Come installare Django
Questo documento ti renderà operativo con Django.
Installare Python
Django è un framework Web scritto in Python, perciò richiede Python.
E' in grado di funzionare con qualsiasi versione di Python dalla 2.3 in poi.
Puoi ottenere Python dal sito www.python.org. Se stai usando Linux o Mac OS X, probabilmente lo trovi già installato.
Installare Apache e mod_python
Se vuoi soltanto fare qualche esperimento con Django puoi tralasciare questa parte di installazione. Django infatti viene fornito con un proprio Web server adatto a funzionare in ambienti di sviluppo e test.
Nel caso in cui sia previsto l'utilizzo in ambienti di produzione usa Apache assieme a mod_python. mod_python è simile a mod_perl -- integra Python all'interno di Apache e carica il codice in memoria quando il server viene avviato. Il codice risiede in memoria per tutta la durata di un processo di Apache, e ciò offre - rispetto ad altre configurazioni - un guadagno di prestazioni significativo. Assicurati che Apache sia installato e che mod_python sia attivo. Django richiede Apache 2.x e mod_python 3.x.
Per informazioni su come configurare mod_python dopo averlo installato consulta Come usare Django con mod_python.
Se per qualche ragione non puoi usare mod_python, non temere: Django segue le specifiche WSGI, perciò può funzionare assieme ad altre piattaforme server. Vedi la pagina del wiki sulle configurazioni dei server.
Metti in funzione il database
Se pensi di usare le funzionalità messe a disposizione dalle API di Django per i database, devi essere sicuro che sia in funzione un database server. Django funziona con PostgreSQL (soluzione raccomandata), MySQL e SQLite.
Devi anche accertarti che i binding Python per l'interfacciamento ai database siano installati.
- Se usi PostgreSQL ti serve il pacchetto psycopg (la versione 1.1 -- non la 2.0 che ancora non è considerata stabile). Se usi Windows procurati la versione compilata.
- Se usi MySQL ti serve MySQLdb.
- Se usi SQLite ti serve la versione 2.0.3 o successiva di pysqlite.
Installare il codice di Django
Le istruzioni di installazione sono leggermente differenti se usi l'ultima versione ufficiale o l'ultima versione in sviluppo.
In un caso o nell'altro la procedura è semplice.
Installare la versione ufficiale
- Scarica Django-0.91.tar.gz dalla pagina dei download.
- tar xzvf Django-0.91.tar.gz
- cd Django-0.91
- sudo python setup.py install
Nota che, se setuptools non fa ancora parte del tuo setup, l'ultimo comando dell'elenco lo scaricherà e lo installerà automaticamente. Perciò ti servirà una connessione ad Internet funzionante.
In questo modo Django verrà posizionato nella directory site-packages dell'installazione Python.
Note
A causa di recenti modifiche, sono state introdotte alcune incompatibilità con le precedenti versioni di Django. E' fortemente raccomandato l'utilizzo della versione di sviluppo (vedi oltre) se stai comincindo lo sviluppo di qualsiasi nuova applicazione o se stai muovendo i primi passi con Django. La versione 0.91 non sarà più mantenuta, ed il suo scopo primario è quello di supportare applicazioni Django preesistenti.
Installare la versione di sviluppo
- Assicurati che Subversion sia installato.
- svn co http://code.djangoproject.com/svn/django/trunk/ django_src
- Crea un link simbolico a django_src/django in modo che django sia nella directory site-packages dell'installazione Python:
ln -s `pwd`/django_src/django /usr/lib/python2.3/site-packages/django
(Nella riga sopra modifica python2.3 facendolo coincidere con la versione di Python che stai utilizzando correntemente.)
Non devi eseguire python setup.py install.
Quando vuoi aggiornare il codice, scrivi semplicemente il comando svn update stando nella directory django_src.