Lua系列文章第一篇安装OpenResty(Nginx+Lua)开发环境

Lua安装

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

安装环境

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

1、软件安装目录/usr/local/src，以后我们把所有软件安装在此目录

2、安装依赖（我的环境是centos，可以使用如下命令安装，其他的可以参考openresty安装步骤）

yum install pcre-devel openssl-devel gcc curl

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

wget https://openresty.org/download/openresty-1.11.2.5.tar.gz

tar xf openresty-1.11.2.5.tar.gz

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

5、安装LuaJIT

cd openresty-1.11.2.5/bundle/LuaJIT-2.1-20170808/

make clean && make && make install

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

6、下载ngx_cache_purge模块，该模块用于清理nginx缓存

cd /usr/local/src/openresty-1.11.2.5/bundle

github地址:https://github.com/FRiCKLE/ngx_cache_purge

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

mv 2.3.tar.gz ngx_cache_purge.2.3.tar.gz

tar xf ngx_cache_purge.2.3.tar.gz

7、下载nginx_upstream_check_module模块，该模块用于ustream健康检查

cd /usr/local/src/openresty-1.11.2.5/bundle

github地址:https://github.com/yaoweibin/nginx_upstream_check_module

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

mv v0.3.0.tar.gz nginx_upstream_check_module.v0.3.0.tar.gz

tar xf nginx_upstream_check_module.v0.3.0.tar.gz

8、安装ngx_openresty

先检测nginx是否安装如果安装后

请通过 nginx -V 检查已经安装过的模块等等

nginx version: nginx/1.10.2

built by gcc 4.4.7 20120313 (Red Hat 4.4.7-17) (GCC)

built with OpenSSL 1.0.1e-fips 11 Feb 2013

TLS SNI support enabled

configure arguments: --prefix=/usr/local/nginx --user=nginx --group=nginx --with-http_ssl_module --with-http_v2_module --with-http_gzip_static_module --with-http_stub_status_module --with-pcre

cd /usr/local/src/openresty-1.11.2.5

进行编译安装

./configure --prefix=/usr/local --user=nginx --group=nginx --with-http_ssl_module --with-http_v2_module --with-http_gzip_static_module --with-http_stub_status_module --with-pcre --with-http_realip_module --with-luajit --add-module=./bundle/ngx_cache_purge-2.3/ --add-module=./bundle/nginx_upstream_check_module-0.3.0/ -j2

make && make install

mkdir -p /usr/local/site/lualib /usr/local/site/pod /usr/local/site/manifest

ln -sf /usr/local/nginx/sbin/nginx /usr/local/bin/openresty

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

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

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

--with-luajit 集成luajit模块

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

9、到/usr/local/src目录下

cd /usr/local/src && ll

total 340

drwxr-xr-x. 2 root root 4096 Feb 26 07:57 bin

-rw-r--r-- 1 root root 22924 Feb 26 07:57 COPYRIGHT

drwxr-xr-x. 2 root root 4096 Sep 23 2011 etc

drwxr-xr-x. 2 root root 4096 Sep 23 2011 games

drwxr-xr-x 11 root root 4096 May 19 2017 go

drwxr-xr-x 6 root root 4096 Mar 3 2017 graphviz

drwxr-xr-x. 4 root root 4096 Nov 28 02:57 include

drwxr-xr-x. 5 root root 4096 Feb 26 07:27 lib

drwxr-xr-x. 4 root root 4096 Nov 22 03:23 lib64

drwxr-xr-x 6 root root 4096 Oct 25 04:41 libdatrie

drwxr-xr-x. 2 root root 4096 Sep 23 2011 libexec

drwxr-xr-x 7 root root 4096 Nov 26 2016 libmcrypt

drwxr-xr-x 6 root root 4096 Feb 26 07:57 luajit

drwxr-xr-x 6 root root 4096 Feb 26 07:57 lualib

drwxr-xr-x 4 root root 4096 Nov 28 02:57 man

drwxr-xr-x 4 root root 4096 Nov 26 2016 mcrypt

drwxr-xr-x 5 root root 4096 Nov 26 2016 mhash

drwxr-xr-x 13 mysql mysql 4096 Jan 11 2017 mysql

drwxr-xr-x 11 root root 4096 Oct 16 08:19 nginx

drwxr-xr-x 8 root root 4096 May 8 2017 openresty

drwxr-xr-x 9 root root 4096 Nov 26 2016 php

drwxr-xr-x 43 root root 4096 Feb 26 07:57 pod

drwxr-xr-x 6 redis redis 4096 Nov 27 2016 redis

-rw-r--r-- 1 root root 216208 Feb 26 07:57 resty.index

drwxr-xr-x. 2 root root 4096 Sep 23 2011 sbin

drwxr-xr-x. 11 root root 4096 Feb 26 07:27 share

drwxr-xr-x 5 root root 4096 Feb 26 07:57 site

drwxr-xr-x. 14 root root 4096 Feb 26 07:24 src

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

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

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

/usr/local/nginx ：安装的nginx;

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

nginx version: openresty/1.11.2.5

built by gcc 4.4.7 20120313 (Red Hat 4.4.7-18) (GCC)

built with OpenSSL 1.0.1e-fips 11 Feb 2013

TLS SNI support enabled

