简介：
　　这是一套运行在nginx + perl环境下的的web框架，可以像java的servlet那样的写服务或简单网页。

 入门步骤：

  1. 安装nginx时增加perl模块参数，使nginx支持perl模块。
  2. nginx.conf里配置一个perl的模块路径，配置npweb服务入口。
  3. 写一个helloworld，即完成了npweb的试用。
  4. 具体操作请看相关文章。

 适用业务：

  1. 可以用来做memcache的web接口
  2. 可以用来做mysql数据库的web接口
  3. 可以用来做ajax数据接口
  4. 可以用来做xml接口
  5. 一切简单的高效的接口都可以用这个来开发 

----------------------------------------------------------------------------------------------------------------------

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。