p15693087
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Added some more to docs/modpython.txt 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@221 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2005-07-19 20:05:52 +00:00
parent 21f152e9e5
commit 1dfc375e35
1 changed files with 23 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
docs/modpython.txt
View File

@ -5,10 +5,11 @@ How to use Django with mod_python
Apache/mod_python currently is the preferred setup for using Django on a Apache/mod_python currently is the preferred setup for using Django on a
production server. production server.
mod_python, available at http://www.modpython.org/ , is similar to mod_perl: It mod_python, available at http://www.modpython.org/ , is similar to
embeds Python within Apache and loads Python code into memory when the server `mod_perl`_ : It embeds Python within Apache and loads Python code into memory
starts. Code stays in memory throughout the life of an Apache process, which when the server starts. Code stays in memory throughout the life of an Apache
leads to significant performance gains over other server arrangements. process, which leads to significant performance gains over other server
arrangements.
To configure Django with mod_python, first make sure you have Apache installed, To configure Django with mod_python, first make sure you have Apache installed,
with the mod_python module activated. with the mod_python module activated.
@ -25,10 +26,25 @@ Then edit your ``httpd.conf`` file and add the following::
...and replace ``myproject.settings.main`` with the path to your settings file, ...and replace ``myproject.settings.main`` with the path to your settings file,
in dotted-package syntax. in dotted-package syntax.
This tells Apache: "Use mod_python for any URL at or under '/mysite/', using the
Django mod_python handler." It passes the value of ``DJANGO_SETTINGS_MODULE``
so mod_python knows which settings to use.
Also, if you've manually altered your ``PYTHONPATH`` to put your Django project
on it, you'll need to tell mod_python::
PythonPath "['/path/to/project'] + sys.path"
You can also add directives such as ``PythonAutoReload Off`` for performance.
See the `mod_python documentation`_ for a full list of options.
Restart Apache, and any request to /mysite/ or below will be served by Django. 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 Note that Django's URLconfs won't trim the "/mysite/" -- they get passed the
full URL. full URL.
When deploying Django sites on mod_python, you'll need to restart Apache each
time you make changes to your Python code.
Here's a template for an admin configuration:: Here's a template for an admin configuration::
<Location "/admin/"> <Location "/admin/">
@ -39,3 +55,6 @@ Here's a template for an admin configuration::
</Location> </Location>
The only thing different here is the ``DJANGO_SETTINGS_MODULE``. The only thing different here is the ``DJANGO_SETTINGS_MODULE``.
.. _mod_perl: http://perl.apache.org/
.. _mod_python documentation: http://modpython.org/live/current/doc-html/directives.html