[Python]Apache with Mod_python

 

apache是分步骤处理请求的,例如，第一步可能是确定用户，接下来验证用户是不是允许访问特定的文件，然后读这个文件并把它发送到客户端。

一个典型的静态文件请求包括三步：

• （1）解析请求的URI为文件在服务器上的路径。
• （2）读文件并把它发送到客户端。
• （3）记录请求日志。这个日志中记录了执行的步骤，记录内容的多少取决于配置文件中的设置。

一个处理器就是处理其中某一步的方法，有可能在处理某一步的时候需要用到不止一个处理器，在这种情况下，这几个处理器将被apache依次调用。每一步都会有一个默认的apache动作（大多数情况下都是很基础的方法或者不做任何事情）。与此同时，apache模块还提供了附加的处理器，比如mod_python.

mod_python为apache提供了几乎所有需要用到的处理器,mod_python的处理器默认的不会提供任何方法，除非我们明确的在配置文件中指示。这些指示以"python"开始，以"Handler"结束(比如: pythonAuthenHandler )它对应于一个python方法，这个方法处理众多步骤中的一步。所以mod_python的方法扮演的是发报机(dispatcher)的角色，通过它联系apache动作和开发人员(比如你)写的python方法。

最经常用到的处理器是 pythonHandler,它处理那些请求提供内容的步骤。因为它没有名字，所以有时候它被作为泛指的处理器。这个处理器的默认的apache动作是读文件并把它发送的客户端。你写的大多数程序都会重载这个处理器。

假设我们有下面的配置文件：

     < Directory  /mywebdir >
       AddHandler mod_python .py
       PythonHandler myscript
       PythonDebug On
     </ Directory >

注意: /mywebdir 是一个物理绝对路径。 还有一个python程序‘/mywedir/myscript.py’如下：

from  mod_python  import  apache
def  handler(req):
   req.content_type  =   " text/plain "
   req.write( " Hello World! " )
    return  apache.OK

 

解释一下这个程序:

addHandler 指示告诉 apache, 所有在mywebdir目录或者是它的子目录下的所有.py文件,有关于这些文件的任何请求都用mod_python 来处理, pythonHandler myscript 指示告诉 mod_python 用 myscript 执行默认的处理器. “pythonDebug On” 指示告诉mod_python如果发生错误，就把错误信息打印到客户端 (相对于写入日志文件),在开发的时候这个选项非常有用。

当一个请求发出时,apache通过调用mod_python中的处理器分步处理请求,Mod_python首先检查请求的那个处理器是否在配置文件中指定了(记住，它的角色是发报机dispatcher),在我们的例子中,mod_python除了调用默认的那个处理器外不会调用其他的任何处理器,然后,mod_python会发现"pythonHandler myscript"指示,并按照下面的步骤来进行:

• 1．如果以前没有做过，那么就把pythonHandler指定的那个目录加到sys.path中。
• 2．尝试引入myscript的模块(注意,如果myscript在pythonHandler指定那个目录的子目录中的话,引入会出错,因为子目录并没有加到sys.path中,解决这种情况的方法是使用包)例如:”pythonHandler subdir.myscript”
• 3．在myscript中寻找名字叫handler的方法。
• 4．调用这个方法，并把request对象传递给它。
• 5．现在让我们深入这段脚本看一下：
  from  mod_python  import  apache 
  这个引入语句提供给我们一个访问apache的接口。除了极少数情况外，每一个mod_python程序一般都会有这一行。
  def  handler(req): 
  这是处理器方法的声明，它之所以叫"handler"是因为mod_python在指示中使用这个名字,转换它为小写并移除"python",所以"pythonHandler"变成了"handler",你可以给它起别的名字，并且通过在指示中使用"::"明确的指定它.举个例子，如果处理器方法叫"spam",那么指示就应该是”pythonHandler myscript::spam”。
  注意处理器必须有一个参数request对象。Request对象提供了所有可能用到的信息，比如客户端的IP,头,URI等等.返回客户端的信息仍然通过request对象传递，注意，在mod_python中没有response对象。
  req.content_type  =   " text/plain "  
  这条语句设置文档类型为” text/plain”。默认的通常是” text/html”，但是因为我们的处理器不处理任何html, 所以“text/plain”更合适一些。
  req.write( " Hello World! " ) 
  这条语句把字符串” Hello World!”写到客户端(再次强调没有response对象,所以写到客户端仍然有request对象)。
  return  apache.OK 
  这条语句告诉apache一切正常，而且请求也已经被处理了。如果出现异常，这一行应该返回apache.HTTP INTERNAL SERVER ERROR或返回apache.HTTP FORBIDDEN，而且apache会在日志中记录这个错误，并产生一条错误信息给客户端。