Introduction

A distribution of Nginx with c++,python,lua java and php web development.

hi-nginx-demo.

hi-nginx-doc.

Features

• All features of nginx(latest release) are inherited, i.e., it is 100% compatible with nginx.

Branch

• master
• only-cpp
• only-python
• only-php
• no-java

python and lua api

hi_req

• uri
• method
• client
• param
• user_agent
• has_header
• get_header
• has_form
• get_form
• has_session
• get_session
• has_cookie
• get_cookie

hi_res

• status
• content
• header
• session

hello,world

cpp servlet class

#include "servlet.hpp"
namespace hi{
class hello : public servlet {
    public:

        void handler(request& req, response& res) {
            res.headers.find("Content-Type")->second = "text/plain;charset=UTF-8";
            res.content = "hello,world";
            res.status = 200;
        }

    };
}

extern "C" hi::servlet* create() {
    return new hi::hello();
}

extern "C" void destroy(hi::servlet* p) {
    delete p;
}

cpp compile

g++ -std=c++11 -I/usr/local/nginx/include  -shared -fPIC hello.cpp -o hello.so
install hello.so /usr/local/nginx/hi

java servlet class

package hi;

public class jhello implements hi.servlet {

    public jhello() {

    }

    public void handler(hi.request req, hi.response res) {
        res.status = 200;
        res.content = "hello,world";

    }
}

java compile

${JAVA_HOME}/bin/javac -classpath .:${NGINX_INSTALL_DIR}/java/hi-nginx-java.jar hi/jhello.java

php servlet class

see php/hi/request.php,php/hi/response.php and php/hi/servlet.php

<?php

require_once 'hi/servlet.php';

class hello implements \hi\servlet {

    public function handler(\hi\request &$req, \hi\response &$res) {
        $res->content = 'hello,world';
        $res->status = 200;
    }

}

php demo

see contrbi/php

Dependency

• linux
• gcc,g++(c++11)
• hiredis-devel
• python-devel
• boost-devel
• luajit-devel
• jdk 1.1,1.2,1.4,1.6,1.8,9
• PHP 7.0 or later(--enable-embed=shared)

centos

sudo yum install gcc gcc-c++ make pcre-devel zlib-devel openssl-devel hiredis-devel python-devel boost-devel luajit-devel

ubuntu

sudo apt-get install build-essential libpcre3-dev zlib1g-dev libssl-dev libhiredis-dev python-dev libboost-all-dev libluajit-5.1-dev 

About jdk 9 install

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk selfupdate force
sdk install java 9.0.1-oracle

Create the file /etc/ld.so.conf.d/java.conf with the following entries，replace $JAVA_HOME as true path:

$JAVA_HOME/lib/
$JAVA_HOME/lib/server

then

sudo ldconfig

About php7+ install

Please change configure :

ac_fn_c_check_decl "$LINENO" "isfinite" "ac_cv_have_decl_isfinite" "#include <math.h>
"
if test "x$ac_cv_have_decl_isfinite" = xyes; then :
  ac_have_decl=0
else
  ac_have_decl=0
fi

and with --enable-embed.

Installation

see install_demo.sh or --add-module=ngx_http_hi_module

3rd party module

• array-var-nginx-module
• form-input-nginx-module
• headers-more-nginx-module
• iconv-nginx-module
• memc-nginx-module
• ngx_coolkit
• ngx_devel_kit
• rds-csv-nginx-module
• rds-json-nginx-module
• redis2-nginx-module
• set-misc-nginx-module
• srcache-nginx-module
• xss-nginx-module
• nginx-http-concat
• nginx-push-stream-module
• nginx-rtmp-module
• nchan
• echo-nginx-module
• nginx-upload-module

ngx_http_hi_module directives

• directives : content: loc,if in loc

  • hi,default: ""

  example:

            location = /hello {
                hi hi/hello.so ;
            }

• directives : content: http,srv,loc,if in loc ,if in srv

  • hi_need_cache,default: on

  example:

        hi_need_cache on|off;

