Openresty-Hello World

2016-11-24 | 阅读

OpenResty Nginx+Lua开发

OpenResty 是一个基于 NginxLua 的高性能 Web 平台,其内部集成了大量精良的 Lua 库、第三方模块以及大多数的依赖项。用于方便地搭建能够处理超高并发、扩展性极高的动态 Web 应用、Web 服务和动态网关。

OpenResty 通过汇聚各种设计精良的 Nginx 模块,从而将 Nginx 有效地变成一个强大的通用 Web 应用平台。这样,Web 开发人员和系统工程师可以使用 Lua 脚本语言调动 Nginx 支持的各种 C 以及 Lua 模块,快速构造出足以胜任 10K 乃至 1000K 以上单机并发连接的高性能 Web 应用系统。

OpenResty 的目标是让你的Web服务直接跑在 Nginx 服务内部,充分利用 Nginx 的非阻塞 I/O 模型,不仅仅对 HTTP 客户端请求,甚至于对远程后端诸如 MySQL、PostgreSQL、Memcached 以及 Redis 等都进行一致的高性能响应。

Openresty 的参考文档

安装

前往官网 http://openresty.org/cn/installation.html 下载,然后:

tar -xzvf openresty-VERSION.tar.gz
cd openresty-VERSION/
./configure
make
sudo make install

mac下需要先安装pcre和openssl:

brew update
brew install pcre openssl

安装后 openSSL 后:

./configure \
   --with-cc-opt="-I/usr/local/opt/openssl/include/ -I/usr/local/opt/pcre/include/" \
   --with-ld-opt="-L/usr/local/opt/openssl/lib/ -L/usr/local/opt/pcre/lib/" \
   -j8

然后就可以安装OpenResty , 安装完成后,我们可以在 /usr/local/OpenResty下,可以看到附带安装的 nginx, luajit ,lualib 等一系列附带内容.

然后,我们要修改path,以使其指向我们的OpenResty下的nginx,

PATH=/usr/local/openresty/nginx/sbin:$PATH

linux安装 openResty

通过yum安装:添加资源库,创建一个名为 /etc/yum.repos.d/OpenResty.repo 的文件,内容如下:

[openresty]
name=Official OpenResty Repository
baseurl=https://copr-be.cloud.fedoraproject.org/results/openresty/openresty/epel-$releasever-$basearch/
skip_if_unavailable=True
gpgcheck=1
gpgkey=https://copr-be.cloud.fedoraproject.org/results/openresty/openresty/pubkey.gpg
enabled=1
enabled_metadata=1

列出 openresty 资源库里面所有的包:

sudo yum --disablerepo="*" --enablerepo="openresty" list available

安装 openresty:

sudo yum install openresty

helloworld

然后编写一个helloworld , 创建一个项目, 创建文件结构 :

mkdir ~/work
cd ~/work
mkdir logs/ conf/

~/work/conf下,编写一个nginx.conf文件 ,是其拥有最少的内容,以支持一个nginx-lua项目 :

worker_processes  1;
error_log logs/error.log;
events {
    worker_connections 1024;
}
http {
    server {
        listen 8080;
        location / {
            default_type text/html;
            content_by_lua '
                ngx.say("<p>hello, world</p>")
            ';
        }
    }
}

修改完成后,使nginx以指定的nginx.conf运行:

nginx -p `pwd`/ -c conf/nginx.conf

我们要验证效果, 可以通过 :

curl http://localhost:8080/

如果一切正常,就可以看到如下输出 :

<p>hello, world</p>

项目结构

OpenResty, 一个项目, 就是一个nginx的所有配置,除去nginx的可执行文件本身. 所以建议在项目下建立一个文件夹 lua之类的,下面放置lua的原文件.

因为项目本身,不可能全部在nginx.conf中编写所有内容,所以,会出现这样的配置,以链接到外部的lua脚本 :

location / {
            default_type text/html;
            content_by_lua_file lua/test.lua; 
        }

然后,还需要创建一个lualib的文件夹, 以放置一些依赖库.对于依赖库, 需要如此设置 :

location / {
	            default_type text/html;
	            #lua模块路径,其中”;;”表示默认搜索路径,默认到/usr/servers/nginx下找  
				    lua_package_path "${prefix}/lualib/?.lua;;";  #lua 模块  
				    lua_package_cpath "${prefix}/lualib/?.so;;";  #c模块 
	            content_by_lua_file lua/test.lua; 
	        }

${prefix}表示命令行启动nginx时的路径。