Mod_python_328中文手册 (NXPowerLite)

1、第一章简介1.1性能使用mod_python的主要优势在于比传统cgi更高的性能。一个测试，使用在pentium 1.2ghz的机器上运行red hat linux 7.3。使用4种类型的脚本，基于标准的cgi导入模块(以典型的python cgi脚本开始)，然后输出hello!，测试10000次请求作为基准。标准cgi： 23 次请求/秒mod_python cgi处理器： 385 次请求/秒mod_python 发布处理器： 476 次请求/秒mod_python 处理器： 1203 次请求/秒1.2可移植性apache是按照阶段处理请求的(比如：读取请求、处理请求头、检查存取等)。这些阶

2、段可以分别用处理器调用的函数来实现。传统上，使用c语言编写处理器模块。mod_python提供了使用python拜你些apache处理器扩展apache功能的方法。更多的apache请求处理过程，参考apache api notes，或者参考mod_python-integrating python with apache文件。为了方便的从cgi移植，标准的mod_python处理器提供了cgi模拟环境，允许用户不修改遗留下来的脚本，而在大多数时候无需进行任何修改。参考：apache开发者资源/python1

3、0/mod_python-整合python和apache，出现在python 10(?)1.3历史mod_python起源于httpdapy项目(1997)。很久以后httpdapy才被叫做mod_python，因为httpdapy并不是特定用于apache服务器的。httpdapy设计成跨平台的，而实际上主要从netscape服务器开始(追溯到1997年的nsapy)。摘录自httpdapy项目的readme文件的描述将python嵌入到apache服务器的挑战与解决方法。 #小字体在我多年前开发第一个web应用程序时就发现cgi访问数据库非常慢，因为每次点击请求都会装入解释器并执行数mb的

4、数据。数据库往往都很大，并将大量时间浪费在数据库的连接/认证等意义重大的事情上，像dns查询、编码与解码、内存分配等等。在应用提速的压力下，我尝试过使用python和多种工具的综合使用。我并不迷信微软的asp，又被netscape的性能和满是臭虫而郁闷。cold fusion(冷聚变)看起来有希望，但我稍后学会了html类标签的书写方式，可读性跟汇编有一拼。比如php。但是我真的很想用python来写东西。就在同时有关python互联网编程的书籍出版了，其中将python嵌入到netscape服务器的方式立即引起了我的注意。我在我的项目中使用了这个例子，并在稍后开发了我自己的改进版，叫做nsa

5、py，并在windowsnt和solaris上编译。尽管nsapy仅能工作在netscape服务器上，但是出于灵活通用的面向对象设计，在python精灵中，很容易移植到其他的web服务器。后来，曾经流行的netscape服务器挂了，我就将nsapy移植到最流行的服务器apache上。所以从nsapy衍生出了httpdapy。继续这个传奇，你会想到将httpdapy移植到其他服务器上，实际上他们比预想要复杂而且枯燥。反之，提供一个类似于perl语言的apache扩展mod_perl一样或更好性能的部件会更有意思。俱往矣，mod_python的第一个版本发布于2000年5月。完成.第二章安装注意：

6、获得关于安装的帮助和其他问题的最好地方是mod_python的邮件列表。可以发送标题为subscribe的邮件到mod_。2.1先决条件 python 2.2.1或更新的版本，早起版本将无法使用。 apache 2.0.40或更新的版本，如果要使用apache 1.3.x，请使用mod_python的版本2.7.x。编译mod_python需要有apache和python的包含文件，并且确保安装了python标准库。如果你从源代码安装了python和apache，那么你已经拥有了这些了。如果你使用了预打包软件，如rpm或其他方式则只有二进制

7、版本，而没有源码。通常apache和python的包含文件和库文件在各自的development包中。如果你不确定拥有这些重要文件，请从源码安装python和apache，或者阅读你系统的文档以了解如何获得开发包。2.2编译有两种链接apache模块的方式：静态的和dso方式。dso方式现在非常流行，并推荐用于mod_python的安装。模块被编译成共享库，并在运行时动态装入。dso方式的优势在于安装模块时无需重新编译apache。关于dso机制的详细信息参见/docs-2.0/dso.html。当前版本的mod_python仅支持dso方式。静态链

