[学习] Apache + mod_python + Django Step by Step

鉴于网上关于 Python 框架 Django 的 Apache + mod_python + Django 环境详细安装加实例文档还是比较难找到，所以我在这边写一个文档与初学 Django 的同志们以共勉：）

1、下载需要模块。

a、apache (httpd-2.0.54.tar.gz or later)
b、mod_python (mod_python-3.3.1.tgz)
c、Django (Django-0.96.tar.gz)

默认已安装 Python 

2、安装配置环境。

首先，正常安装 apache 和 mod_python注意要打开 apache 的 DSO 功能，执行：

#...
#tar -zxvf httpd-2.0.54.tar.gz
#cd httpd-2.0.54
#./configure --prefix=/usr/local/apache2 --enable-so --enable-mods-shared=all
#make install clean
#...
#tar -zxvf mod_python-3.3.1.tgz
#cd mod_python-3.3.1
#./configure --with-apxs=/usr/local/apache2/bin/apxs --with-python=/usr/local/bin/python
#make install clean
#...
#tar -zxvf Django-0.96.tar.gz
#cd Django-0.96
#python setup.py install (If you installed Django using setup.py install, uninstalling is as simple as deleting the django directory from your Python site-packages.)
#...

这样我们就安装好 Apache + mod_python + Django 了，你可以执行 apachectl start 测试一下能不能成功。然后我们开始配置环境，首先配置 httpd.conf 加入 LoadModule python_module modules/mod_python.so (在安装 mod_python 的时候安装程序会自动把 mod_python.so 拷贝到 apache 的 modules 目录下)，接着配置虚拟主机。

到这里你就可以利用 mod_python 来进行编程了，然后我们来配置一下 Django 并通过一个实例来让大家对这个现今最 HOT 的 python web 框架有一个大体的了解：首先，我们来学习一下用 django-admin.py 工具来简化你的工作 (当我们安装 Django 的时候，安装程序会自动把 django-admin.py 拷贝到 系统 PATH 下，所以我们可以直接使用它)。首先进入到我们的 python 程序目录 (我用的是：{DOCUMENT_ROOT}/python),执行：

#django-admin.py startproject newtest

这样就可以生成我们的测试工程了默认情况下会生成 {DOCUMENT_ROOT}/python/newtest 目录，该目录下会有如下文件：

__init__.py (表示这是一个 Python 的包)
manage.py (提供简单化的 django-admin.py 命令，特别是可以自动进行 DJANGO_SETTINGS_MODULES 和 PYTHONPATH 的处理，而没有这个命令，处理上面环境变量是件麻烦的事情)
settings.py (它是django的配置文件)
uls.py (url映射处理文件， Karrigell 没有这种机制，它通过目录/文件/方法来自动对应，而 Django 的url映射是url对于某个模块方法的映射，目前不能自动完成)

然后我们在 apache 的虚拟主机配置文件里面加上：

<Location "/newtest/">
SetHandler python-program
PythonPath "sys.path+[\'{DOCUMENT_ROOT}/python\']"
PythonHandler django.core.handlers.modpython
SetEnv DJANGO_SETTINGS_MODULE newtest.settings
#PythonInterpreter mysite
PythonDebug On
</Location>

这里要注意的是对于 PythonPath，必须设置成工程目录 ({DOCUMENT_ROOT}/python/newtest) 的上一级目录！这样我们就完成了 Django 和 apache 的整合了，赶快试一下吧，我们写一个 action 来测试一下 Django 的功能：

3、编写测试程序。

1> 首先，创建 ./list.py :

#coding=utf-8
from django.shortcuts import render_to_response

address = [
{\'name\':\'张三\', \'address\':\'地址一\'},
{\'name\':\'李四\', \'address\':\'地址二\'}
]

def index(request):
return render_to_response(\'list.html\', {\'address\': address})

2> 然后，创建一个模版文件 ./templates/list.html :

<h2>通讯录</h2>
<table border="1">
<tr><th>姓名</th><th>地址</th></tr>
{% for user in address %}
<tr>
<td>{{ user.name }}</td>
<td>{{ user.address }}</td>
</tr>
{% endfor %}
</table>

3> 设置模版目录 (编辑 ./settings.py) :

TEMPLATE_DIRS = (
# Put strings here, like "/home/html/django_templates".
# Always use forward slashes, even on Windows.
\'./templates\',
)

4> 修改 urls.py :

from django.conf.urls.defaults import *

urlpatterns = patterns(\'\',
# Example:
# (r\'^newtest/\', include(\'newtest.foo.urls\')),
(r\'^newtest/list/$\', \'newtest.list.index\'),

# Uncomment this for admin:
# (r\'^admin/\', include(\'django.contrib.admin.urls\')),
)

5> 重启 Apache 并访问相应 url (http://localhost/newtest/list/) 即可看到结果页面了：

通讯录
姓名 地址
张三 地址一
李四 地址二

到这里，你已经掌握了 Django 框架的基本内容了，就可以进一步学习 Django 的其他内容了，Enjoy It ：）