Πως να χρησιμοποιήσετε το Django με τον Apache και το mod_wsgi¶

Βασική παραμετροποίηση¶

Once you’ve got mod_wsgi installed and activated, edit your Apache server’s httpd.conf file and add the following.

WSGIScriptAlias / /path/to/mysite.com/mysite/wsgi.py
WSGIPythonHome /path/to/venv
WSGIPythonPath /path/to/mysite.com

<Directory /path/to/mysite.com/mysite>
<Files wsgi.py>
Require all granted
</Files>
</Directory>

Η πρώτη παράμετρος στη γραμμή του WSGIScriptAlias είναι το βασικό URL path που θέλετε να εξυπηρετηθεί η εφαρμογή σας (η κάθετος, /, υποδεικνύει το root url) και η δεύτερη είναι η τοποθεσία που βρίσκεται το «WSGI file» – δείτε παρακάτω – στο σύστημα σας, συνήθως μέσα στο φάκελο του project σας (mysite, σε αυτό το παράδειγμα). Αυτό λέει στον Apache να εξυπηρετήσει κάθε request κάτω από αυτό το url (αν κατέχετε το url με το όνομα πχ www.mysite.com τότε θα εξυπηρετηθούν όλα τα urls που ξεκινούν με αυτό το όνομα) χρησιμοποιώντας την WSGI εφαρμογή η οποία ορίζεται σε αυτό το αρχείο (wsgi.py).

If you install your project’s Python dependencies inside a virtual environment, add the path using WSGIPythonHome. See the mod_wsgi virtual environment guide for more details.

Η γραμμή WSGIPythonPath βεβαιώνει ότι το project σας θα είναι διαθέσιμο για να γίνει import στο Python path. Με άλλα λόγια, ότι το import mysite δουλεύει.

The <Directory> piece ensures that Apache can access your wsgi.py file.

Επόμενο βήμα είναι να σιγουρευτούμε ότι υπάρχει το αρχείο wsgi.py με το WSGI application object. Από την έκδοση του Django 1.4 και μετά, η εντολή startproject θα δημιουργήσει ένα τέτοιο αρχείο. Αν όχι, θα χρειαστεί να το δημιουργήσετε εσείς. Δείτε στο εγχειρίδιο του WSGI για τα προεπιλεγμένα περιεχόμενα που μπορείτε να βάλτε σε αυτό το αρχείο καθώς και άλλα πράγματα που μπορείτε να προσθέσετε.

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "{{ project_name }}.settings")

os.environ["DJANGO_SETTINGS_MODULE"] = "{{ project_name }}.settings"

export LANG='en_US.UTF-8'
export LC_ALL='en_US.UTF-8'

WSGIDaemonProcess example.com lang='en_US.UTF-8' locale='en_US.UTF-8'

Χρησιμοποιώντας το mod_wsgi daemon mode¶

Η λειτουργία daemon («daemon mode») είναι η προτεινόμενη λειτουργία για να τρέχετε το mod_wsgi (σε πλατφόρμες εκτός Windows). Για να δημιουργήσετε το απαραίτητο daemon process group και να εξουσιοδοτήσετε το Django instance να το τρέξει, θα πρέπει να προσθέσετε τα κατάλληλα directives WSGIDaemonProcess και WSGIProcessGroup. Αν χρησιμοποιείτε την παραπάνω ρύθμιση με το daemon mode δεν θα μπορείτε να χρησιμοποιήσετε το WSGIPythonPath. Αντ’ αυτού θα πρέπει να χρησιμοποιήσετε την επιλογή python-path μέσα στο WSGIDaemonProcess. Για παράδειγμα:

WSGIDaemonProcess example.com python-home=/path/to/venv python-path=/path/to/mysite.com
WSGIProcessGroup example.com

Αν θέλετε να εξυπηρετήσετε το project σας σε κάποιον υποφάκελο (πχ στη διεύθυνση https://example.com/mysite), μπορείτε να προσθέσετε το WSGIScriptAlias στην παραπάνω παραμετροποίηση:

WSGIScriptAlias /mysite /path/to/mysite.com/mysite/wsgi.py process-group=example.com

Δείτε το επίσημο εγχειρίδιο του mod_wsgi για περισσότερες λεπτομέρειες στην παραμετροποίηση του daemon mode.

Εξυπηρετώντας αρχεία¶

Django doesn’t serve files itself; it leaves that job to whichever web server you choose.

We recommend using a separate web server – i.e., one that’s not also running Django – for serving media. Here are some good choices:

• Nginx
• Μια stripped-down έκδοση του Apache

Αν, παρόλ’ αυτά, δεν έχετε άλλη επιλογή παρά να εξυπηρετήσετε τα media files στον ίδιο Apache VirtualHost που τρέχει και το Django, μπορείτε να ρυθμίσετε τον Apache να εξυπηρετήσει μερικά URLs ως static media και άλλα χρησιμοποιώντας το mod_wsgi interface στο Django.

Αυτό το παράδειγμα ρυθμίζει το Django στο site root, αλλά εξυπηρετεί τα αρχεία robots.txt, favicon.ico και οτιδήποτε μέσα στα URLs /static/ και /media/ ως ένα static file (πχ JavaScript, CSS, fonts αρχείο κλπ). Όλα τα άλλα URLs θα εξυπηρετηθούν χρησιμοποιώντας το mod_wsgi:

Alias /robots.txt /path/to/mysite.com/static/robots.txt
Alias /favicon.ico /path/to/mysite.com/static/favicon.ico

Alias /media/ /path/to/mysite.com/media/
Alias /static/ /path/to/mysite.com/static/

<Directory /path/to/mysite.com/static>
Require all granted
</Directory>

<Directory /path/to/mysite.com/media>
Require all granted
</Directory>

WSGIScriptAlias / /path/to/mysite.com/mysite/wsgi.py

<Directory /path/to/mysite.com/mysite>
<Files wsgi.py>
Require all granted
</Files>
</Directory>

Εξυπηρετώντας τα αρχεία του admin¶

When django.contrib.staticfiles is in INSTALLED_APPS, the Django development server automatically serves the static files of the admin app (and any other installed apps). This is however not the case when you use any other server arrangement. You’re responsible for setting up Apache, or whichever web server you’re using, to serve the admin files.

Τα αρχεία του admin βρίσκονται στην τοποθεσία django/contrib/admin/static/admin της Django διανομής.

We strongly recommend using django.contrib.staticfiles to handle the admin files (along with a web server as outlined in the previous section; this means using the collectstatic management command to collect the static files in STATIC_ROOT, and then configuring your web server to serve STATIC_ROOT at STATIC_URL), but here are three other approaches:

1. Δημιουργήστε ένα symbolic link στα static files του admin από το document root σας (αυτό ίσως απαιτήσει να χρησιμοποιήσετε το +FollowSymLinks στη ρύθμιση του Apache).
2. Χρησιμοποιήστε ένα directive Alias, όπως περιγράφηκε παραπάνω, για να κάνετε alias το κατάλληλο URL (πιθανόν το STATIC_URL + admin/) με την ακριβή τοποθεσία των αρχείων του admin.
3. Αντιγράψτε τα static files του admin ούτως ώστε να υπάρχουν μέσα στο document root του Apache σας.

Πιστοποίηση της βάσης δεδομένων ενός Django χρήστη μέσω Apache¶

Το Django παρέχει έναν handler που επιτρέπει στον Apache να πιστοποιεί τους χρήστες απ’ ευθείας μέσω το σύστημα πιστοποίησης του Django. Δείτε περισσότερα στο εγχειρίδιο της πιστοποίησης του mod_wsgi.