8、接是一种较老的方式，比动态连接的方式支持更多的平台，但是较少使用。主要的缺陷是必须要重新编译apache，在很多情况下并不是一个好的选择。2.2.1运行./configure./configure脚本将会分析你的运行环境，并创建自定义的make文件用于你的系统。使用autoconf生成的./configure包含如下内容： 查看apxs程序是否存在。这个程序作为apache标准发行版的一部分提供dso支持。如果找不到则无法实现dso功能。使用-with-apxs指定选项：$ ./configure -with-apxs=/usr/local/apache/bin/apxs强烈建议使用这个选项。

9、 检查python版本，并尝试找到libpython参数变量的二进制发行版。缺省时可以在path变量中找到python。如果找到的首个python二进制版本不适合mod_python，则可以手动指定python的路径使用-with-python，如：$ ./configure -with-python=/usr/local/bin/python2.3 设置mod_python保留的互斥锁数量。在某些系统中，互斥锁是一种有限的资源。增加最大互斥锁数量将会增加使用session锁定的性能。缺省值是8，一个性能不错的数值是32。使用-with-max-locks选项：$ ./configure -w

10、ith-max-locks=32这个选项是在3.2.0版本开始提供的。 尝试查找flex并确定版本。如果path中找不到flex则configure会出错。如果版本不对则会给出警告。一般可以忽略这个警告，除非需要重新创建src/psp_parser.c。剖析器(parser)会被psp调用，使用flex的c语言书写。要求的版本是2.5.31，在大多数平台上2.5.4并不合适。所以已经源码里已经包含了一个psp_parser.c的副本。如果需要编译src/psp_parser.c则需要获取正确版本的flex。如果path中的flex版本有误，则可用-with-flex选项：$ ./configu

11、re -with-flex=/usr/local/bin/flex这是3.2.0版本中的新特性 构建mod_python文档时需要用到python的源代码。可以如果不需要文档，可以忽略这个选项。如果需要则用-with-python-src选项：$ ./configure -with-python-src=/usr/src/python2.3这个是3.2.0版本中的新特性2.2.2运行make开始构建过程，简单的运行如下即可：$ make2.3安装2.3.1运行make install这个安装过程必须在root用户下完成：$ su# make install这将会简单的将二进制版本复制到apac

12、he的libexec目录。并且会安装python-libraries到site-packages并编译他们。如果你想只安装python库或者只安装dso，可以用如下make目标：# make install_py_lib# make install_dso2.3.2配置apache按照dso模式安装的apache，需要在httpd.conf中加入启动mod_python的句子：loadmodule python_module libexec/mod_python.so实际的mod_python.so路径可能有所变化，但是make install将会显示这个文件的确切路径。2.4测试注意次部分内

13、容仅适用于3.x版本，如果使用2.7.x版本，你需要找到更适合的文档。 创建一个在web站点可见的目录，如htdocs/test。 在httpd.conf或者.htaccess文件中添加如下内容。如果是在.htaccess文件中，则无需标签。并且确保httpd.conf文件中的allowoverride目标至少包含fileinfo，缺省是none，将会无法工作。addhandler mod_python .pypythonhandler mptestpythondebug on 重定向所有以.py结尾的url到mod_python处理器。mod_python收到请求之后查找合适的处理器来处理请

14、求。这里有个简单的自定义处理器叫mptest。我们看看如何定义这个处理器。 此时如果修改了主配置文件httpd.conf则需要重启apache来使之生效。 编辑mptest.py文件在htdocs/test目录。from mod_python import apachedef handler(req):req.content_type=text/plainreq.write(hello, world!)return apache.ok 指向url路径到mptest.py。将会看到hello, world!。如果看不到则参考故障处理。 依照配置文件的规则，指定任何.py文件都会最终指向mptes

