第一章 安装OpenResty(Nginx+Lua)开发环境

首先我们选择使用OpenResty,其是由Nginx核心加很多第三方模块组成,其最大的亮点是默认集成了Lua开发环境,使得Nginx可以作为一个Web Server使用。借助于Nginx的事件驱动模型和非阻塞IO,可以实现高性能的Web应用程序。而且OpenResty提供了大量组件如Mysql、Redis、Memcached等等,使在Nginx上开发Web应用更方便更简单。目前在京东如实时价格、秒杀、动态服务、单品页、列表页等都在使用Nginx+Lua架构,其他公司如淘宝、去哪儿网等。

安装环境

安装步骤可以参考http://openresty.org/#Installation


1、创建目录/usr/servers,以后我们把所有软件安装在此目录

Java代码

mkdir -p /usr/servers  

cd /usr/servers/  


2、安装依赖(我的环境是ubuntu,可以使用如下命令安装,其他的可以参考openresty安装步骤)

Java代码

apt-get install libreadline-dev libncurses5-dev libpcre3-dev libssl-dev perl  


3、下载ngx_openresty-1.7.7.2.tar.gz并解压

Java代码

wget http://openresty.org/download/ngx_openresty-1.7.7.2.tar.gz  

tar -xzvf ngx_openresty-1.7.7.2.tar.gz  


ngx_openresty-1.7.7.2/bundle目录里存放着nginx核心和很多第三方模块,比如有我们需要的Lua和LuaJIT。


3、安装LuaJIT

Java代码

cd bundle/LuaJIT-2.1-20150120/  

make clean && make && make install  

ln -sf luajit-2.1.0-alpha /usr/local/bin/luajit  


4、下载ngx_cache_purge模块,该模块用于清理nginx缓存

Java代码

cd /usr/servers/ngx_openresty-1.7.7.2/bundle  

wget https://github.com/FRiCKLE/ngx_cache_purge/archive/2.3.tar.gz  

tar -xvf2.3.tar.gz  


5、下载nginx_upstream_check_module模块,该模块用于ustream健康检查

Java代码

cd /usr/servers/ngx_openresty-1.7.7.2/bundle  

wget https://github.com/yaoweibin/nginx_upstream_check_module/archive/v0.3.0.tar.gz  

tar -xvf v0.3.0.tar.gz   

6、安装ngx_openresty

Java代码

cd /usr/servers/ngx_openresty-1.7.7.2  

./configure --prefix=/usr/servers --with-http_realip_module  --with-pcre  --with-luajit --add-module=./bundle/ngx_cache_purge-2.3/ --add-module=./bundle/nginx_upstream_check_module-0.3.0/ -j2  

make && make install  


--with***                安装一些内置/集成的模块

--with-http_realip_module  取用户真实ip模块

-with-pcre               Perl兼容的达式模块

--with-luajit              集成luajit模块


--add-module            添加自定义的第三方模块,如此次的ngx_che_purge


8、到/usr/servers目录下 

Java代码

cd /usr/servers/  

ll   


会发现多出来了如下目录,说明安装成功

/usr/servers/luajit :luajit环境,luajit类似于java的jit,即即时编译,lua是一种解释语言,通过luajit可以即时编译lua代码到机器代码,得到很好的性能;

/usr/servers/lualib:要使用的lua库,里边提供了一些默认的lua库,如redis,json库等,也可以把一些自己开发的或第三方的放在这;

/usr/servers/nginx :安装的nginx;


通过/usr/servers/nginx/sbin/nginx  -V 查看nginx版本和安装的模块


7、启动nginx

/usr/servers/nginx/sbin/nginx


接下来该配置nginx+lua开发环境了


配置环境

配置及Nginx HttpLuaModule文档在可以查看http://wiki.nginx.org/HttpLuaModule



1、编辑nginx.conf配置文件 

Java代码

vim /usr/servers/nginx/conf/nginx.conf  


2、在http部分添加如下配置 

Java代码

#lua模块路径,多个之间”;”分隔,其中”;;”表示默认搜索路径,默认到/usr/servers/nginx下找  

lua_package_path"/usr/servers/lualib/?.lua;;";  #lua 模块  

lua_package_cpath"/usr/servers/lualib/?.so;;";  #c模块   


3、为了方便开发我们在/usr/servers/nginx/conf目录下创建一个lua.conf 

Java代码

#lua.conf  

server {  

listen80;  

    server_name  _;  

}  


4、在nginx.conf中的http部分添加include lua.conf包含此文件片段 

