nginx中使用perl模块

如果对于一个绝大部分内容是静态的网站，只有极少数的地方需要动态显示，碰巧你又了解一点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

需要特别注意的是不能有blocking的IO或者网络请求(比如DNS查询)，这样会严重拖累nginx的性能。一定有这种需要的话，可以参考http://zzzcpan.github.com/nginx-perl/，一个增强版的第三方perl模块。

nginx中使用perl有两种方法，一种是直接在配置文件写，还有一种是把perl脚本写在外部文件中。

Nginx 配置文件直接操作 Perl
其中 perl 和 perl_set 是第一种方法,直接给要写的子函数写到 Nginx 的文件中.语法是: perl 在 Nginx 的 localion 中,不想使用外部文件显示文件,可以使用

perl '        sub {            $r = shift;            # 正常的子函数处理            return 404; # HTTP 的响应码        }   ';

perl_set 来设置 Nginx 的变量

perl_set $value '      # value 是 nginx 本身的变量用来存 perl 语法改变的值    sub {        my $r = shift;        return "xxx";# 返回的内容会存到 $value 中         }   ';

下面主要介绍一下第二种用法。

假设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/kuerant，你应该可以在网页上看到：

Hello, You name is : kuerant

实战：
我们来使用这个来过滤我的网站,设置 15 秒的过程值
如果打开的 t 后面加的时间过期超过 15 秒的时间,就会 403 来 deny.不然正常打开网页

http://localhost/?t=1306138966

下面是 nginx 的主配置,程序就要本身

perl_set $time_check '     sub {         my $r = shift;         my $args = $r->args;         if ($args =~ /t=(d+)/){             my $time = $1;             if ( abs( $time - time() ) < 15 ){                 return 0;             }         }         return 1;     } '; keepalive_timeout  65; server {     listen       8080;     server_name  _;     root   /usr/local/nginx/html;     if ($time_check = 1){         return 403;     }     location / {         # perl  hello::handler;     }

另外：当使用 use nginx 时,会有如下的对象可以调用，可以看到上面 shift 一个对象到 $r 上,然后就可以用 $r 调用那些对象了:

$r->args – 请求的参数 .$r->discard_request_body – 这个参数是让 Nginx 放弃 request 的 body 的内容.$r->filename – 返回合适的请求文件的名字$r->has_request_body(handler) – 如果没有请求主体,返回0;但是如果请求主体存在,那么设置handler为请求主体的处理函数并返回1;在读取完请求主体后,nginx将调用指定的处理函数.请注意：handler应该以引用的方式传递。例如：package hello;use nginx;sub handler {    my $r = shift;    if ($r->request_method ne "POST") {        return DECLINED;    }    if ($r->has_request_body(&post)) {        return OK;    }    return HTTP_BAD_REQUEST;}sub post {    my $r = shift;    $r->send_http_header;    $r->print("request_body: "", $r->request_body, ""<br/>");    $r->print("request_body_file: "", $r->request_body_file, ""<br/>");    return OK;}1;__END__$r->allow_ranges - enables the use of byte ranges when sending responses.$r->discard_request_body - instructs nginx to discard the request body.$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]) – 设置变量的值

更多详情参考 http://nginx.org/en/docs/http/ngx_http_perl_module.html

欢迎转载，转载请注明文章出处，谢谢！