From 3ad2a774a7b9224c1cd4890b9d99c6871c414372 Mon Sep 17 00:00:00 2001 From: Adrian Holovaty Date: Tue, 19 Jul 2005 19:55:18 +0000 Subject: [PATCH] Added 'How to use Django with mod_python' -- docs/modpython.txt git-svn-id: http://code.djangoproject.com/svn/django/trunk@217 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/modpython.txt | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 docs/modpython.txt diff --git a/docs/modpython.txt b/docs/modpython.txt new file mode 100644 index 0000000000..cfd46d6ebf --- /dev/null +++ b/docs/modpython.txt @@ -0,0 +1,41 @@ +================================= +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:: + + + SetHandler python-program + PythonHandler django.core.handlers.modpython + SetEnv DJANGO_SETTINGS_MODULE myproject.settings.main + PythonDebug On + + +...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:: + + + SetHandler python-program + PythonHandler django.core.handlers.modpython + SetEnv DJANGO_SETTINGS_MODULE myproject.settings.admin + PythonDebug On + + +The only thing different here is the ``DJANGO_SETTINGS_MODULE``.