configure arguments: --prefix=/usr/local/nginx --with-cc-opt=-O2 --add-module=../ngx_devel_kit-0.3.0 --add-module=../echo-nginx-module-0.61 --add-module=../xss-nginx-module-0.05 --add-module=../ngx_coolkit-0.2rc3 --add-module=../set-misc-nginx-module-0.31 --add-module=../form-input-nginx-module-0.12 --add-module=../encrypted-session-nginx-module-0.06 --add-module=../srcache-nginx-module-0.31 --add-module=../ngx_lua-0.10.10 --add-module=../ngx_lua_upstream-0.07 --add-module=../headers-more-nginx-module-0.32 --add-module=../array-var-nginx-module-0.05 --add-module=../memc-nginx-module-0.18 --add-module=../redis2-nginx-module-0.14 --add-module=../redis-nginx-module-0.3.7 --add-module=../rds-json-nginx-module-0.14 --add-module=../rds-csv-nginx-module-0.07 --with-ld-opt=-Wl,-rpath,/usr/local/luajit/lib --user=nginx --group=nginx --with-http_ssl_module --with-http_v2_module --with-http_gzip_static_module --with-http_stub_status_module --with-pcre --with-http_realip_module --add-module=/usr/local/src/openresty-1.11.2.5/bundle/ngx_cache_purge-2.3 --add-module=/usr/local/src/openresty-1.11.2.5/bundle/nginx_upstream_check_module-0.3.0

10、启动nginx

执行/usr/local/nginx/sbin/nginx 或者 service nginx restart

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

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

Stopping nginx: [ OK ]

Starting nginx: [ OK ]

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

配置环境

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

1)、编辑nginx.conf配置文件

vim /usr/local/nginx/conf/nginx.conf

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

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

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

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

3)、为了方便开发我们在/usr/local/nginx/conf目录下创建一个lua.conf 内容如下:

#lua.conf

server {

listen 81;

server_name _;

}

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

include lua.conf;

5)、测试是否正常

/usr/local/nginx/sbin/nginx -t

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

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

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

6)、编写HelloWorld实例

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

location /lua {

default_type 'text/html';

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

}

测试配置是否正确 /usr/local/nginx/sbin/nginx -t

重启nginx /usr/local/nginx/sbin/nginx -s reload

访问如 http://192.168.1.10:81/lua （自己的机器根据实际情况换ip），可以看到如下内容 : hello world

7)、lua代码文件

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

cd /usr/local/nginx/conf && mkdir lua

vim /usr/local/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/local/nginx/conf/lua/test.lua。

}

8)、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;

}

开启后-t和-s reload nginx会看到如下报警

[root@localhost conf]# nginx -t

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

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

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

[root@localhost conf]#

[root@localhost conf]# nginx -s reload

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

9)、nginx+lua项目构建

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

luaexample

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

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

test.lua

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

*.lua

*.so

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

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

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

user nginx nginx;

worker_processes auto;

error_log /home/wwwlogs/nginx_error.log crit;

pid /usr/local/nginx/logs/nginx.pid;

#Specifies the value for maximum file descriptors that can be opened by this process.

worker_rlimit_nofile 51200;

events {

use epoll;

worker_connections 51200;

multi_accept on;

}

http {

include mime.types;

default_type application/octet-stream;

log_format main '$remote_addr - $remote_user [$time_local] "$request" '

'$status $body_bytes_sent "$http_referer" '

'"$http_user_agent" "$http_x_forwarded_for"';

server_names_hash_bucket_size 128;

client_header_buffer_size 32k;

large_client_header_buffers 4 32k;

client_max_body_size 50m;

sendfile on;

tcp_nopush on;

keepalive_timeout 65;

tcp_nodelay on;

fastcgi_connect_timeout 300;

fastcgi_send_timeout 300;

fastcgi_read_timeout 300;

fastcgi_buffer_size 64k;

fastcgi_buffers 4 64k;

fastcgi_busy_buffers_size 128k;

fastcgi_temp_file_write_size 256k;

gzip on;

gzip_min_length 1k;

gzip_buffers 4 16k;

gzip_http_version 1.1;

gzip_comp_level 2;

gzip_types text/plain application/javascript application/x-javascript text/javascript text/css application/xml application/xml+rss;

gzip_vary on;

gzip_proxied expired no-cache no-store private auth;

gzip_disable "MSIE [1-6]\.";

server_tokens off;

access_log off;

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

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

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

include /usr/luaexample/example.conf;

server {

listen 80;

server_name localhost;

location / {

root html;

index index.html index.htm;

}

error_page 404 /404.html;

}

include vhost/*.conf;

}

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

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

server {

listen 81;

server_name _;

location /lua {

default_type 'text/html';

lua_code_cache off;

content_by_lua_file /usr/luaexample/lua/test.lua;

}

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

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

最后编辑于：2018.03.04 16:46:46

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 203,324评论 5赞 476
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 85,303评论 2赞 381
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 150,192评论 0赞 337
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 54,555评论 1赞 273
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 63,569评论 5赞 365
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 48,566评论 1赞 281
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 37,927评论 3赞 395
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 36,583评论 0赞 257
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 40,827评论 1赞 297
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,590评论 2赞 320
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 37,669评论 1赞 329
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 33,365评论 4赞 318
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 38,941评论 3赞 307
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 29,928评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 31,159评论 1赞 259
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 42,880评论 2赞 349
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 42,399评论 2赞 342

Lua系列文章 第一篇 安装OpenResty(Nginx+Lua)开发环境

推荐阅读更多精彩内容

Lua系列文章第一篇安装OpenResty(Nginx+Lua)开发环境