15、t.py做处理。因为已经明确的指定了mptest做处理器。如果需要用不同的处理器处理不同的文件则需要更高层的处理器，比如publisher发布器、mpservlets或vampire。这些都是动态装入的处理器。 如果都运行无误则转入第三章，入门。参考：/d.popowich/mpservlets.au/projects/vampire2.5故障处理如果出现问题，可以按照如下的处理： 检查错误输出 检查服务器错误日志 单处理执行apache$ ./httpd -x这样将会显示更多有用信息 从mod_python3.

16、2.0开始，可以使用mod_python.testhandler来诊断你的配置。添加到httpd.conf文件：sethandler mod_pythonpythonhandler mod_python.testhandler这时指向你的/mpinfo的url则会显示一些信息帮助处理mod_python的问题。 在mod_python邮件列表提问，并确保提供如下信息：mod_python版本操作系统类型、名字、版本号python版本、非常规的编辑选项apache服务器版本相关的apache配置，.htaccess相关的python代码完成.第三章指南3.1使用发布器(publisher)的快速

17、例子这一节提供无需太多细节的发布器指南。更多如何使用mod_python处理器的细节将在以后解释。发布器(publisher)提供了发布mod_python标准模块的方式。需要在配置文件中加入如下配置：addhandler mod_python .pypythonhandler mod_python.publisherpythondebug on下例会返回简单的表单数据。询问姓名、电子邮件、注释之后将会给管理员发邮件。这个简单的应用程序由两个文件组成：form.html用于提交数据，form.py用于处理表单动作。如下是表单：please provide feedback below:name

18、: email: comment: 注意表单的action属性指向form.py/email调用，如下创建form.py，如下：import smtplibwebmaster=webmaster #管理员电邮smtp_server=localhost #本机smtp服务器def email(req,name,email,comment):#一定要确保用户提供了所有的参数if not(name and email and comment):return 缺少必要的参数#创建消息文本msg= from: %ssubject: feedbackto: %si have the following c

19、omment:%sthank you,%s % (email,webmaster,comment,name)#发送信息conn=smtplib.smtp(smtp_server)conn.sendmail(email,webmaster,msg)conn.quit()#提供返回页面s=dear %s,thank you for your kind comments, wewill get back to you shortly. % namereturn name当用户点击提交按钮时，发布器将会装入email函数到form模块，传递表单字段作为关键字参数。也会传递请求对象到req。注意逆必须要

20、有req参数。发布器已经可以很聪明的传递必要的参数。函数的返回值将被发送到客户端浏览器。即使使用发布器可以非常简单的处理，但是程序仍然可以利用mod_python的强大功能，比如调用请求对象。当然也可以调用本地的mod_python处理器来完成大量的工作。比如设置html头路由req.headers_out；返回错误抛出apache.server_error异常；从客户端的重定向读写文件req.write()和req.read()，等等。阅读6.1节了解更多关于发布器的详细信息。3.2apache处理器概览节标题翻译有误，应为快速学习apache如何处理请求。如果你想要深入钻研mod_pyth

21、on的功能，需要理解什么是处理器。apache分阶段(phase)处理请求。比如第一个阶段是用户认证，之后是检验用户是否有权访问特定的文件，然后是读取文件并发送到客户端。一个典型的静态文件请求包含三个阶段：1.翻译uri到文件位置2.读取文件并发送到客户端3.记录请求日志。更复杂的处理依赖于配置文件。一个处理器就是初始处理某个阶段的函数。同一个阶段可以有多于一个处理器进行处理，被叫做apache序列。对应每个阶段有个缺省的apache处理器(大多数只做缺省动作或者什么都不作)。然后由其他的apache模块提供处理器，比如mod_python。mod_python提供了apache每一个重要的处

22、理器。mod_python处理器缺省时不会做任何事情，除非用特定的配置文件标志。这些标志以python开始并以handler结尾(如：pythonauthenhandler)，指定python函数来处理指定的阶段。所以mod_python的主函数只是作为发报机的角色连接apache处理器和python函数。最常用的处理器是pythonhandler。它处理含有上下文的请求。因为它没有名字，所以有时也成为通用处理器。这个处理器的apache缺省行为是读取文件并发送到客户端。大多数应用应该重写这个处理器。3.3mod_python做了什么我们假设有如下配置：addhandler mod_pytho