Java代码

include lua.conf;  


5、测试是否正常 

Java代码

/usr/servers/nginx/sbin/nginx  -t   


如果显示如下内容说明配置成功

nginx: the configuration file /usr/servers/nginx/conf/nginx.conf syntax is ok

nginx: configuration file /usr/servers/nginx/conf/nginx.conf test is successful


HelloWorld

1、在lua.conf中server部分添加如下配置 

Java代码

location /lua {  

default_type'text/html';  

content_by_lua'ngx.say("hello world")';  

}  


2、测试配置是否正确 

Java代码

/usr/servers/nginx/sbin/nginx  -t  


3、重启nginx 

Java代码

/usr/servers/nginx/sbin/nginx  -s reload  


4、访问如http://192.168.1.6/lua(自己的机器根据实际情况换ip),可以看到如下内容

hello world


5、lua代码文件

我们把lua代码放在nginx配置中会随着lua的代码的增加导致配置文件太长不好维护,因此我们应该把lua代码移到外部文件中存储。 

Java代码

vim /usr/servers/nginx/conf/lua/test.lua  

Java代码

#添加如下内容  

ngx.say("hello world");   


然后lua.conf修改为   

Java代码

location /lua {  

default_type'text/html';  

    content_by_lua_file conf/lua/test.lua; #相对于nginx安装目录  

}   

此处conf/lua/test.lua也可以使用绝对路径/usr/servers/nginx/conf/lua/test.lua。


6、lua_code_cache 

默认情况下lua_code_cache 

是开启的,即缓存lua代码,即每次lua代码变更必须reload nginx才生效,如果在开发阶段可以通过lua_code_cache 

off;关闭缓存,这样调试时每次修改lua代码不需要reload nginx;但是正式环境一定记得开启缓存。 

Java代码

    location /lua {  

default_type'text/html';  

        lua_code_cache off;  

        content_by_lua_file conf/lua/test.lua;  

}  


开启后reload nginx会看到如下报警

nginx: [alert] lua_code_cache is off; this will hurt performance in /usr/servers/nginx/conf/lua.conf:8


7、错误日志


如果运行过程中出现错误,请不要忘记查看错误日志。 

Java代码

tail -f /usr/servers/nginx/logs/error.log  


到此我们的基本环境搭建完毕。


nginx+lua项目构建

以后我们的nginx lua开发文件会越来越多,我们应该把其项目化,已方便开发。项目目录结构如下所示:

example

    example.conf     ---该项目的nginx 配置文件

    lua              ---我们自己的lua代码

      test.lua

    lualib            ---lua依赖库/第三方依赖

      *.lua

      *.so


其中我们把lualib也放到项目中的好处就是以后部署的时候可以一起部署,防止有的服务器忘记复制依赖而造成缺少依赖的情况。


我们将项目放到到/usr/example目录下。


/usr/servers/nginx/conf/nginx.conf配置文件如下(此处我们最小化了配置文件)

Java代码

#user  nobody;  

worker_processes2;  

error_log  logs/error.log;  

events {  

worker_connections1024;  

}  

http {  

    include       mime.types;  

    default_type  text/html;  


    #lua模块路径,其中”;;”表示默认搜索路径,默认到/usr/servers/nginx下找  

lua_package_path"/usr/example/lualib/?.lua;;";  #lua 模块  

lua_package_cpath"/usr/example/lualib/?.so;;";  #c模块  

    include /usr/example/example.conf;  

}  

通过绝对路径包含我们的lua依赖库和nginx项目配置文件。


/usr/example/example.conf配置文件如下 

Java代码

server {  

listen80;  

    server_name  _;  


    location /lua {  

default_type'text/html';  

        lua_code_cache off;  

        content_by_lua_file /usr/example/lua/test.lua;  

    }  

}  

lua文件我们使用绝对路径/usr/example/lua/test.lua。 


到此我们就可以把example扔svn上了。

转自  http://jinnianshilongnian.iteye.com/blog/2186270

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 162,825评论 4 377
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 68,887评论 2 308
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 112,425评论 0 255
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,801评论 0 224
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 53,252评论 3 299
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 41,089评论 1 226
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 32,216评论 2 322
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 31,005评论 0 215
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,747评论 1 250
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,883评论 2 255
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,354评论 1 265
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,694评论 3 265
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,406评论 3 246
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,222评论 0 9
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,996评论 0 201
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 36,242评论 2 287
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 36,017评论 2 281

推荐阅读更多精彩内容