nginx中使用perl模塊

轉載自：http://www.netingcn.com/nginx-perl.html

如果對於一個絕大部分內容是靜態的網站，只有極少數的地方需要動態顯示，碰巧你又了解一點perl知識，那么nginx + perl的結合就能很好解決問題。要想nginx支持perl腳本，在編譯nginx時候需要如下參數：

./configure --with-http_perl_module

如果make時候出現如下類似錯誤：
Can’t locate ExtUtils/Embed.pm in @INC (@INC contains: /usr/lib/perl5/5.10.0/i386-linux-thread-multi /usr/lib/perl5/5.10.0 /usr/local/lib/perl5/site_perl/5.10.0/i386-linux-thread-multi /usr/local/lib/perl5/site_perl/5.10.0 /usr/lib/perl5/vendor_perl/5.10.0/i386-linux-thread-multi /usr/lib/perl5/vendor_perl/5.10.0 /usr/lib/perl5/vendor_perl /usr/local/lib/perl5/site_perl .)

你的機器上可能需要安裝perl-devel perl-ExtUtils-Embed，對於centos系統，直接使用yum搞定，例如：

yum -y install perl-devel perl-ExtUtils-Embed

nginx中使用perl有兩種方法，一種是直接在配置文件寫，還有一種是把perl腳本寫在外部文件中，下面主要介紹一下第二種用法。

假設nginx的根目錄為/usr/local/nginx，perl腳本存放的目錄為nginx的根目錄下的perl/lib下，腳本名字為test.pm，nginx配置為：

#位於http配置中
	perl_modules  perl/lib;
	perl_require  test.pm;
	
#位於server配置中	
		location /user/ {
			perl pkg_name::process;
		}

上述配置是把所有來自http://servername/user/下的請求交由test.pm腳本中定義的process方法來處理。

test.pm腳本的內容如下：

package pkg_name;

use Time::Local;
use nginx;

sub process {
    my $r = shift;
	
    $r->send_http_header('text/html; charset=utf-8');
    my @arr = split('/', $r->uri);
    my $username = @arr[2];
   
    if (!$username || ($username eq "")) {
		$username = "Anonymous";
    }
    
    $r->print('Hello, You name is : ' . $username . ''); 
	$r->rflush();
	return;
}

1;
__END__

當你訪問http://servername/user/netingcn，你應該可以在網頁上看到：

Hello, You name is : netingcn

另外：當使用 use nginx 時,會有如下的對象可以調用，可以看到上面 shift 一個對象到 $r 上,然后就可以用 $r 調用那些對象了:

$r->args – 請求的參數 .
$r->discard_request_body – 這個參數是讓 Nginx 放棄 request 的 body 的內容.
$r->filename – 返回合適的請求文件的名字
$r->has_request_body(function) – 如果沒有請求主體,返回0,但是如果請求主體存在,那么建立傳遞的函數並返回1,在程序的最后,nginx將調用指定的處理器.
$r->header_in(header) – 查找請求頭的信息
$r->header_only – 如果我們只要返回一個響應的頭
$r->header_out(header, value) – 設置響應的頭
$r->internal_redirect(uri) – 使內部重定向到指定的URI,重定向僅在完成perl腳本后發生.可以使用 header_out(Location….的方法來讓瀏覽器自己重定向
$r->print(args, …) – 發送數據給客戶端
$r->request_body – 得到客戶端提交過來的內容 （body 的參數,可能需要修改 nginx 的 client_body_buffer_size. ）
$r->request_body_file —給客戶的 body 存成文件,並返回文件名
$r->request_method — 得到請求 HTTP method.
$r->remote_addr – 得到客戶端的 IP 地址.
$r->rflush – 立即傳送數據給客戶端
$r->sendfile(file [, displacement [, length ] ) – 傳送給客戶端指定文件的內容,可選的參數表明只傳送數據的偏移量與長度,精確的傳遞僅在perl腳本執行完畢后生效.這可是所謂的高級功能啊
$r->send_http_header(type) – 添加一個回應的 http 頭的信息
$r->sleep(milliseconds, handler) – 設置為請求在指定的時間使用指定的處理方法和停止處理,在此期間nginx將繼續處理其他的請求,超過指定的時間后,nginx將運行安裝的處理方法,注意你需要為處理方法通過一個reference,在處理器間轉發數據你可以使用$r->variable().
$r->status(code) – 設置 http 的響應碼
$r->unescape(text) – 使用 http 方法加密內容如 %XX
$r->uri – 得到請求的 URL.
$r->variable(name[, value]) – 設置變量的值