23、n .pypythonhandler myscriptpythondebug on所以还需要一个如下文件，/mywebdir/myscript.py如下：from mod_python import apachedef handler(req):req.content_type=text/plainreq.write(hello world!)return apache.ok如下的事情将会发生：addhandler标志告诉apache所有的以.py结尾的/mywebdir下或其子目录下的文件请求都由mod_python负责处理。pythonhandler myscript标志告诉mod_pyt

24、hon通用处理器在myscript脚本。pythondebug on标志告诉mod_python如果发生错误，则把错误信息输出到客户端，便于开发。当请求到来时，apache开始分步骤处理请求并讲请求发送到mod_python。mod_python处理器检查配置获取处理器。在本例，我们除了通用处理器之外没有调用其他东西。当读取配置到pythonhandler myscript时，会发生下面的事情：1.如果没有做过，假设预设目录已经存在于sys.path中。2.尝试按名字导入模块myscript。注意子目录是不在sys.path中的，如果需要只能按照包名的方式调用。3.在myscript中查找函数

25、handler4.调用这个函数并传递请求对象(关于请求对象的更多东西在后面)5.在这里我们细致研究一下脚本：from mod_python import apache导入apache模块来获取apache的接口。大多数mod_python程序需要有这一行。def handler(req):这是处理器函数的声明。叫做handler是因为mod_python按照配置标志寻找函数。将配置标志转换成小写，然后去掉python即可。这样pythonhandler就成了handler。当然也可以用其他的名字，但是需要用:来分隔函数名，比如一个处理器函数叫spam，那么配置标志就是pythonhandler

26、 myscript:spam注意，处理器必须包含一个请求对象参数。请求对象提供了关于请求的大量信息，比如客户端的ip，请求头，url等。向客户端发送信息也需要用到请求对象，这里是没有response对象的。req.content_type=text/plain设置文档mime类型为text/plain。缺省的是text/html，但是如果处理器没有打算返回html，那么text/plain更恰当(appropriate)一些。特别注意：需要在req.write方法之前调用如上语句，因为一旦调用req.write，http响应头就被发送出去了，其后的http响应头的改变都会忽略。req.writ

27、e(hello world!)将会把字符串写入到客户端。return apache.ok告知apache，请求处理完成并成功。如果没有返回ok，则apache会自动返回为apache.http_internal_server_error或return apache.http_forbidden。当处理失败时会在错误日志中记录，并告知客户端一点错误信息。小技巧：如果你注意到，会发现如果请求的url不是指向myscript.py，而只是一个.py结尾的文件，哪怕是一个不存在的文件，也可以得到相同的结果。因为服务器只是将特定结尾的处理直接交给相关模块的，而并不要求那一定是一个存在的文件。3.4更复杂

28、的例子-认证现在，你知道写一个处理器多么的简单，下面我们来显示一个更复杂的例子。如果需要用密码来保护一个目录。比如登录名为spam，密码为eggs。首先需要告诉apache在需要认证时调用我们的认证处理器。加入pythonauthenhandler标志到配置文件：addhandler mod_python .pypythonhandler myscriptpythonauthenhandler myscriptpythondebug on因为一个模块可以包含多个函数，所以也可以在一个模块中使用多个处理器。然后是告知apache，使用basic http认证。仅限有效用户进入。配置如下：addh

29、andler mod_python .pypythonhandler myscriptpythonauthenhandler myscriptpythondebug onauthtype basicauthname restricted arearequire valid-user然后在myscript.py中写认证函数，一个简单认证函数如下：from mod_python import apachedef authenhandler(req):pw=req.get_basic_auth_pw()user=req.userif user=spam and pw=eggs:return apac

30、he.okelse:return apache.http_unauthorized如下是逐行解释：def authenhandler(req):认证函数的声明，至于为什么叫这个名字，自己可以参考命名规则。pw=req.get_basic_auth_pw()这里获取密码。basic http认证采用base64编码发送到服务器。这个函数返回的直接就是密码了。注意必须在获取用户名之前先获取密码。user=req.user获取用户名if user=spam and pw=eggs:return apache.ok对比用户名和密码的值，如果正确返回告知验证成功，并进入下一个阶段的处理。在本例里下一个阶

