共计 7811 个字符，预计需要花费 20 分钟才能阅读完成。
OpenResty 由 Nginx 核心加很多第三方模块组成，默认集成了 Lua 开发环境，使得 Nginx 可以作为一个 Web Server 使用。借助于 Nginx 的事件驱动模型和非阻塞 IO，可以实现高性能的 Web 应用程序。而且 OpenResty 提供了大量组件如 Mysql、Redis、Memcached 等等，使在 Nginx 上开发 Web 应用更方便更简单。目前在京东如实时价格、秒杀、动态服务、单品页、列表页等都在使用 Nginx+Lua 架构，其他公司如淘宝、去哪儿网等。
一、安装环境, 安装步骤可以参考 http://openresty.org/#Installation
1、创建目录 /usr/servers，以后我们把所有软件安装在此目录
user@user:~$ sudo su
root@user:/home/user# mkdir -p /usr/servers
root@user:/home/user# cd /usr/servers/
2、安装依赖（我的环境是 Ubuntu，可以使用如下命令安装，其他的可以参考 openresty 安装步骤）
root@user:/usr/servers# apt-get install libreadline-dev libncurses5-dev libpcre3-dev libssl-dev perl
root@user:/usr/servers# apt-get install make
3、下载 ngx_openresty-xxx.tar.gz 并解压(ngx_openresty-xxx/bundle 目录里存放着 nginx 核心和很多第三方模块，比如有我们需要的 Lua 和 LuaJIT。)
root@user:/usr/servers# wget https://openresty.org/download/ngx_openresty-1.9.7.1.tar.gz
root@user:/usr/servers# tar xvf ngx_openresty-1.9.7.1.tar.gz
root@user:/usr/servers# cd ngx_openresty-1.9.7.1
4、安装 LuaJIT
root@user:/usr/servers/ngx_openresty-1.9.7.1# cd bundle/LuaJIT-2.1-20151219/
root@user:/usr/servers/ngx_openresty-1.9.7.1/bundle/LuaJIT-2.1-20151219# make clean && make && make install
root@user:/usr/servers/ngx_openresty-1.9.7.1/bundle/LuaJIT-2.1-20151219# ln -sf luajit-2.1.0-alpha /usr/local/bin/luajit
5、下载 ngx_cache_purge 模块，该模块用于清理 nginx 缓存
root@user:/usr/servers/ngx_openresty-1.9.7.1/bundle# wget https://github.com/FRiCKLE/ngx_cache_purge/archive/2.3.tar.gz
root@user:/usr/servers/ngx_openresty-1.9.7.1/bundle# tar -xvf 2.3.tar.gz
6、下载 nginx_upstream_check_module 模块，该模块用于 ustream 健康检查
root@user:/usr/servers/ngx_openresty-1.9.7.1/bundle# wget https://github.com/yaoweibin/nginx_upstream_check_module/archive/v0.3.0.tar.gz
root@user:/usr/servers/ngx_openresty-1.9.7.1/bundle# tar -xvf v0.3.0.tar.gz
7、安装 ngx_openresty
root@user:/usr/servers/ngx_openresty-1.9.7.1/bundle# cd ..
root@user:/usr/servers/ngx_openresty-1.9.7.1# ./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
root@user:/usr/servers/ngx_openresty-1.9.7.1# make && make install
参数说明：
–with*** 安装一些内置 / 集成的模块
–with-http_realip_module 取用户真实 ip 模块
-with-pcre Perl 兼容的达式模块
–with-luajit 集成 luajit 模块
–add-module 添加自定义的第三方模块，如此次的 ngx_che_purge
8、到 /usr/servers 目录下用 ll 命令查看，会发现多出来了如下目录，说明安装成功
root@user:/usr/servers/ngx_openresty-1.9.7.1# cd /usr/servers/
root@user:/usr/servers# ll
total 3496
drwxr-xr-x 7 root root 4096 Jan 11 18:09 ./
drwxr-xr-x 11 root root 4096 Jan 11 17:14 ../
drwxr-xr-x 2 root root 4096 Jan 11 18:09 bin/
drwxr-xr-x 6 root root 4096 Jan 11 18:09 luajit/
drwxr-xr-x 5 root root 4096 Jan 11 18:09 lualib/
drwxr-xr-x 6 root root 4096 Jan 11 18:09 nginx/
drwxrwxr-x 5 user user 4096 Jan 11 18:08 ngx_openresty-1.9.7.1/
-rw-r–r– 1 root root 3548444 Jan 1 06:15 ngx_openresty-1.9.7.1.tar.gz
root@user:/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 版本和安装的模块
root@user:/usr/servers# /usr/servers/nginx/sbin/nginx -V
nginx version: openresty/1.9.7.1
built by gcc 4.6.3 (Ubuntu/Linaro 4.6.3-1ubuntu5)
built with OpenSSL 1.0.1 14 Mar 2012
TLS SNI support enabled
configure arguments: –prefix=/usr/servers/nginx –with-cc-opt=-O2 –add-module=../ngx_devel_kit-0.2.19 –add-module=../echo-nginx-module-0.58 –add-module=../xss-nginx-module-0.05 –add-module=../ngx_coolkit-0.2rc3 –add-module=../set-misc-nginx-module-0.29 –add-module=../form-input-nginx-module-0.11 –add-module=../encrypted-session-nginx-module-0.04 –add-module=../srcache-nginx-module-0.30 –add-module=../ngx_lua-0.9.20 –add-module=../ngx_lua_upstream-0.04 –add-module=../headers-more-nginx-module-0.29 –add-module=../array-var-nginx-module-0.04 –add-module=../memc-nginx-module-0.16 –add-module=../redis2-nginx-module-0.12 –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/servers/luajit/lib –with-http_realip_module –with-pcre –add-module=/usr/servers/ngx_openresty-1.9.7.1/bundle/ngx_cache_purge-2.3 –add-module=/usr/servers/ngx_openresty-1.9.7.1/bundle/nginx_upstream_check_module-0.3.0 –with-http_ssl_module
root@user:/usr/servers#
7、启动 nginx
root@user:/usr/servers# /usr/servers/nginx/sbin/nginx
检测配置是否正确（需要先切换到 root 用户）：
root@user:/usr/servers# /usr/servers/nginx/sbin/nginx -t
重启 nginx：
root@user:/usr/servers# /usr/servers/nginx/sbin/nginx -s reload
————————————–
二、配置 nginx+lua 开发环境
配置及 Nginx HttpLuaModule 文档在可以查看 http://wiki.nginx.org/HttpLuaModule
1、为了方便开发我们在 /usr/servers/nginx/conf 目录下创建一个 lua.conf
root@user:/home/user# cd /usr/servers/nginx/conf
root@user:/usr/servers/nginx/conf# vim lua.conf
server {
listen 80;
server_name _;
#HelloWorld
location /lua {
default_type ‘text/html’;
content_by_lua ‘ngx.say(“hello world”)’;
}
}
2、编辑 nginx.conf 配置文件
vim /usr/servers/nginx/conf/nginx.conf
在 http 部分添加如下配置
lua_package_path “/usr/servers/lualib/?.lua;;”; #lua 模块
lua_package_cpath “/usr/servers/lualib/?.so;;”; #c 模块
include lua.conf; #单独 lua 配置
#lua 模块路径，多个之间”;”分隔，其中”;;”表示默认搜索路径，默认到 /usr/servers/nginx 下找
例如：
http {
include mime.types;
default_type application/octet-stream;
//…..
lua_package_path “/usr/servers/lualib/?.lua;;”;
lua_package_cpath “/usr/servers/lualib/?.so;;”;
include lua.conf;
}
3、测试是否正常
root@user:/usr/servers/nginx/conf# /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
4、重启 nginx
/usr/servers/nginx/sbin/nginx -s reload
5、访问如 http://10.0.2.81/lua（自己的机器根据实际情况换 ip），可以看到如下内容
hello world
说明配置成功。
————————————–
三、lua 代码文件和缓存
1、lua_code_cache
默认情况下 lua_code_cache 是开启的，即缓存 lua 代码，即每次 lua 代码变更必须 reload nginx 才生效，
如果在开发阶段可以通过 lua_code_cache off; 关闭缓存，这样调试时每次修改 lua 代码不需要 reload nginx；但是正式环境一定记得开启缓存。
2、lua 代码文件
我们把 lua 代码放在 nginx 配置中会随着 lua 的代码的增加导致配置文件太长不好维护，因此我们应该把 lua 代码移到外部文件中存储。
root@user:/home/user# cd /usr/servers/
root@user:/usr/servers# mkdir lua
root@user:/usr/servers# cd lua
root@user:/usr/servers# vim test.lua
# 添加如下内容
ngx.say(“hello world by lua!”);
然后 lua.conf 修改为：
location /lua {
default_type ‘text/html’;
lua_code_cache off;
content_by_lua_file /usr/servers/lua/test.lua;
}
3、重启 nginx
/usr/servers/nginx/sbin/nginx -s reload
关闭缓存后会看到如下报警（忽略不管）
nginx: [alert] lua_code_cache is off; this will hurt performance in /usr/servers/nginx/conf/lua.conf:7
4、再次访问如 http://10.0.2.81/lua（自己的机器根据实际情况换 ip），可以看到如下内容：
hello world by lua!
5、错误日志
如果运行过程中出现错误，请不要忘记查看错误日志。
tail -f /usr/servers/nginx/logs/error.log
到此 nginx+lua 基本环境搭建完毕。
————————————–
四、nginx+lua 项目构建
把 nginx lua 开发文件其项目化方便开发。项目目录结构如下所示：
servers
lua.conf — 该项目的 nginx 配置文件
lua — 我们自己的 lua 代码
test.lua
lualib —lua 依赖库 / 第三方依赖
*.lua
*.so
其中把 lualib 放到项目中以后可以一起部署，防止有的服务器忘记复制依赖而造成缺少依赖的情况。
将项目放到 /usr/servers/ 目录下。
/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/servers/lualib/?.lua;;”; #lua 模块
lua_package_cpath “/usr/servers/lualib/?.so;;”; #c 模块
include /usr/servers/lua.conf;
}
通过绝对路径包含我们的 lua 依赖库和 nginx 项目配置文件。
/usr/servers/lua.conf 配置文件如下（可以直接把上面配置的文件移动过来，root@user:/usr/servers/nginx/conf# mv lua.conf /usr/servers/）
server {
listen 80;
server_name _;
location /lua {
default_type ‘text/html’;
lua_code_cache off;
content_by_lua_file /usr/servers/lua/test.lua;
}
}
lua 文件我们使用绝对路径 /usr/servers/lua/test.lua。
Lua 语言 15 分钟快速入门 http://www.linuxidc.com/Linux/2013-06/86582.htm
Lua 程序设计（第 2 版）中文 PDF http://www.linuxidc.com/Linux/2013-03/81833.htm
Lua 程序设计（第二版）阅读笔记 http://www.linuxidc.com/Linux/2013-03/81834.htm
NetBSD 将支持用 Lua 脚本开发内核组件 http://www.linuxidc.com/Linux/2013-02/79527.htm
CentOS 编译安装 Lua LuaSocket http://www.linuxidc.com/Linux/2011-08/41105.htm
Programming In Lua 高清 PDF 中文版 http://www.linuxidc.com/Linux/2015-05/117362.htm
如何配置一套优雅的 Lua 开发环境 http://www.linuxidc.com/Linux/2015-10/124397.htm
Lua 的详细介绍：请点这里
Lua 的下载地址：请点这里
本文永久更新链接地址：http://www.linuxidc.com/Linux/2016-05/131024.htm
