安裝Nginx+Lua開發環境

2024-07-21 23:04:23

字體：大中小

來源：轉載

供稿：網友

首先我們選擇使用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中的閉包(closure)淺析

下一篇：lua操作excel方法分享