简介:
这是一套运行在nginx + perl环境下的的web框架,可以像java的servlet那样的写服务或简单网页。
入门步骤:
- 安装nginx时增加perl模块参数,使nginx支持perl模块。
- nginx.conf里配置一个perl的模块路径,配置npweb服务入口。
- 写一个helloworld,即完成了npweb的试用。
- 具体操作请看相关文章。
适用业务:
- 可以用来做memcache的web接口
- 可以用来做mysql数据库的web接口
- 可以用来做ajax数据接口
- 可以用来做xml接口
- 一切简单的高效的接口都可以用这个来开发
----------------------------------------------------------------------------------------------------------------------
Npweb入门示例
如果按步骤来做并且不出问题,那么你将体验到npweb的乐趣。
第一步:安装nginx,以下是安装脚本,如果安装正常就进入第二步。
# 准备目录 mkdir -p /opt/src/nginx mkdir -p /opt/modules/nginx-0.7.65 cd /opt/src/nginx
# 准备依赖包 yum install gcc -y yum install pcre-devel -y yum install openssl-devel -y yum install zlib-devel -y
# 准备依赖程序 wget http://github.com/gnosek/nginx-upstream-fair/tarball/master tar -xzvf gnosek-nginx-upstream-fair-2131c73.tar.gz mv gnosek-nginx-upstream-fair-2131c73 /opt/modules/
# 下载nginx wget http://nginx.org/download/nginx-0.7.65.tar.gz tar -xzvf nginx-0.7.65.tar.gz cd nginx-0.7.65
# 配置 ./configure --prefix=/opt/modules/nginx-0.7.65 \ --with-http_stub_status_module \ --with-http_perl_module \ --with-http_addition_module \ --with-http_realip_module \ --with-http_sub_module \ --add-module=/opt/modules/gnosek-nginx-upstream-fair-2131c73
# 安装 make make install |
第二步:部署npweb框架
Npweb框架非常简洁,只有一个文件(Action.pm),只要将这个文件置于一个能让nginx有权限访问内部文件的文件夹即可。
这里我们将框架部署到/opt/npweb。
第三步:编写hello.pm,并将文件放置在/opt/npweb_app目录下。
/opt/npweb_app目录是你开发的web程序的目录,其中需要放置一个lib目录以保存自定义的一些pm模块,在示例中的RequestUtil就是其中的一个模块。
文件内容如下:
package hello; # 此处很关键,一定要与文件名保持一致!!!!!!!! use RequestUtil; # 此处引入了一个外部模块
sub doExecute { ($r) = @_; $r->send_http_header("text/html");
# 取得参数的 Map------------------------------------------------------ my %param = RequestUtil::params( $r->args );
# 获得具体参数 my $w = $param{'w'};
# 回显 $r->print("hellow " . $w); } # 文件结尾必需加这个,perl语法规定的。 1; |
第四步:配置nginx.conf,这一步是很关键的,主要是将框架和webapp配置到nginx下,以达到访问功能的作用。
#user nobody; #worker_processes 1; worker_processes 2;
#error_log logs/error.log; #error_log logs/error.log notice; #error_log logs/error.log info;
#pid logs/nginx.pid;
worker_rlimit_nofile 65535; events { use epoll; worker_connections 65535; }
http {
include mime.types; default_type application/octet-stream;
server_names_hash_bucket_size 128; client_header_buffer_size 32k; large_client_header_buffers 4 32k; client_max_body_size 8m;
#log_format main '$remote_addr - $remote_user [$time_local] "$request" ' # '$status $body_bytes_sent "$http_referer" ' # '"$http_user_agent" "$http_x_forwarded_for"';
#access_log logs/access.log main;
sendfile on; tcp_nopush on;
keepalive_timeout 0;
gzip on; gzip_min_length 1k; gzip_buffers 4 16k; gzip_http_version 1.0; gzip_comp_level 2; gzip_types text/plain application/x-javascript text/css application/xml; gzip_vary on; # 此处开始配置 perl_modules /opt/npweb; #框架的目录 perl_require Action.pm; #框架的入口
server{ # 此处配置框架的设置 set $CONTEXT_PATH '/perl'; # uri的访问路径,如:http:// test.perl.nginx /perl set $APPLICATION_PATH '/opt/npweb_app/'; # web服务的路径,在该路径下需要放置一个lib目录,以放置一些自自定模块。
listen 80;
server_name test.perl.nginx; location /perl { # 此处需与$CONTEXT_PATH保持一致 perl Action::execute; # 此处如此配置,不用更改 } }
} |
第五步:访问http://test.perl.nginx/perl/hello?w=world,如果网页上回显了您输入的参数,那么恭喜您,您的第一个npweb程序成功了。
针对第五步的补充:需要将test.perl.nginx指向你所部署的服务器IP。推荐使用Windows Hosts Editor。
附件 “npweb入门.rar” 中包括示例的代码及npweb的框架代码