安装Nginx+Lua开发环境

 更新时间:2015年02月27日 10:29:51   投稿:hebedich  
本文主要详细介绍了安装Nginx+Lua开发环境的过程以及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,以后我们把所有软件安装在此目录

复制代码 代码如下:

mkdir -p /usr/servers 
cd /usr/servers/ 

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

复制代码 代码如下:

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

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

复制代码 代码如下:

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

复制代码 代码如下:

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缓存

复制代码 代码如下:

cd /usr/servers/ngx_openresty-1.7.7.2/bundle 
wget https://github.com/FRiCKLE/ngx_cache_purge/archive/2.3.tar.gz 
tar -xvf 2.3.tar.gz 

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

复制代码 代码如下:

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

复制代码 代码如下:

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
 
7、到/usr/servers目录下

复制代码 代码如下:

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版本和安装的模块

8、启动nginx

复制代码 代码如下:

/usr/servers/nginx/sbin/nginx

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

配置环境

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

1、编辑nginx.conf配置文件

复制代码 代码如下:

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

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

复制代码 代码如下:

#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

复制代码 代码如下:

#lua.conf 
server { 
    listen       80; 
    server_name  _; 

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

复制代码 代码如下:

include lua.conf; 

5、测试是否正常

复制代码 代码如下:

/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部分添加如下配置

复制代码 代码如下:

location /lua { 
    default_type 'text/html'; 
        content_by_lua 'ngx.say("hello world")'; 

2、测试配置是否正确

复制代码 代码如下:

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

3、重启nginx

复制代码 代码如下:

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

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

hello world

5、lua代码文件

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

复制代码 代码如下:

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

复制代码 代码如下:

#添加如下内容 
ngx.say("hello world");  

然后lua.conf修改为  

复制代码 代码如下:

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;但是正式环境一定记得开启缓存。

复制代码 代码如下:

    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、错误日志
 
如果运行过程中出现错误,请不要忘记查看错误日志。

复制代码 代码如下:

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配置文件如下(此处我们最小化了配置文件)

复制代码 代码如下:

#user  nobody; 
worker_processes  2; 
error_log  logs/error.log; 
events { 
    worker_connections  1024; 

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配置文件如下

复制代码 代码如下:

server { 
    listen       80; 
    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上了。

好了,Nginx+Lua开发环境的安装配置我们今天就讲到这里了,后续我们将持续讲解一些nginx+lua开发的内容。

相关文章

  • Lua教程(八):数据持久化

    Lua教程(八):数据持久化

    这篇文章主要介绍了Lua教程(八):数据持久化,本文讲解了数据文件持久化、序列化两部份内容,需要的朋友可以参考下
    2015-04-04
  • Lua中的迭代器和泛型for学习总结

    Lua中的迭代器和泛型for学习总结

    这篇文章主要介绍了Lua中的迭代器和泛型for学习总结,本文讲解了迭代器和泛型for的基础知识、泛型for的语义、无状态的迭代器等内容,需要的朋友可以参考下
    2014-09-09
  • Lua学习笔记之类型与值

    Lua学习笔记之类型与值

    本文详细的总结了Lua中的类型与值,对于实际编程中容易出错的地方也进行了详细的总结,十分的全面实用。有需要的小伙伴可以参考下。
    2015-04-04
  • Lua 操作 MongoDB 数据库实例

    Lua 操作 MongoDB 数据库实例

    这篇文章主要介绍了Lua 操作 MongoDB 数据库实例,本文给出了修改后的lua-mongo API和具体的操作MongoDB 数据库代码,需要的朋友可以参考下
    2015-03-03
  • Lua中的常用函数库汇总

    Lua中的常用函数库汇总

    这篇文章主要介绍了Lua中的常用函数库汇总,本文罗列了lua库函数、数学函数、字符串库、表函数、Bit Functions,需要的朋友可以参考下
    2014-09-09
  • Lua中模块以及实现方法指南

    Lua中模块以及实现方法指南

    从Lua 5.1开始,我们可以使用require和module函数来获取和创建Lua中的模块。从使用者的角度来看,一个模块就是一个程序库,可以通过require来加载,之后便得到一个类型为table的全局变量。
    2015-04-04
  • Lua中写排序算法实例(选择排序算法)

    Lua中写排序算法实例(选择排序算法)

    这篇文章主要介绍了Lua中写排序算法实例,本文用一个选择排序算法为例讲解如何在Lua中写一个排序算法,需要的朋友可以参考下
    2015-04-04
  • Lua中的全局变量、非全局变量总结

    Lua中的全局变量、非全局变量总结

    这篇文章主要介绍了Lua中的全局变量、非全局变量总结,全局变量可称之为Lua环境变量,需要的朋友可以参考下
    2014-09-09
  • 在Lua程序中使用MySQL的教程

    在Lua程序中使用MySQL的教程

    这篇文章主要介绍了在Lua程序中使用MySQL的教程,是Lua入门学习中的基础知识,需要的朋友可以参考下
    2015-05-05
  • 详解Lua中的元表概念

    详解Lua中的元表概念

    这篇文章主要介绍了详解Lua中的元表,是Lua入门学习中的基础知识,需要的朋友可以参考下
    2015-05-05

最新评论