31、段是handler()。else:return apache.http_unauthorized告知apache验证失败。这通常会导致客户端浏览器弹出对话框要求用户名和密码。实测：发现我使用的httpd-2.0.55提示验证类型无效，一共两种验证类型，一种是basic一种是digest，都是不允许的。就是按照如上例子。终于实验成功了，最上面的配置必须写在httpd.conf中才会有效，写在.htaccess中无效。无论是否指定了allowoverride fileinfo都是。这样进入一个目录之后会弹出系统的对话框提示输入用户名密码。验证成功后只要浏览器不关闭就可以继续进入这个目录，但是关闭后

32、就需要再次验证。3.5你自己的404处理器在某些时候，如果希望返回404(http_not_found)或者其他非200的结果到客户端，这里有个窍门。如果从你的处理器返回http_not_found， apache将会生成错误页。但是却未必是你喜欢的错误页。这时，你只要设置req.status=apache.http_not_found，提交你的页面，然后返回apache.ok就可以了：from mod_python import apachedef handler(req):if req.filename-17:=apache-error.html:#放行apache的错误页if req.f

33、ilename-18:=handler-error.html:#使用自己的错误页req.status=apache.http_not_foundpagebuffer=页面不存在else:#使用文件内容pagebuffer=open(req.filename,r).read()#输出错误页req.write(pagebuffer)return(apache.ok)完成.第四章 python api4.1多解释器使用mod_python工作的时候应该理解，并不是使用python在命令行下写脚本，而是用python调用c语言api。python的c语言api提供了创建子解释器的能力。关于子解释器的更

34、多信息详见py_newinterpreter()函数。在这里，每个子解释器拥有独立的命名空间，并与其他子解释器不可访问。子解释器非常适合于理解同一个服务器中处理各个请求的进程。服务器启动mod_python的时候会启动一个主解释器。主解释器包含子解释器词典。刚开始词典是空的。对应每一个请求就会创建一个子解释器，并将引用存储在词典里。这个词典用解释器名作为键名，主解释器叫做main_interpreter。其他的解释器受到pythoninterp*的控制。缺省的行为是使用apache虚拟服务器名来命名(servername标志)。这意味着同一个虚拟服务器中的脚本在同一个子解释器中执行，但不再同一

35、个虚拟服务器中的脚本因为不同的子解释器而无法互相访问。pythoninterpperdirectory和pythoninterpperdirective标志改变(alter)命名惯例(convention)到要存取的绝对路径，或者在python*handler可以访问到的地方，分别的(respectively)。pythoninterpreter能够强制使用解释器名重载所有的命名惯例。一旦创建，一个子解释器将会被接踵而来的请求重用，在apache停止之前不会被销毁。从调用erpreter可以获取当前的解释器名。参考python的c语言api：http:/www.python.or

36、g/doc/current/api/api.html4.2请求(request)处理器一个请求处理器是处理请求阶段细节的处理器。apache在处理请求的每一个阶段都对调用相应的处理器。对每一个阶段都会调用请求处理器，由apache的核心或者模块提供，比如mod_python由用户的python函数提供。用python书写的处理器只要遵守如下规则就与c写的没有区别：处理器函数总是会传递请求对象的引用，一般是req变量。每个处理器可以返回如下： apache.ok：这个阶段处理无误 apache.declined：这个阶段处理过后还需要队列中的其他模块处理 apache.http_error：发生

37、了http错误，如下值：http_continue 100http_switching_protocols 101http_processing 102http_ok 200http_created 201http_accepted 202http_non_authoritative 203http_no_content 205http_partial_content 206http_multi_status 207http_multiple_choices 300http_moved_permanently 301http_movedtemporarily 302http_see_other

38、 303http_not_modified 304http_use_proxy 305http_temporary_redirect 307http_bad_request 400http_unauthorized 401http_payment_required 402http_forbidden 403http_not_found 404http_method_not_allowed 405http_not_acceptable 406http_proxy_authentication_required 407http_request_time_out 408http_conflict 4

