nginx中使用perl模块
kevin.Zhu 发布于:2022-3-4 11:40 分类:文摘 有 18 人浏览,获得评论 0 条
https://blog.huati365.com/82b305660b3eca40
如果对于一个绝大部分内容是静态的网站,只有极少数的地方需要动态显示,碰巧你又了解一点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
欢迎转载,转载请注明文章出处,谢谢!