Nginx+perl的web框架（Npweb ）

陈银山

　　简介：
　　这是一套运行在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的框架代码