39、09http_gone 410http_length_required 411http_precondition_failed 412http_request_entity_too_large 413http_request_uri_too_large 414http_unsupported_media_type 415http_range_not_satisfiable 416http_expectation_failed 417http_unprocessable_entity 422http_locked 423http_failed_dependency 424http_interna

40、l_server_error 500http_not_implemented 501http_bad_gateway 502http_service_unavailable 503http_gateway_time_out 504http_version_not_supported 505http_variant_also_varies 506http_insufficient_storage 507http_not_extended 510可以通过抛出apache.server_return异常来返回错误码，并将http错误码作为异常的参数。例如：raise apache.server_re

41、turn, apache.http_forbidden处理器可以通过req.write()方法将文档发送到客户端。客户端提交的数据可以通过req.read()读取。注意：python*handler所在的目录必须已经在sys.path中，如果没有在配置段指定则不会在。一个请求处理器的例子：from mod_python import apachedef requesthandler(req):req.content_type=text/plainreq.write(hello world!)return apache.ok4.3过滤(filter)处理器过滤处理器可以改变服务器的输入和输出。分

42、两种：输入和输出的过滤。现在mod_python仅提供请求级别(request-level)的过滤器，就是http的请求和回应体可以被过滤。未来的apache将会提供连接级别(connection-level)的过滤器。过滤处理器接收一个filter对象做参数，请求对象可经由此得出filter.req，但是所有的读写动作必须经由filter的方法。过滤器在读到none时需要被关闭，代表流的结束。过滤器的返回值将会被忽略，但可用filter.pass_on()方法达到同样的效果。过滤器必须一开始就注册为pythoninputfilter或pythonoutputfilter，然后添加到apach