• directives : content: http,srv,loc,if in loc ,if in srv

  • hi_cache_size,default: 10

  example:

        hi_cache_size 10;

• directives : content: http,srv,loc,if in loc ,if in srv

  • hi_cache_expires,default: 300s

  example:

        hi_cache_expires 300s;

• directives : content: http,srv,loc,if in loc ,if in srv

  • hi_need_headers,default: off

    example:

        hi_need_headers on|off;

• directives : content: http,srv,loc,if in loc ,if in srv

  • hi_need_cookies,default: off

    example:

        hi_need_cookies on|off;

• directives : content: http,srv,loc,if in loc ,if in srv

  • hi_need_session,default: off

    example:

        hi_need_session on|off;

• directives : content: http,srv,loc,if in loc ,if in srv

  • hi_session_expires,default: 300s

  example:

        hi_session_expires 300s;

• directives : content: http,srv ,if in srv

  • hi_redis_host,default: ""

  example:

        hi_redis_host 127.0.0.1;

• directives : content: http,srv,if in srv

  • hi_redis_port,default: 0

  example:

        hi_redis_port 6379;

• directives : content: loc,if in loc

  • hi_python_content,default: ""

  example:

            location = /pyecho {
                hi_python_content "hi_res.status(200)\nhi_res.content('hello,world')" ;
            }

• directives : content: loc,if in loc

  • hi_python_script,default: ""

  example:

            location ~ \.py$  {
                hi_python_script python;
            }

• directives : content: loc,if in loc

  • hi_lua_content,default: ""

  example:

            location = /luaecho {
                hi_lua_content "hi_res:status(200)\nhi_res:content('hello,world')" ;
            }

• directives : content: loc,if in loc

  • hi_lua_script,default: ""

  example:

            location ~ \.lua$  {
                hi_lua_script lua;
            }

• directives : content: http,srv,if in srv

  • hi_java_classpath,default:"-Djava.class.path=."

  example:

hi_java_classpath "-Djava.class.path=.:/usr/local/nginx/java:/usr/local/nginx/java/hi-nginx-java.jar";

• directives : content: http,srv,if in srv

  • hi_java_options,default:"-server -d64 -Xmx1G -Xms1G -Xmn256m"

  example:

hi_java_options""-server -d64 -Xmx3G -Xms3G -Xmn768m -XX:+DisableExplicitGC -XX:+UseConcMarkSweepGC -XX:+UseParNewGC -XX:+UseNUMA -XX:+CMSParallelRemarkEnabled -XX:MaxTenuringThreshold=15 -XX:MaxGCPauseMillis=30 -XX:GCPauseIntervalMillis=150 -XX:+UseAdaptiveGCBoundary -XX:-UseGCOverheadLimit -XX:+UseBiasedLocking -XX:SurvivorRatio=8 -XX:TargetSurvivorRatio=90 -XX:MaxTenuringThreshold=15 -Dfml.ignorePatchDiscrepancies=true -Dfml.ignoreInvalidMinecraftCertificates=true -XX:+UseFastAccessorMethods -XX:+UseCompressedOops -XX:+OptimizeStringConcat -XX:+AggressiveOpts -XX:ReservedCodeCacheSize=2048m -XX:+UseCodeCacheFlushing -XX:SoftRefLRUPolicyMSPerMB=10000 -XX:ParallelGCThreads=10"";

• directives : content: loc,if in loc

  • hi_java_servlet,default:""

  example:

hi_java_servlet hi/jhello;

• directives : content : http,srv,loc,if in loc ,if in srv

  • hi_java_servlet_cache_expires,default:300s

  example:

hi_java_servlet_cache_expires 300s;

• directives : content : http,srv,loc,if in loc ,if in srv

  • hi_java_servlet_cache_size,default:10

  example:

hi_java_servlet_cache_size 10;

• directives : content: http,srv,if in srv

  • hi_java_version,default:9

  example:

hi_java_version 9;

• directives : content: loc,if in loc

  • hi_php_script,default: ""

  example:

            location ~ \.php$  {
                hi_php_script php;
            }

nginx.conf

hi_demo_conf