使用 Perl 来开发 Nginx 的模块

现在使用 Nginx 的网站多了,所以我们试下,来使用 Perl 来开发 Nginx 的模块.比如可以做一些个性的设置,防盗链,SSI ,Header 替换之类一些特别的作用.另外,我们还可以使用 Nginx 加 Perl 来做一些动态的程序的处理.我近来就想使用这个来开发 Mogilefs 的接口.

配置 Nginx 来支持动态 Perl 很容易的,当然,我们得先下 Nginx 自己来编一个.因为 Nginx 更新太快,不要使用 RPM 了…

配置和安装很容易,不细讲,经典三步

./configure --with-http_perl_module
make
make install

如果编码提示需要 ExtUtils::Embed 的话,记的使用 cpanm 来安装这个模块
 

 安装后,只要修改一下 Nginx 的配置就可以工作了,有二种方法

看如下的例子,就会了.

1. 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 中
         }
';

2.  在 Nginx 中调用外面的 Perl 来使用
直接在 server 中的 location 中配置写上 perl 处理用的模块名,语法是: 
perl 模块名::handler

第二种方法,需要在配置中写上 perl_require 在 Nginx 启动时加载什么模块,还需要用 perl_modules 来指定,从那个目录中读.如下写的是 perl/lib ,其实是指地你的安装目录下的 perl/lib 目录来找 hello.pm 这个模块.
例如:/usr/local/nginx/perl/lib

http {
  perl_modules  perl/lib;
  perl_require  hello.pm;
  
  perl_set  $msie6  '
  sub {
    my $r = shift;
    my $ua = $r->header_in("User-Agent");
    return "" if $ua =~ /Opera/;
    return "1" if $ua =~ / MSIE [6-9] \.\d+/;
    return "";
  }
 ';
  
  server {
    location / {
      perl  hello::handler;
    }
  }
}

如果我们使用第二种方法来处理,需要给 hello.pm 的模块放到 <A style="BOX-SIZING: border-box; TEXT-TRANSFORM: none; BACKGROUND-COLOR: rgb(255,255,255); TEXT-INDENT: 0px; FONT: 14px/20px 'Microsoft Yahei', 'WenQuanYi Zen Hei', SimSun; WHITE-SPACE: normal; LETTER-SPACING: normal; COLOR: rgb(51,122,183); WORD-SPACING: 0px; TEXT-DECORATION: none; -webkit-text-stroke-width: 0px" title=/usr/local/nginx/perl/lib>/usr/local/nginx/perl/lib 下.这个模块的写法,和普通的 Perl 的写法是一样的.但是有一点要注意,就是一定要 use nginx;
例如:

package hello;
use nginx;
  
sub handler {
  my $r = shift;
  $r->send_http_header('Content-Type', 'text/html; charset=utf-8');
  return OK if $r->header_only;
  
  $r->print("hello!\n
");
  $r->rflush;
  
  if (-f $r->filename or -d _) {
    $r->print($r->uri, " exists!\n");
  }
  
  return OK;
}
  
1;
__END__

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

http://www.php-oa.com:8080/?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 可以调用的对象
当我们 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]) – 设置变量的值

转载于:https://my.oschina.net/liangzi1210/blog/411402

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值