介紹性指南
mod_perl 是個龐大而復(fù)雜的工具，它內(nèi)建了許多模塊幫助你方便地構(gòu)建動態(tài)網(wǎng)站。這篇指南的目的是幫助你構(gòu)建一個良好的 mod_perl 模塊，并從中理解 mod_perl 的實現(xiàn)技術(shù)。我并不推薦使用這里介紹的技術(shù)來建立一個大型站點，尤其對于一個剛剛涉足 mod_perl 的人來說。但我推薦大家可以深入看一下它的一些內(nèi)建的方案，比如 mason, axkit, embperl, apache::asp 和 pagekit 等等。
你需要什么?
本指南假設(shè)你已經(jīng)有過安裝和測試 mod_perl 的經(jīng)驗。以及較新版本的 apache 的安裝經(jīng)驗。因為有可能你需要在你的機(jī)器上實現(xiàn)時適當(dāng)?shù)男薷谋疚奶峁┑呐渲谩Ｎ覀冃枰惆惭b一些模塊并且需要進(jìn)入 apache 的配置目錄作修改。所以最好你有 root 權(quán)限來做這些事情。當(dāng)然你還需要一個文本編輯器。
切入正題
mod_perl 模塊也是 perl 模塊，但它有較為特別的設(shè)計。最方便的創(chuàng)建一個 perl 模塊的方法就是使用標(biāo)準(zhǔn)的 perl 分發(fā)自帶的工具 h2xs 。你可以在命令行模式鍵入 h2xs 來看看它的參數(shù)列表。現(xiàn)在，到一個適當(dāng)?shù)哪夸涢_始一個新項目，鍵入:h2xs -ax -n apache::tutorial::firsth2xs 將會創(chuàng)建目錄 apache,以及其他一些子目錄.現(xiàn)在進(jìn)入最深一級的目錄看看:cd apache/tutorial/first在這個新目錄里面，你可以看到 6 個文件: readme, changes, first.pm, manifest, makefile.pl 和 apache-tutorial-first.t。它們的作用如下:
readme
這個文件包含一些安裝信息，模塊依賴性，版權(quán)信息等
changes
這個文件作為你的項目的修改日志（changelog）文件
first.pm
這是主模塊文件，包含你的 mod_perl 句柄代碼（handler code）。
manifest
本文件用于自動構(gòu)建 tar.gz 類型的模塊版本分發(fā)。這樣你就可以把你的模塊拿到 cpan 發(fā)布或者分發(fā)給其他人。它包含了你在這個項目中所有文件的列表。
makefile.pl
這是標(biāo)準(zhǔn)的 perl makefile 構(gòu)造器。用于創(chuàng)建 makefile.pl 文件來編譯該模塊。
apache-tutorial-first.t
針對該模塊的一些測試腳本。默認(rèn)情況下它只是檢查模塊的載入，你可以添加一些新的測試單元。好了，現(xiàn)在我們開始把first.pm變?yōu)榭晒ぷ鞯膍od_perl模塊。使用文本編輯器打開該文件，修改后的內(nèi)容如下:
|
不要忘記文件末尾的”1;”，對于perl來說，一個模塊最后返回的非零值表示該模塊已經(jīng)被成功編譯。
安裝你的模塊
h2xs 工具使我們的模塊安裝工作極為方便。在和你的 first.pm 文件相同的目錄中。鍵入:
|
make test如果 make test 成功的話，你需要以 root 身份執(zhí)行:
make install這樣你就把你的模塊安裝到了 perl 的庫目錄（library directory）。
添加該模塊為 apache 的一個句柄（handler）
現(xiàn)在我們需要進(jìn)入 apache 配置目錄來修改配置文件，使我們的模塊作為 apache 內(nèi)容處理階段的處理器。打開 httpd.conf 文件，在末尾加入如下配置:
|
然后保存配置文件，并且重新啟動 apache 服務(wù)器:
apachectl stop
apachectl start現(xiàn)在使用瀏覽器訪問http://localhost/mod_perl_tutorial，你將如期的看到顯示 “hello world” 頁面。
當(dāng) apache 啟動的時候，它讀取它的配置指令并把適當(dāng)?shù)拿顐鬟f給相應(yīng)的處理該命令的模塊。這里有兩個相關(guān)的指令 sethandler 和 perlhandler。
第一個指令 sethandler 由 mod_mime 模塊處理，該指令表示使用什么模塊作為處理請求的主要部分。這里所設(shè)置的perl-script 表示使用 mod_perl 來處理請求。
第二個指令perlhandler由mod_perl模塊來處理，它只是簡單的說明使用我們的模塊來處理請求的主要部分。有一點需要注意，無論何時在你有一個 perlhandler 時，你需要相應(yīng)的 sethandler perl-script 配置指令。這樣才能使你的 mod_perl 代碼起作用。我總是認(rèn)為這是一個弱點，但這將涉及 apache 內(nèi)部的處理機(jī)制，所以在將來這也很難改變。
現(xiàn)在請求來了，apache 查看用什么模塊來處理相應(yīng)的 uri 并且在這里決定使用 mod_perl，而 mod_perl 知道它必須把請求發(fā)送給我們的模塊，并調(diào)用我們模塊的 handler() 函數(shù)作為 apache::request 對象的第一個參數(shù)。而我們的 handler() 函數(shù)的返回值決定了下一步 apache 將要做什么?，F(xiàn)在我們知道返回值 ok 意味著一切成功。 ok是個從apache::constants 模塊導(dǎo)出的常量。
調(diào)試
如果你沒有看到 “hello world”, 那你可能看到了一個錯誤頁面，或者其他什么完全不同的。第一步去查看錯誤日志看看到底是什么發(fā)生了錯誤。我習(xí)慣于在瀏覽器中請求后立即查看錯誤日志。你可以使用 tail 工具:tail -f /path/to/apache/logs/error_log(使用你的真實 error_log 路徑替換上面的路徑。如果你不肯定它在哪里，查看你的 httpd.conf 文件的 errorlog 指令部分)
現(xiàn)在重新載入頁面，然后 error_log 將告訴你什么地方出現(xiàn)了問題。更多的關(guān)于 perl 調(diào)試，請參見 perldebug.
加入更多
現(xiàn)在如果你想要針對上面的情況作一些修改，該如何做呢？不幸的，唯一一種安裝模式如下:
修改你的 first.pm 文件
重新以 root 身份運行 make install
重新啟動 apache
這也許很麻煩，特別是重新啟動 apache。針對這個問題，我們可以另外安裝一個特別設(shè)計的模塊來避免每次這樣麻煩的做。首先你需要從 cpan 下載并安裝 apache::reload 模塊（除非你已經(jīng)使用 mod_perl 1.26 或者更高版本）。在這里 http://search.cpan.org/search?dist=apache-reload 下載。
解開 tar.gz 文件并進(jìn)入新目錄，執(zhí)行:
|
make然后到 root 身份執(zhí)行:
make install現(xiàn)在再次打開 httpd.conf 文件，加入:
perlinithandler apache::reload這將測試所有有所改變的模塊并在必要時自動重新載入新模塊。這對于開發(fā)來說很有用，但會有性能損失，所以在開發(fā)完成之后，就將該特性關(guān)閉。
閱讀更多
從這里開始你有很多事情需要去做。apache api 本身就十分龐大，大多數(shù)都可以通過 perldoc apache 看到相應(yīng)的文檔. 現(xiàn)在這個模塊基本上沒有什么價值，因為只有一個 uri 可以用于被該模塊所控制（http://server/mod_perl_tutorial），這使得它變得不夠靈活。為了使一個模塊可以處理多個 uri ，有許多解決辦法，但最好的還是推薦使用 apache::dispatch 模塊。
可以在 cpan 下載 http://search.cpan.org/search?dist=apache-dispatch. apache::dispatch 允許你保留標(biāo)準(zhǔn)的 mod_perl handler構(gòu)架，同時還允許多個函數(shù)和多個uris 被派發(fā)。
接下來我不建議象例子中一樣直接向瀏覽器輸出內(nèi)容。請考慮使用一些常用的模版技術(shù)，比如 template-toolkit, html::template, 更甚于使用 xslt 或者 xpathscript （有很多很多這樣的模版技術(shù)可選，我們希望有一天可以有文章來討論這些技術(shù)來幫助你來選擇）。
新聞熱點
疑難解答
