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核心和很多第三方??椋热缬形颐切枰腖ua和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???,该??橛糜谇謇韓ginx缓存

? 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??椋媚?橛糜趗stream健康检查

? 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 检查已经安装过的??榈鹊?/p>

? 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???/p>

? --with-pcre? ? ? ? ? ? ? ? Perl兼容的达式???/p>

? --with-luajit? ? ? ? ? ? ? 集成luajit???/p>

? --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版本和安装的???/p>

? ? ? ? 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基本环境搭建完毕。

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

推荐阅读更多精彩内容