mirror of https://github.com/django/django.git
42 lines
1.5 KiB
Plaintext
42 lines
1.5 KiB
Plaintext
|
=================================
|
||
|
|
How to use Django with mod_python
|
||
|
|
=================================
|
||
|
|
|
||
|
|
Apache/mod_python currently is the preferred server setup for using Django on a
|
||
|
|
production server.
|
||
|
|
|
||
|
|
mod_python, available at http://www.modpython.org/ , is similar to mod_perl: It
|
||
|
|
embeds Python within Apache and loads Python code into memory when the server
|
||
|
|
starts. Code stays in memory throughout the life of an Apache process, which
|
||
|
|
leads to significant performance gains over other server arrangements.
|
||
|
|
|
||
|
|
To configure Django with mod_python, first make sure you have Apache installed,
|
||
|
|
with the mod_python module activated.
|
||
|
|
|
||
|
|
Then edit your ``httpd.conf`` file and add the following::
|
||
|
|
|
||
|
|
<Location "/mysite/">
|
||
|
|
SetHandler python-program
|
||
|
|
PythonHandler django.core.handlers.modpython
|
||
|
|
SetEnv DJANGO_SETTINGS_MODULE myproject.settings.main
|
||
|
|
PythonDebug On
|
||
|
|
</Location>
|
||
|
|
|
||
|
|
...and replace ``myproject.settings.main`` with the path to your settings file,
|
||
|
|
in dotted-package syntax.
|
||
|
|
|
||
|
|
Restart Apache, and any request to /mysite/ or below will be served by Django.
|
||
|
|
Note that Django's URLconfs won't trim the "/mysite/" -- they get passed the
|
||
|
|
full URL.
|
||
|
|
|
||
|
|
Here's a template for an admin configuration::
|
||
|
|
|
||
|
|
<Location "/admin/">
|
||
|
|
SetHandler python-program
|
||
|
|
PythonHandler django.core.handlers.modpython
|
||
|
|
SetEnv DJANGO_SETTINGS_MODULE myproject.settings.admin
|
||
|
|
PythonDebug On
|
||
|
|
</Location>
|
||
|
|
|
||
|
|
The only thing different here is the ``DJANGO_SETTINGS_MODULE``.
|