計(jì)算機(jī)軟件及應(yīng)用]mod_python328中文手冊(cè)(編輯修改稿)

　

【文章內(nèi)容簡(jiǎn)介】 TABLE 406 HTTP_PROXY_AUTHENTICATION_REQUIRED 407 HTTP_REQUEST_TIME_OUT 408 HTTP_CONFLICT 409 HTTP_GONE 410 HTTP_LENGTH_REQUIRED 411 HTTP_PRECONDITION_FAILED 412 HTTP_REQUEST_ENTITY_TOO_LARGE 413 HTTP_REQUEST_URI_TOO_LARGE 414 HTTP_UNSUPPORTED_MEDIA_TYPE 415 HTTP_RANGE_NOT_SATISFIABLE 416 HTTP_EXPECTATION_FAILED 417 HTTP_UNPROCESSABLE_ENTITY 422 HTTP_LOCKED 423 HTTP_FAILED_DEPENDENCY 424 HTTP_INTERNAL_SERVER_ERROR 500 HTTP_NOT_IMPLEMENTED 501 HTTP_BAD_GATEWAY 502 HTTP_SERVICE_UNAVAILABLE 503 HTTP_GATEWAY_TIME_OUT 504 HTTP_VERSION_NOT_SUPPORTED 505 HTTP_VARIANT_ALSO_VARIES 506 HTTP_INSUFFICIENT_STORAGE 507 HTTP_NOT_EXTENDED 510 可以通過(guò)拋出 ，并將 HTTP錯(cuò)誤碼作為異常的參數(shù)。例如： raise , 處理器可以通過(guò) ()方法將文檔發(fā)送到客戶端。 客戶端提交的數(shù)據(jù)可以通過(guò) ()讀取。 注意： Python*Handler所在的目錄必須已經(jīng)在 ，如果沒(méi)有在 Directory配置段指定則不會(huì)在。 一 個(gè)請(qǐng)求處理器的例子： from mod_python import apache def requesthandler(req): =39。text/plain39。 (39。Hello World!39。) return (filter)處理器 過(guò)濾處理器可以改變服務(wù)器的輸入和輸出。分兩種：輸入和輸出的過(guò)濾。現(xiàn)在 mod_python僅提供請(qǐng)求級(jí)別 (requestlevel)的過(guò)濾器，就是 HTTP的請(qǐng)求和回應(yīng)體可以被過(guò)濾。未來(lái)的 apache將會(huì)提供連接級(jí)別(connectionlevel)的過(guò)濾器。 過(guò)濾處理器接收一個(gè) filter對(duì)象做參數(shù)，請(qǐng)求對(duì)象可經(jīng)由此得出，但是所有的讀寫(xiě)動(dòng)作必須經(jīng)由 filter的方法。 過(guò)濾器在讀到 None時(shí)需要被關(guān)閉，代表流的結(jié)束。過(guò)濾器的返回值將會(huì)被忽略，但可用 ()方法達(dá)到同樣的效果。 過(guò)濾器必須一開(kāi)始就注冊(cè)為 PythonInputFilter或PythonOutputFilter，然后添加到 apache的配置標(biāo)志Add/SetInputFilter或 Add/SetOutputFilter。 如下例子把所有 .py結(jié)尾文件用 CAPITALIZE過(guò)濾器處理，如下是配置： PythonOutputFilter capitalize CAPITALIZE AddOutputFilter CAPTITALIZE .py 如下是文件 ： from mod_python import apache def outputfilter(filter): s=() while s: (()) s=() if s is None: () 書(shū)寫(xiě)過(guò)濾器時(shí)應(yīng)該注意到過(guò)濾器隨時(shí)都會(huì)被調(diào)用。過(guò)濾器無(wú)法控制數(shù)據(jù)的總量，也無(wú)法確定請(qǐng)求何時(shí)調(diào)用。比如對(duì)于一個(gè)請(qǐng)求，過(guò)濾器可能會(huì)執(zhí)行一次或五次，并無(wú)法知曉調(diào)用何時(shí)結(jié)束和先后順序。從一個(gè) read操作返回的 EOS代表請(qǐng)求的結(jié)束。 過(guò)濾器也可能在子請(qǐng)求的遞歸調(diào)用中。為避免數(shù)據(jù)多次被改變，經(jīng)常的確保并不在子請(qǐng)求中，依靠 。 (connection)處理器 連接處理器處理連接到服務(wù)器的 TCP連接。不同于 HTTP處理器，連接處理器接收 connection對(duì)象做參數(shù)。連接處理器可以用于實(shí)現(xiàn)協(xié)議。如下例配置： PythonConnectionHandler echo 實(shí)現(xiàn)文件 ： from mod_python import apache def connectionhandler(conn): while 1: (()) return Apache內(nèi)部 apache內(nèi)部對(duì) Python的接口也恰好叫做 apache，在 mod_python包。提供了連接 apache內(nèi)部的重要功能，比如有用的函數(shù)，文檔等 (request對(duì)象也提供訪問(wèn) Apache內(nèi)部的接口，但不在本節(jié) )。 apache模塊僅可作為 mod_python下的一個(gè)腳本來(lái)導(dǎo)入，因?yàn)樗蕾囉趍od_python內(nèi)建的 _apache模塊。最好按照如下導(dǎo)入： from mod_python import apache ，更多深入的信息查看Apache文檔。 log_error(message[,level,server]) Apache函數(shù) ap_log_error()的接口， message是錯(cuò)誤信息， level是如下值： APLOG_EMERG APLOG_ALERT APLOG_CRIT APLOG_ERR APLOG_WARNING APLOG_NOTICE APLOG_INFO APLOG_DEBUG APLOG_NOERRNO server是 。如果沒(méi)有指定則寫(xiě)入到缺省的日志，否則寫(xiě)入到對(duì)應(yīng)虛擬服務(wù)器的日志中。當(dāng) server沒(méi)有指定時(shí)，日志級(jí)別也無(wú)效，日志級(jí)別是 d在編譯時(shí)指定的，經(jīng)常為 warn。 如果擁有請(qǐng)求對(duì)象的引用，最好用 ，這樣將會(huì)存入請(qǐng)求相關(guān)信息，如源 IP等。 import_module(module_name[,autoreload=1,log=0,path=None]) mod_python的內(nèi)部高級(jí)特性，用于在模塊改變時(shí)自動(dòng)重新載入模塊。 module_name是模塊名，可以包含點(diǎn)的包名。 autoreload標(biāo)志查看包是否有所改變，如果改變則自動(dòng)重新載入。 如果 log為 True則這個(gè)事件會(huì)記入日志。 path嚴(yán)格指定 模塊的位置。 例子： from mod_python import apache mymodule=(39。mymodule39。,log=1) allow_methods([*args]) 用于設(shè)置 。 ，對(duì)應(yīng)39。Allow:39。頭。可以在返回 HTTP_NOT_IMPLEMENTED錯(cuò)誤之前設(shè)置。參數(shù)如下： M_GET M_PUT M_POST M_DELETE M_CONNECT M_OPTIONS M_TRACE M_PATCH M_PROPFIND M_PROPPATCH M_MKCOL M_COPY M_MOVE M_LOCK M_UNLOCK M_VERSION_CONTROL M_CHECKOUT M_UNCHECKOUT M_CHECKIN M_UPDATE M_LABEL M_REPORT M_MKWORKSPACE M_MKACTIVITY M_BASELINE_CONTROL M_MERGE M_INVALID exists_config_define(name) 確定 Apache是否存在一個(gè) name配 置。比如 Apache定義了 DFOOBAR則如下測(cè)試為真： (39。FOOBAR39。) register_cleanup(handler[,data]) 注冊(cè)一個(gè)清除行為，等同于 ()或()，除非服務(wù)器或請(qǐng)求對(duì)象不需要。 config_tree() 返回服務(wù)器級(jí) (serverlevel)配置樹(shù)。這些配置不包含 .htaccess文件的標(biāo)志。返回的是副本，修改對(duì)配置沒(méi)有效 果。 server_root() 返回配置標(biāo)志 39。ServerRoot39。的值。 make_table() 一個(gè)作廢的函數(shù)，可用 table代替。 mpm_query(code) 允許查詢 MPM參數(shù)變量來(lái)處理線程。返回值是如下三種常量之一： AP_MPMQ_NOT_SUPPORTED=0 指 MPM支持線程或子進(jìn)程 AP_MPMQ_STATIC=1 指 MPM正在使用靜態(tài)守護(hù)線程 AP_MPMQ_DYNAMIC=2 指 MPM正在使用動(dòng)態(tài)守護(hù)線程 code參數(shù)是如下值： AP_MPMQ_MAX_DAEMON_USED=1 最大允許使用的守護(hù)線程數(shù)量 AP_MPMQ_IS_THREADED=2 MPM是否允許使用線程 AP_MPMQ_IS_FORKED=3 MPM是否可用 fork生成子進(jìn)程 AP_MPMQ_HARD_LIMIT_DAEMONS=4 編譯時(shí)允許的最大守護(hù)進(jìn)程數(shù)量 AP_MPMQ_HARD_LIMIT_THREADS=5 編譯時(shí)允許最大線程數(shù)量 AP_MPMQ_MAX_THREADS=6 threads/child配置允許的最大線程數(shù)量 AP_MPMQ_MIN_SPARE_DAEMONS=7 最小剩余守護(hù)數(shù) AP_MPMQ_MIN_SPARE_THREADS=8 最小剩余線程數(shù) AP_MPMQ_MAX_SPARE_DAEMONS=9 最大剩余守護(hù)數(shù) AP_MPMQ_MAX_SPARE_THREADS=10 最大剩余線程數(shù) AP_MPMQ_MAX_REQUESTS_DAEMON=11每個(gè)守護(hù)最大允許請(qǐng)求數(shù)量 AP_MPMQ_MAX_DAEMONS=12 配置允許的最大守護(hù)數(shù)量 例如： if (): do something else: do something else (mp_table) class table([mappingorsequence]) 返回一個(gè)新的 mp_table表格對(duì)象。 mappingorsequence提供了表格的初始化數(shù)據(jù)。表格對(duì)象是對(duì) APR表格對(duì)象的包裝 (wrapper)。表格對(duì)象的行為 (behave)非常像詞典 (還支持 in操作符 )，但是有以下不同： ? 鍵和值都必須是字符串 ? 鍵的查詢不區(qū)分大小寫(xiě) ? 允許相同的鍵，即一個(gè)鍵對(duì)應(yīng)一個(gè)列表的值 很多 apache的信息存儲(chǔ)在表格中，如 。 mod_python提供的所有表格對(duì)象都是真正 (actual)映射 (mapping)到 apache結(jié)構(gòu)的，所以改變表格的值也會(huì)改變 apache的表格。 除了 (in addition to)像詞典一樣的行為 (behavior)之外，表格對(duì)象還支持如下操作： add(key,val) 這個(gè)方法允許使用相同的鍵，這對(duì)重復(fù)的頭很有用，比如 SetCookie:就需要。這個(gè)功能從 。 請(qǐng)求對(duì)象是映 射到 apache的 request_rec結(jié)構(gòu)的對(duì)象。當(dāng)處理器被調(diào)用時(shí)，會(huì)傳遞唯一個(gè)的一個(gè)參數(shù)就是請(qǐng)求對(duì)象。可以為請(qǐng)求對(duì)象指定屬性，用于在處理器之間通信。如下是方法： add_mon_vars() 間接調(diào)用 ap_add_mon_vars()函數(shù)。調(diào)用后， CGI信息。 add_handler(htype,handler[,dir]) 允許動(dòng)態(tài)注冊(cè)處理器。 htype是要添加的處理器的標(biāo)志，如39。PythonHandler39。，但不可以是過(guò)濾器 (filter)或連接 (connection)。handler是包含模塊名或函數(shù)名的處理器函數(shù)。可選參數(shù) dir是需要添加到pythonpath環(huán)境變量的路徑。如果未指定目錄，而且有同類型的處理器，則繼承路徑，否則用前一路徑。如果有 PythonPath標(biāo)志存在，則 會(huì)設(shè)置為它。 通過(guò)這種方式添加的處理器生存期為這個(gè)請(qǐng)求。為同一個(gè)類型添加多個(gè)處理器是很有用的，不過(guò)要注意避免死循環(huán) (infinite loop)。 動(dòng)態(tài)注冊(cè)處理器是一種很有用的技術(shù)，比如用于PythonAuthenHandler，可以為不同的認(rèn)證級(jí) 別指定不同的權(quán)限。如： if manager: (PythonHandler,menu::admin) else: (PythonHandler,menu::basic) 注意，如果傳遞了一個(gè)無(wú)效處理器，則會(huì)在尋找處理器時(shí)發(fā)生異常。 allow_methods(methods[,reset]) 添加方法到 。這個(gè)列表將會(huì)允許傳遞，在頭部指定 HTTP_METHOD_NOT_ALLOWED或 HTTP_NOT_IMPLEMENTED返回到客戶端。注意 apache并不會(huì)對(duì)這些方法起作用。這個(gè)列表僅僅用于構(gòu)造頭部。實(shí)際的方法處理邏輯在處理器代碼中提供。 methods是一個(gè)字符串列表，如果 reset設(shè)置為 1，則列表會(huì)被清空。 document_root() 返回 DocumentRoot設(shè)置 get_basic_auth_pw() 返回簡(jiǎn)單認(rèn)證時(shí)的密碼字符串 get_config() 返回包含 mod_python配置的表格對(duì)象的引用，用于當(dāng)前請(qǐng)求，除了Python*Handler和 PythonOption(可以通過(guò) ()獲得 )。表格