首先我们选择使用OpenResty,其是由Nginx核心加很多第三方模块组成,其最大的亮点是默认集成了Lua开发环境,使得Nginx可以作为一个Web Server使用。借助于Nginx的事件驱动模型和非阻塞IO,可以实现高性能的Web应用程序。而且OpenResty提供了大量组件如Mysql、Redis、Memcached等等,使在Nginx上开发Web应用更方便更简单。目前在京东如实时价格、秒杀、动态服务、单品页、列表页等都在使用Nginx+Lua架构,其他公司如淘宝、去哪儿网等。
安装环境
安装步骤可以参考http://openresty.org/#Installation。
1、创建目录/usr/servers,以后我们把所有软件安装在此目录
2、安装依赖(我的环境是ubuntu,可以使用如下命令安装,其他的可以参考openresty安装步骤)
3、下载ngx_openresty-1.7.7.2.tar.gz并解压
ngx_openresty-1.7.7.2/bundle目录里存放着nginx核心和很多第三方模块,比如有我们需要的Lua和LuaJIT。
3、安装LuaJIT
4、下载ngx_cache_purge模块,该模块用于清理nginx缓存
5、下载nginx_upstream_check_module模块,该模块用于ustream健康检查
6、安装ngx_openresty
--with*** 安装一些内置/集成的模块
--with-http_realip_module 取用户真实ip模块
-with-pcre Perl兼容的达式模块
--with-luajit 集成luajit模块
--add-module 添加自定义的第三方模块,如此次的ngx_che_purge
7、到/usr/servers目录下
会发现多出来了如下目录,说明安装成功
/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版本和安装的模块
8、启动nginx
接下来该配置nginx+lua开发环境了
配置环境
配置及Nginx HttpLuaModule文档在可以查看http://wiki.nginx.org/HttpLuaModule。
1、编辑nginx.conf配置文件
2、在http部分添加如下配置
3、为了方便开发我们在/usr/servers/nginx/conf目录下创建一个lua.conf
4、在nginx.conf中的http部分添加include lua.conf包含此文件片段
5、测试是否正常
如果显示如下内容说明配置成功
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部分添加如下配置
2、测试配置是否正确
3、重启nginx
4、访问如http://192.168.1.6/lua(自己的机器根据实际情况换ip),可以看到如下内容
hello world
5、lua代码文件
我们把lua代码放在nginx配置中会随着lua的代码的增加导致配置文件太长不好维护,因此我们应该把lua代码移到外部文件中存储。
然后lua.conf修改为
开启后reload nginx会看到如下报警
nginx: [alert] lua_code_cache is off; this will hurt performance in /usr/servers/nginx/conf/lua.conf:8
7、错误日志
如果运行过程中出现错误,请不要忘记查看错误日志。
到此我们的基本环境搭建完毕。
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配置文件如下(此处我们最小化了配置文件)
通过绝对路径包含我们的lua依赖库和nginx项目配置文件。
/usr/example/example.conf配置文件如下
lua文件我们使用绝对路径/usr/example/lua/test.lua。
到此我们就可以把example扔svn上了。
好了,Nginx+Lua开发环境的安装配置我们今天就讲到这里了,后续我们将持续讲解一些nginx+lua开发的内容。
新闻热点
疑难解答