43、e的配置标志add/setinputfilter或add/setoutputfilter。如下例子把所有.py结尾文件用capitalize过滤器处理，如下是配置：pythonoutputfilter capitalize capitalizeaddoutputfilter captitalize .py如下是文件capitalize.py的内容：from mod_python import apachedef outputfilter(filter):s=filter.read()while s:filter.write(s.upper()s=filter.read()if s is non

44、e:filter.close()书写过滤器时应该注意到过滤器随时都会被调用。过滤器无法控制数据的总量，也无法确定请求何时调用。比如对于一个请求，过滤器可能会执行一次或五次，并无法知晓调用何时结束和先后顺序。从一个read操作返回的eos代表请求的结束。过滤器也可能在子请求的递归调用中。为避免数据多次被改变，经常的确保并不在子请求中，依靠req.main变量值。4.4连接(connection)处理器连接处理器处理连接到服务器的tcp连接。不同于http处理器，连接处理器接收connection对象做参数。连接处理器可以用于实现协议。如下例配置：pythonconnectionhandler e

45、cho实现文件echo.py：from mod_python import apachedef connectionhandler(conn):while 1:conn.write(conn.readline()return apache.ok4.5apache-访问apache内部apache内部对python的接口也恰好叫做apache，在mod_python包。提供了连接apache内部的重要功能，比如有用的函数，文档等(request对象也提供访问apache内部的接口，但不在本节)。apache模块仅可作为mod_python下的一个脚本来导入，因为它依赖于mod_python内建的

46、_apache模块。最好按照如下导入：from mod_python import apachemod_python.apache模块定义了如下函数和对象，更多深入的信息查看apache文档。4.5.1函数log_error(message,level,server)apache函数ap_log_error()的接口，message是错误信息，level是如下值：aplog_emergaplog_alertaplog_critaplog_erraplog_warningaplog_noticeaplog_infoaplog_debugaplog_noerrnoserver是req.server

47、对象的引用。如果没有指定则写入到缺省的日志，否则写入到对应虚拟服务器的日志中。当server没有指定时，日志级别也无效，日志级别是httpd在编译时指定的，经常为warn。如果拥有请求对象的引用，最好用req.log_error，这样将会存入请求相关信息，如源ip等。import_module(module_name,autoreload=1,log=0,path=none)mod_python的内部高级特性，用于在模块改变时自动重新载入模块。module_name是模块名，可以包含点的包名。autoreload标志查看包是否有所改变，如果改变则自动重新载入。如果log为true则这个事件会记

48、入日志。path严格指定模块的位置。例子：from mod_python import apachemymodule=apache.import_module(mymodule,log=1)allow_methods(*args)用于设置req.allowed。req.allowed是多个标志位的叠加，对应allow:头。可以在返回http_not_implemented错误之前设置。参数如下：m_getm_putm_postm_deletem_connectm_optionsm_tracem_patchm_propfindm_proppatchm_mkcolm_copym_movem_loc

49、km_unlockm_version_controlm_checkoutm_uncheckoutm_checkinm_updatem_labelm_reportm_mkworkspacem_mkactivitym_baseline_controlm_mergem_invalidexists_config_define(name)确定apache是否存在一个name配置。比如apache定义了-dfoobar则如下测试为真：apache.exists_config_define(foobar)register_cleanup(handler,data)注册一个清除行为，等同于req.regist

50、er_cleanup()或reg.server.register_cleanup()，除非服务器或请求对象不需要。config_tree()返回服务器级(server-level)配置树。这些配置不包含.htaccess文件的标志。返回的是副本，修改对配置没有效果。server_root()返回配置标志serverroot的值。make_table()一个作废的函数，可用table代替。mpm_query(code)允许查询mpm参数变量来处理线程。返回值是如下三种常量之一：ap_mpmq_not_supported=0指mpm支持线程或子进程ap_mpmq_static=1指mpm正在使用静

51、态守护线程ap_mpmq_dynamic=2指mpm正在使用动态守护线程code参数是如下值：ap_mpmq_max_daemon_used=1 最大允许使用的守护线程数量ap_mpmq_is_threaded=2 mpm是否允许使用线程ap_mpmq_is_forked=3 mpm是否可用fork生成子进程ap_mpmq_hard_limit_daemons=4 编译时允许的最大守护进程数量ap_mpmq_hard_limit_threads=5 编译时允许最大线程数量ap_mpmq_max_threads=6 threads/child配置允许的最大线程数量ap_mpmq_min_spar

52、e_daemons=7 最小剩余守护数ap_mpmq_min_spare_threads=8 最小剩余线程数ap_mpmq_max_spare_daemons=9 最大剩余守护数ap_mpmq_max_spare_threads=10 最大剩余线程数ap_mpmq_max_requests_daemon=11每个守护最大允许请求数量ap_mpmq_max_daemons=12 配置允许的最大守护数量例如：if apache.mpm_query(apache.ap_mpmq_is_threaded):# do somethingelse:# do something else4.5.2表格对象(

53、mp_table)class table(mapping-or-sequence)返回一个新的mp_table表格对象。mapping-or-sequence提供了表格的初始化数据。表格对象是对apr表格对象的包装(wrapper)。表格对象的行为(behave)非常像词典(还支持python2.2以后的in操作符)，但是有以下不同： 键和值都必须是字符串 键的查询不区分大小写 允许相同的键，即一个键对应一个列表的值很多apache的信息存储在表格中，如req.headers_in和req.headers_out。mod_python提供的所有表格对象都是真正(actual)映射(mappin

54、g)到apache结构的，所以改变表格的值也会改变apache的表格。除了(in addition to)像词典一样的行为(behavior)之外，表格对象还支持如下操作：add(key,val)这个方法允许使用相同的键，这对重复的头很有用，比如set-cookie:就需要。这个功能从3.0开始提供。4.5.3请求对象请求对象是映射到apache的request_rec结构的对象。当处理器被调用时，会传递唯一个的一个参数就是请求对象。可以为请求对象指定属性，用于在处理器之间通信。如下是方法：add_common_vars()间接调用ap_add_common_vars()函数。调用后，req.subprocess_env会包含大量的cgi信息。add_handler(htype,handler,dir)允许动态注册处理器。htype是要添加的处理器的标志，如pythonhandler，但不可以是过滤器(filter)或连接(connection)。handler是包含模块名或函数名的处理器函数。可选参数dir是需要添加到pythonpath环境变量的路径。如果未指定目录