簡介:
  這是一套運行在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。