【正文】 源碼網(wǎng)整理： 源碼網(wǎng)整理： Mod_python 中文手冊 From Download 第一章 簡介 性能 使用 mod_python的主要優(yōu)勢在于比傳統(tǒng) CGI更高的性能。一個測試，使用在 Pentium 的機(jī)器上運(yùn)行 Red Hat Linux 。使用 4 種類型的腳本，基于標(biāo)準(zhǔn)的 CGI導(dǎo)入模塊 (以典型的 Python CGI腳本開始 )，然 后輸出 39。Hello!39。，測試 10000次請求作為基準(zhǔn)。 標(biāo)準(zhǔn) CGI： 23 次請求 /秒 mod_python CGI處理器： 385 次請求 /秒 mod_python 發(fā)布處理器： 476 次請求 /秒 mod_python 處理器： 1203 次請求 /秒 可移植性 apache是按照階段處理請求的 (比如：讀取請求、處理請求頭、檢查存取等 )。這些階段可以分別用處理器調(diào)用的函數(shù)來實(shí)現(xiàn)。傳統(tǒng)上，使用 C 語言編寫處理器模塊。 mod_python提供了使用 Python拜你些 apache處理器擴(kuò)展 apache功能 的方法。更多的 apache請求處理過程，參考 Apache API Notes，或者參考 Mod_pythonIntegrating Python with Apache文件。 為了方便的從 CGI移植，標(biāo)準(zhǔn)的 mod_python處理器提供了 CGI模擬環(huán)境，允許用戶不修改遺留下來的腳本，而在大多數(shù)時候無需進(jìn)行任何修改。 參考： apache開發(fā)者資源 mod_python整合 Python和 Apache，出現(xiàn)在 Python 10(?) 歷史 mod_python起源于 Httpdapy項(xiàng)目 (1997)。很久以后 Httpdapy才被叫做 mod_python，因?yàn)?Httpdapy并不是特定用于 apache服務(wù)器的。 Httpdapy設(shè)計(jì)成跨平臺的，而實(shí)際上主要從Netscape服務(wù)器開始 (追溯到 1997年的 Nsapy)。 摘錄自 Httpdapy項(xiàng)目的 README文件的描述將 Python嵌入到 apache服務(wù)器的挑戰(zhàn)與解決方法。 小字體 源碼網(wǎng)整理： 源碼網(wǎng)整理： 在我多年前開發(fā)第一個 WEB應(yīng)用程序時就發(fā)現(xiàn) CGI訪問數(shù)據(jù)庫非常慢，因?yàn)槊看吸c(diǎn)擊請求都會裝入解釋器并執(zhí)行數(shù) MB的數(shù)據(jù)。數(shù)據(jù)庫往往都很大，并將大量時間浪費(fèi)在數(shù)據(jù)庫的連接 /認(rèn)證等 意義重大 的事情上，像 DNS查詢、編碼與解碼、內(nèi)存分配等等。在應(yīng)用提速的壓力下，我嘗試過使用 Python和多種工具的綜合使用。我并不迷信微軟的 ASP，又被 Netscape的性能和滿是臭蟲而郁悶。 Cold Fusion(冷聚變 )看起來有希望，但我稍后學(xué)會了 HTML類標(biāo)簽的書寫方式，可讀性跟匯編有一拼。比如PHP。但是我真的很想用 Python來寫東西。 就在同時有關(guān) Python互聯(lián)網(wǎng) 編程的書籍出版了，其中將 Python嵌入到 Netscape服務(wù)器的方式立即引起了我的注意。我在我的項(xiàng)目中使用了這個例子，并在稍后開發(fā)了我自己的改進(jìn)版，叫做Nsapy，并在 WindowsNT和 Solaris上編譯。 盡管 Nsapy僅能工作在 Netscape服務(wù)器上，但是出于靈活通用的面向?qū)ο笤O(shè)計(jì)，在 Python精靈中，很容易移植到其他的 WEB服務(wù)器。 后來，曾經(jīng)流行的 Netscape服務(wù)器掛了，我就將 Nsapy移植到最流行的服務(wù)器 apache上。所以從 Nsapy衍生出了 Httpdapy。 繼續(xù)這個傳奇 ，你會想到將 Httpdapy移植到其他服務(wù)器上，實(shí)際上他們比預(yù)想要復(fù)雜而且枯燥。 反之，提供一個類似于 Perl語言的 apache擴(kuò)展 mod_perl一樣或更好性能的部件會更有意思。 俱往矣， mod_python的第一個版本發(fā)布于 2020年 5月。 完成 ... 第二章 安裝 注意：獲得關(guān)于安裝的幫助和其他問題的最好地方是 mod_python的郵件列表?？梢园l(fā)送標(biāo)題為subscribe的郵件到 。 先決條件 ? Python 或更新的版本，早起版本將無法使用。 ? apache 或更新的版本，如果要使用 apache ，請使用 mod_python的版本 。 編譯 mod_python需要有 apache和 Python的包含文件，并且確保安裝了 Python標(biāo)準(zhǔn)庫。如果你從源代碼安裝了 Python和 apache，那么你已經(jīng)擁有了這些了。如果你使用了預(yù)打包軟件，如RPM 或其他方式則只有二進(jìn)制版本，而沒有源碼。通常 apache和 Python的包含文件和庫文件在各自源碼網(wǎng)整理： 源碼網(wǎng)整理： 的 development包中。如果你不確定擁有這些 重要文件，請從源碼安裝 Python和 apache，或者閱讀你系統(tǒng)的文檔以了解如何獲得開發(fā)包。 編譯 有兩種鏈接 apache模塊的方式：靜態(tài)的和 DSO方式。 DSO方式現(xiàn)在非常流行，并推薦用于 mod_python的安裝。模塊被編譯成共享庫，并在運(yùn)行時動態(tài)裝入。 DSO方式的優(yōu)勢在于安裝模塊時無需重新編譯 apache。關(guān)于 DSO機(jī)制的詳細(xì)信息參見 當(dāng)前版本的 mod_python僅支持 DSO方式。 靜態(tài)鏈接是一種較老的方式 ，比動態(tài)連接的方式支持更多的平臺，但是較少使用。主要的缺陷是必須要重新編譯 apache，在很多情況下并不是一個好的選擇。 運(yùn)行 ./configure ./configure腳本將會分析你的運(yùn)行環(huán)境，并創(chuàng)建自定義的 Make文件用于你的系統(tǒng)。使用autoconf生成的 ./configure包含如下內(nèi)容： ? 查看 apxs程序是否存在。這個程序作為 apache標(biāo)準(zhǔn)發(fā)行版的一部分提供 DSO支持。如果找不到則無法實(shí)現(xiàn) DSO功能。使用 withapxs指定選項(xiàng)： $ ./configure withapxs=/usr/local/apache/bin/apxs 強(qiáng)烈建議使用這個選項(xiàng)。 ? 檢查 Python版本，并嘗試找到 libpython參數(shù)變量的二進(jìn)制發(fā)行版。缺省時可以在Path變量中找到 python。如果找到的首個 python二進(jìn)制版本不適合 mod_python，則可以手動指定 python的路徑使用 withpython，如： $ ./configure withpython=/usr/local/bin/ ? 設(shè)置 mod_python保留的互斥鎖數(shù)量。在某些系統(tǒng)中，互斥鎖是一種有 限的資源。增加最大互斥鎖數(shù)量將會增加使用 session鎖定的性能。缺省值是 8，一個性能不錯的數(shù)值是32。使用 withmaxlocks選項(xiàng)： $ ./configure withmaxlocks=32 這個選項(xiàng)是在 版本開始提供的。 ? 嘗試查找 flex并確定版本。如果 PATH中找不到 flex則 configure會出錯。如果版本不對則會給出警告。一般可以忽略這個警告，除非需要重新創(chuàng)建 src/。剖析器(parser)會被 PSP調(diào)用，使用 flex的 C 語言書寫。要求的版本是 ，在大多數(shù)平臺上 并不合適。所以已經(jīng)源碼里已經(jīng)包含了一個 的副本。如果需要編譯src/ 則需要獲取正確版本的 flex。如果 PATH中的 flex版本有誤，則可用 withflex選項(xiàng)： $ ./configure withflex=/usr/local/bin/flex 源碼網(wǎng)整理： 源碼網(wǎng)整理： 這是 版本中的新特性 ? 構(gòu)建 mod_python文檔時需要用到 python的源代碼?？梢匀绻恍枰臋n，可以忽略這個選項(xiàng)。如果需要則用 withpythonsrc 選項(xiàng)： $ ./configure withpythonsrc=/usr/src/ 這個是 版本中的新特性 運(yùn)行 make 開始構(gòu)建過程，簡單的運(yùn)行如下即可： $ make 安裝 運(yùn)行 make install 這個安裝過程必須在 root用戶下完成： $ su make install 這將會簡單的將二進(jìn)制版本復(fù)制到 apache的 libexec目錄。 并且會安裝 pythonlibraries到 sitepackages并編譯他們。 如果你想 只安裝 python庫或者只安裝 DSO，可以用如下 make目標(biāo)： make install_py_lib make install_dso 配置 apache 按照 DSO模式安裝的 apache，需要在 mod_python的句子： LoadModule python_module libexec/ 實(shí)際的 路徑可能有所變化，但是 make install將會顯示這個文件的確切路徑。 測試 注意次部分內(nèi)容僅適用于 ，如果使用 ，你需要找到更適合的文檔。 ? 創(chuàng)建一個在 WEB站點(diǎn)可見的目錄，如 htdocs/test。 ? 在 .htaccess 文件中添加如下內(nèi)容。如果是在 .htaccess 文件中，則無需 Directory標(biāo)簽。并且確保 AllowOverride目標(biāo)至少包含F(xiàn)ileInfo，缺省是 None，將會無法工作。 Directory /APACHEHOME/htdocs/test AddHandler mod_python .py 源碼網(wǎng)整理： 源碼網(wǎng)整理： PythonHandler mptest PythonDebug On /Directory ? 重定向所有以 .py結(jié)尾的 URL到 mod_python處理器。 mod_python收到請求之后查找合適的處理器來處理請求。這里有個簡單的自定義處理器叫 mptest。我們看看如何定義這個處理器。 ? 此時如果修改了主配置文件 apache來使之生效。 ? 編輯 htdocs/test目錄。 from mod_python import apache def handler(req): =39。text/plain39。 (Hello, world!) return ? 指向 URL路徑到 。將會看到 Hello, world!。如果看不到則參考故障處理。 ? 依照配置文件的規(guī)則，指定任何 .py文件都會最終指向 。因?yàn)橐呀?jīng)明確的指定了 mptest做處理器。如果需要用不同的處理器處理不同的文件則需要更高層的處理器，比如 publisher發(fā)布器、 mpservlets 或 vampire。這些都是動態(tài)裝 入的處理器。 ? 如果都運(yùn)行無誤則轉(zhuǎn)入第三章，入門。 參考： 故障處理 如果出現(xiàn)問題，可以按照如下的處理： ? 檢查錯誤輸出 ? 檢查服務(wù)器錯誤日志 ? 單處理執(zhí)行 apache $ ./d X 這樣將會顯示更多有用信息 ? 從 開始，可以使用 置。添加到 ： Location /mpinfo 源碼網(wǎng)整理： 源碼網(wǎng)整理： SetHandler mod_python PythonHandler /Location 這時指向你的 /mpinfo 的 URL則會顯示一些信息幫助處理 mod_python的問題。 ? 在 mod_python郵件列表提問，并確保提供如下信息： mod_python版本 操作系統(tǒng)類型、名字、版本號 Python版本、非常規(guī)的編輯選項(xiàng) apache服務(wù)器版本 相關(guān)的 apache配置， .htaccess 相關(guān) 的 Python代碼 完成 ... 第三章 指南 使用發(fā)布器 (Publisher)的快速例子 這一節(jié)提供無需太多細(xì)節(jié)的發(fā)布器指南。更多如何使用 mod_python處理器的細(xì)節(jié)將在以后解釋。 發(fā)布器 (publisher)提供了發(fā)布 mod_python標(biāo)準(zhǔn)模塊的方式。需要在配置文件中加入如下配置： AddHandler mod_python .py PythonHandler PythonDebug On 下例會返回簡單的表單數(shù)據(jù)。詢問姓名、電子郵件、注釋之后 將會給管理員發(fā)郵件。這個簡單的應(yīng)用程序由兩個文件組成： ， 。 如下是表單： html Please provide feedback below: p form action= method=POST 源碼網(wǎng)整理： 源碼網(wǎng)整理： Name: input type=text name=namebr Email: input type=text name=br Comment: textarea name=ment rows=4 cols=20/textareabr input type=submit /form /html 注意表單的 action屬性指向 ，如下創(chuàng)建 ，如下： import smtplib WEBMASTER=webmaster 管理員電郵 SMTP_SERVER=localhost 本機(jī) SMTP服務(wù)器 def (req,name,,ment): 一定要確保用戶提 供了所有的參數(shù) if not(name and