1   基本配置

为了在mod_python上配置django，首先要保证你已经安装了Apache并且已经激活了mod_python模块。

接下来编辑 httpd.conf 并加入下面的内容:

<Location "/mysite/">
    SetHandler python-program
    PythonHandler django.core.handlers.modpython
    SetEnv DJANGO_SETTINGS_MODULE mysite.settings
    PythonDebug On
</Location>

...用你实际的django的setting文件的路径替换 mysite.settings 。

这告示Apache：“对所有的 '/mysite/' 下面的URL使用mod_python来处理，使用Django的mod_python处理器”。 它传入了 DJANGO_SETTINGS_MODULE 参数，这样mod_python就知道应该使用那个配置文件了。

同时，如果你手工修改 PYTHONPATH 来指向你的Django项目的路径，你需要如下写:

PythonPath "['/path/to/project'] + sys.path"

你还可以加一条 PythonAutoReload Off 指令来提高效率。

更多配置选项请参考 mod_python documentation .

注意，你应该为生产服务期设置 PythonDebug Off 。如果你保留 PythonDebug On 的话，当mod_python报错的话你将看到一大堆难看的python traceback信息。

重启Apache，接下来所有请求在/mysite/下面和其子目录下面的内容都将由Django来服务。 注意，Django的URLconf不会去掉"/mysite/" -- 他们获取的是完整的URL。

在mod_python上部署Django站点的时候，当你每次修改Python代码之后需要重启Apache来使之生效。

2   在同一个Apache上配置多个Django站点

在同一个Apache实例上运行多个Django站点是完全可能的。 使用 VirtualHost 就可以了，如下:

NameVirtualHost *

<VirtualHost *>
    ServerName www.example.com
    # ...
    SetEnv DJANGO_SETTINGS_MODULE mysite.settings
</VirtualHost>

<VirtualHost *>
    ServerName www2.example.com
    # ...
    SetEnv DJANGO_SETTINGS_MODULE mysite.other_settings
</VirtualHost>

如果你需要将2个Django站点放到同一个 VirtualHost 中的话，你需要为每一个Django指定不同的 解释器，这是为了避免mod_python的缓存互相干扰。 使用 PythonInterpreter 指令来为每一个不同的 <Localtion> 来指定不同的解释器:

<VirtualHost *>
    ServerName www.example.com
    # ...
    <Location "/something">
        SetEnv DJANGO_SETTINGS_MODULE mysite.settings
        PythonInterpreter mysite
    </Location>

    <Location "/otherthing">
        SetEnv DJANGO_SETTINGS_MODULE mysite.other_settings
        PythonInterpreter mysite_other
    </Location>
</VirtualHost>

PythonInterpreter 的值是什么都无所谓的，只要保证他们在2个 Location 区段中是互不相同的就行了。

3   用 mod_python 建立开发服务器

如果你想把mod_python作为你的开发服务期，为了避免经常重启Apache， 你只要在 httpd.conf 设定 MaxRequestsPerChild 1 就可以了。 这样的设定将强迫Apache在每一次请求到来的时候都重新加载一切内容。 但是绝对不要对一个生产服务器作这个事情，否则我们将收回你的Django权限。

如果你是一个喜欢使用 print 语句来调试程序的程序员的话，请注意， print 语句在mod_python 中不起作用，它不会像你期望的那样在Apache的log文件中输出内容。 如果你确实需要在mod_python中打印出调试信息，可以用下面的方法:

assert False, the_value_i_want_to_see

或者将调试信息加入到你的页面模板中。

4   提供媒体文件服务

Django本身不提供媒体文件的服务，它将这个工作交给了你选择的Web服务器了。 我们建议使用分开的Web服务器来做这件事，例如提供媒体文件服务的服务器没有运行着Django。 下面是一些好的选项:

• lighttpd
• TUX
• A stripped-down version of Apache

然而，如果没有别的选择，必须在同一个Apache的 VirtualHost 里面提供媒体文件服务的话， 可以用下面的语句来关闭mod_python的处理:

<Location "/media/">
    SetHandler None
</Location>

只要修改 Location 为你的问题文件的根目录即可。 你还可以使用 <LocationMatch> 来匹配一个正则表达式。

下面的例子配置Django站点为根目录，但是明确的对 modia 子目录和所有以 .jpg, .gif 和 .png 结尾的URL不使用Django来处理:

<Location "/">
    SetHandler python-program
    PythonHandler django.core.handlers.modpython
    SetEnv DJANGO_SETTINGS_MODULE mysite.settings
</Location>

<Location "media">
    SetHandler None
</Location>

<LocationMatch "\.(jpg|gif|png)$">
    SetHandler None
</LocationMatch>

5   提供admin文件服务

Django开发服务器已经被自动配置为提供admin界面的媒体文件的服务， 但是当你使用任何其他服务器的时候就不是这样了。 你必须设置Apache或其他的媒体服务器来为admin的媒体文件提供服务。

admin的文件在 (django/contrib/admin/media) 下面。

这里推荐2个方法:

1. 在你的documentroot目录下创建一个指向admin媒体目录的符号链接。 这个做法的好处就是你的Django本身的文件都在原来的位置上，你可以 svn更新你的django代码等。
2. 或者将admin的媒体文件复制到apache的documentroot目录下面。

6   错误处理

当使用Apache/mod_python的时候，错误将被Django捕获，也就是说他们不会传播到Apache 层面也就不会出现在Apache的 error_log 里面。

当出现异常的时候，可能是Django内部出现了问题。 在这种情况下，你将看到一个“内部服务器错误”的信息，并且在Apache的 error_log 里面 有一个完整的traceback信息。这个信息被分成许多行存储在 error_log 中。 （是的，它非常难看也很难阅读，但这就是mod_python做出来的事情。）

7   如果配置出错

如果Apache出现了segmentation错误的话，这可能有2种原因，但是任何一个原因都与Django本身无关。

1. 可能是你的Python代码导入了"pyexpat"这个模块，这个模块与Apache内置的版本有冲突。 更详细的信息请参考 Expat Causing Apache Crash.
2. 可能是你在同一个Apache里面同时运行了mod_python和mod_php，并且都以mysql作为后端数据库。 在某些情况下，可能会由于PHP与Python的MySQL后端的冲突所致。 更多信息请参考 mod_python FAQ entry.

如果你在设置mod_python的时候还有问题，那么最好是先配置一个完全单独的mod_python环境，并且 可以运行的。这样可以较容易的判断出mod_python的问题。 可以看 Getting mod_python Working

下一步就是编写一个测试代码，并导入一些Django特有的模块，例如你的视图、模型、URLconf等等。 把这些代码放到测试文件中，然后用浏览器访问，如果程序崩溃，你就可以判断是因为导入Django代码 导致的问题。通常的做法是减少导入的模块的数量，直到崩溃停止，这样就可以找出导致崩溃的特别的模块了。 必要的话还可以进入那个模块，看看它导入的其他模块是不是有问题。