updated docs to reflect recent changes, especially the new "openresty-en" mailing list for English speakers.
This commit is contained in:
agentzh (章亦春)
Родитель
0ee0c49cfd
Коммит
3388d424f6
72
README
72
README
|
|
@ -8,9 +8,9 @@ Status
|
|||
This module is under active development and is production ready.
|
||||
|
||||
Version
|
||||
This document describes ngx_lua v0.5.11
|
||||
(<https://github.com/chaoslawful/lua-nginx-module/tags>) released on 30
|
||||
July 2012.
|
||||
This document describes ngx_lua v0.5.12
|
||||
(<https://github.com/chaoslawful/lua-nginx-module/tags>) released on 4
|
||||
August 2012.
|
||||
|
||||
Synopsis
|
||||
# set search paths for pure Lua external libraries (';;' is the default path):
|
||||
|
|
@ -917,6 +917,11 @@ Directives
|
|||
|
||||
* Cosocket API functions (e.g., ngx.socket.tcp and ngx.req.socket).
|
||||
|
||||
Nginx output filters may be called multiple times for a single request
|
||||
because response body may be delivered in chunks. Thus, the Lua code
|
||||
specified by in this directive may also run multiple times in the
|
||||
lifetime of a single HTTP request.
|
||||
|
||||
This directive was first introduced in the "v0.5.0rc32" release.
|
||||
|
||||
body_filter_by_lua_file
|
||||
|
|
@ -1834,8 +1839,8 @@ Nginx API for Lua
|
|||
of the "NGX_HTTP_MAX_SUBREQUESTS" macro in the
|
||||
"nginx/src/http/ngx_http_request.h" file in the Nginx source tree.
|
||||
|
||||
Please also refer to restrictions on capturing locations that include
|
||||
Echo Module directives.
|
||||
Please also refer to restrictions on capturing locations configured by
|
||||
subrequest directives of other modules.
|
||||
|
||||
ngx.location.capture_multi
|
||||
syntax: *res1, res2, ... = ngx.location.capture_multi({ {uri, options?},
|
||||
|
|
@ -1894,8 +1899,8 @@ Nginx API for Lua
|
|||
return ngx.location.capture_multi({ {uri, args} })
|
||||
end
|
||||
|
||||
Please also refer to restrictions on capturing locations that include
|
||||
Echo Module directives.
|
||||
Please also refer to restrictions on capturing locations configured by
|
||||
subrequest directives of other modules.
|
||||
|
||||
ngx.status
|
||||
context: *set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*,
|
||||
|
|
@ -1915,7 +1920,8 @@ Nginx API for Lua
|
|||
context: *rewrite_by_lua*, access_by_lua*, content_by_lua*,
|
||||
header_filter_by_lua*, body_filter_by_lua, log_by_lua**
|
||||
|
||||
Set, add to, or clear the current request "HEADER" response header.
|
||||
Set, add to, or clear the current request's "HEADER" response header
|
||||
that is to be sent.
|
||||
|
||||
Underscores ("_") in the header names will be replaced by hyphens ("-")
|
||||
by default. This transformation can be turned off via the
|
||||
|
|
@ -4828,14 +4834,12 @@ Known Issues
|
|||
|
||||
Note that a longer from of the long bracket, "[=[...]=]", may be
|
||||
required if the regex pattern contains "[...]" sequences. The
|
||||
"[=[...]=]" form may be used as the default form if desired and it may
|
||||
help with readability if a space is inserted between the long brackets
|
||||
and the regex patterns.
|
||||
"[=[...]=]" form may be used as the default form if desired.
|
||||
|
||||
# nginx.conf
|
||||
location /test {
|
||||
content_by_lua '
|
||||
local regex = [=[ [0-9]+ ]=]
|
||||
local regex = [=[[0-9]+]=]
|
||||
local m = ngx.re.match("hello, 1234", regex)
|
||||
if m then ngx.say(m[0]) else ngx.say("not matched!") end
|
||||
';
|
||||
|
|
@ -4906,9 +4910,6 @@ Typical Uses
|
|||
(<http://nodejs.org/>) v0.6.1 yields 10.2k req/sec for their Hello World
|
||||
equivalents.
|
||||
|
||||
This module performs best when built with LuaJIT 2.0
|
||||
(<http://luajit.org/luajit.html>).
|
||||
|
||||
Nginx Compatibility
|
||||
The module is compatible with the following versions of Nginx:
|
||||
|
||||
|
|
@ -4942,10 +4943,10 @@ Installation
|
|||
Alternatively, "ngx_lua" can be manually compiled into Nginx:
|
||||
|
||||
1. Install LuaJIT 2.0 (Recommended) or Lua 5.1 (Lua 5.2 is *not*
|
||||
supported yet). Lua can be obtained free from the the LuaJIT
|
||||
download page (<http://luajit.org/download.html>) or the standard
|
||||
Lua homepage (<http://www.lua.org/>). Some distribution package
|
||||
managers also distribute Lua and LuaJIT.
|
||||
supported yet). LuajIT can be downloaded from the the LuaJIT project
|
||||
website (<http://luajit.org/download.html>) and Lua 5.1, from the
|
||||
Lua project website (<http://www.lua.org/>). Some distribution
|
||||
package managers also distribute LuajIT and/or Lua.
|
||||
|
||||
2. Download the latest version of the ngx_devel_kit (NDK) module HERE
|
||||
(<http://github.com/simpl/ngx_devel_kit/tags>).
|
||||
|
|
@ -4962,13 +4963,13 @@ Installation
|
|||
tar -xzvf nginx-1.2.1.tar.gz
|
||||
cd nginx-1.2.1/
|
||||
|
||||
# tell nginx's build system where to find lua:
|
||||
export LUA_LIB=/path/to/lua/lib
|
||||
export LUA_INC=/path/to/lua/include
|
||||
# tell nginx's build system where to find LuaJIT:
|
||||
export LUAJIT_LIB=/path/to/luajit/lib
|
||||
export LUAJIT_INC=/path/to/luajit/include/luajit-2.0
|
||||
|
||||
# or tell where to find LuaJIT when if using JIT instead
|
||||
# export LUAJIT_LIB=/path/to/luajit/lib
|
||||
# export LUAJIT_INC=/path/to/luajit/include/luajit-2.0
|
||||
# or tell where to find Lua if using Lua instead:
|
||||
#export LUA_LIB=/path/to/lua/lib
|
||||
#export LUA_INC=/path/to/lua/include
|
||||
|
||||
# Here we assume Nginx is to be installed under /opt/nginx/.
|
||||
./configure --prefix=/opt/nginx \
|
||||
|
|
@ -4979,19 +4980,30 @@ Installation
|
|||
make install
|
||||
|
||||
Installation on Ubuntu 11.10
|
||||
To install lua 5.1 from repository run the following command:
|
||||
Note that it is recommended to use LuaJIT 2.0 instead of the standard
|
||||
Lua 5.1 interpreter where possible.
|
||||
|
||||
If the standard Lua 5.1 interpreter is required however, run the
|
||||
following command to install it from the Ubuntu repository:
|
||||
|
||||
apt-get install -y lua5.1 liblua5.1-0 liblua5.1-0-dev
|
||||
|
||||
Everything should be installed correctly, except one small tweak.
|
||||
Everything should be installed correctly, except for one small tweak.
|
||||
|
||||
Library name "liblua.so" has been changed in liblua5.1 package, it only
|
||||
comes with "liblua5.1.so", which needs to be symlinked to "/usr/lib" so
|
||||
it could be found during the configuration process.
|
||||
|
||||
ln -s /usr/lib/x86_64-linux-gnu/liblua5.1.so /usr/lib/liblua.so
|
||||
|
||||
It is recommended, however, to use LuaJIT 2.0 instead of the standard
|
||||
Lua 5.1 interpreter with this module wherever possible.
|
||||
Community
|
||||
English Mailing List
|
||||
The openresty-en (<https://groups.google.com/group/openresty-en>)
|
||||
mailing list is for English speakers.
|
||||
|
||||
Chinese Mailing List
|
||||
The openresty (<https://groups.google.com/group/openresty>) mailing list
|
||||
is for Chinese speakers.
|
||||
|
||||
Bugs and Patches
|
||||
Please report bugs or submit patches by:
|
||||
|
|
@ -5124,7 +5136,7 @@ Copyright and License
|
|||
Copyright (C) 2009-2012, by Xiaozhe Wang (chaoslawful)
|
||||
<chaoslawful@gmail.com>.
|
||||
|
||||
Copyright (C) 2009-2012, by Zhang "agentzh" Yichun (章亦春)
|
||||
Copyright (C) 2009-2012, by Yichun "agentzh" Zhang (章亦春)
|
||||
<agentzh@gmail.com>.
|
||||
|
||||
All rights reserved.
|
||||
|
|
|
|||
|
|
@ -18,7 +18,7 @@ This module is under active development and is production ready.
|
|||
Version
|
||||
=======
|
||||
|
||||
This document describes ngx_lua [v0.5.11](https://github.com/chaoslawful/lua-nginx-module/tags) released on 30 July 2012.
|
||||
This document describes ngx_lua [v0.5.12](https://github.com/chaoslawful/lua-nginx-module/tags) released on 4 August 2012.
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
|
@ -821,6 +821,8 @@ Note that the following API functions are currently disabled within this context
|
|||
* Subrequest API functions (e.g., [ngx.location.capture](http://wiki.nginx.org/HttpLuaModule#ngx.location.capture) and [ngx.location.capture_multi](http://wiki.nginx.org/HttpLuaModule#ngx.location.capture_multi))
|
||||
* Cosocket API functions (e.g., [ngx.socket.tcp](http://wiki.nginx.org/HttpLuaModule#ngx.socket.tcp) and [ngx.req.socket](http://wiki.nginx.org/HttpLuaModule#ngx.req.socket)).
|
||||
|
||||
Nginx output filters may be called multiple times for a single request because response body may be delivered in chunks. Thus, the Lua code specified by in this directive may also run multiple times in the lifetime of a single HTTP request.
|
||||
|
||||
This directive was first introduced in the `v0.5.0rc32` release.
|
||||
|
||||
body_filter_by_lua_file
|
||||
|
|
@ -1686,7 +1688,7 @@ There is a hard-coded upper limit on the number of concurrent subrequests possib
|
|||
|
||||
The limit can be manually modified if required by editing the definition of the `NGX_HTTP_MAX_SUBREQUESTS` macro in the `nginx/src/http/ngx_http_request.h` file in the Nginx source tree.
|
||||
|
||||
Please also refer to restrictions on [capturing locations that include Echo Module directives](http://wiki.nginx.org/HttpLuaModule#Locations_With_HttpEchoModule_Directives).
|
||||
Please also refer to restrictions on capturing locations configured by [subrequest directives of other modules](http://wiki.nginx.org/HttpLuaModule#Locations_Configured_by_Subrequest_Directives_of_Other_Modules).
|
||||
|
||||
ngx.location.capture_multi
|
||||
--------------------------
|
||||
|
|
@ -1746,7 +1748,7 @@ of this function. Logically speaking, the [ngx.location.capture](http://wiki.ngi
|
|||
end
|
||||
|
||||
|
||||
Please also refer to restrictions on [capturing locations that include Echo Module directives](http://wiki.nginx.org/HttpLuaModule#Locations_With_HttpEchoModule_Directives).
|
||||
Please also refer to restrictions on capturing locations configured by [subrequest directives of other modules](http://wiki.nginx.org/HttpLuaModule#Locations_Configured_by_Subrequest_Directives_of_Other_Modules).
|
||||
|
||||
ngx.status
|
||||
----------
|
||||
|
|
@ -1768,7 +1770,7 @@ ngx.header.HEADER
|
|||
|
||||
**context:** *rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua, log_by_lua**
|
||||
|
||||
Set, add to, or clear the current request `HEADER` response header.
|
||||
Set, add to, or clear the current request's `HEADER` response header that is to be sent.
|
||||
|
||||
Underscores (`_`) in the header names will be replaced by hyphens (`-`) by default. This transformation can be turned off via the [lua_transform_underscores_in_response_headers](http://wiki.nginx.org/HttpLuaModule#lua_transform_underscores_in_response_headers) directive.
|
||||
|
||||
|
|
@ -4322,13 +4324,13 @@ Alternatively, the regex pattern can be presented as a long-bracketed Lua string
|
|||
Here, `[[\\d+]]` is stripped down to `[[\d+]]` by the Nginx config file parser and this is processed correctly.
|
||||
|
||||
Note that a longer from of the long bracket, `[=[...]=]`, may be required if the regex pattern contains `[...]` sequences.
|
||||
The `[=[...]=]` form may be used as the default form if desired and it may help with readability if a space is inserted between the long brackets and the regex patterns.
|
||||
The `[=[...]=]` form may be used as the default form if desired.
|
||||
|
||||
|
||||
# nginx.conf
|
||||
location /test {
|
||||
content_by_lua '
|
||||
local regex = [=[ [0-9]+ ]=]
|
||||
local regex = [=[[0-9]+]=]
|
||||
local m = ngx.re.match("hello, 1234", regex)
|
||||
if m then ngx.say(m[0]) else ngx.say("not matched!") end
|
||||
';
|
||||
|
|
@ -4378,8 +4380,6 @@ The Lua state (Lua VM instance) is shared across all the requests handled by a s
|
|||
|
||||
On a ThinkPad T400 2.80 GHz laptop, the Hello World example readily achieves 28k req/sec using `http_load -p 10`. By contrast, Nginx + php-fpm 5.2.8 + Unix Domain Socket yields 6k req/sec and [Node.js](http://nodejs.org/) v0.6.1 yields 10.2k req/sec for their Hello World equivalents.
|
||||
|
||||
This module performs best when built with [LuaJIT 2.0](http://luajit.org/luajit.html).
|
||||
|
||||
Nginx Compatibility
|
||||
===================
|
||||
The module is compatible with the following versions of Nginx:
|
||||
|
|
@ -4402,7 +4402,7 @@ The [ngx_openresty bundle](http://openresty.org) can be used to install Nginx, `
|
|||
|
||||
Alternatively, `ngx_lua` can be manually compiled into Nginx:
|
||||
|
||||
1. Install LuaJIT 2.0 (Recommended) or Lua 5.1 (Lua 5.2 is *not* supported yet). Lua can be obtained free from the [the LuaJIT download page](http://luajit.org/download.html) or [the standard Lua homepage](http://www.lua.org/). Some distribution package managers also distribute Lua and LuaJIT.
|
||||
1. Install LuaJIT 2.0 (Recommended) or Lua 5.1 (Lua 5.2 is *not* supported yet). LuajIT can be downloaded from the [the LuaJIT project website](http://luajit.org/download.html) and Lua 5.1, from the [Lua project website](http://www.lua.org/). Some distribution package managers also distribute LuajIT and/or Lua.
|
||||
1. Download the latest version of the ngx_devel_kit (NDK) module [HERE](http://github.com/simpl/ngx_devel_kit/tags).
|
||||
1. Download the latest version of `ngx_lua` [HERE](http://github.com/chaoslawful/lua-nginx-module/tags).
|
||||
1. Download the latest version of Nginx [HERE](http://nginx.org/) (See [Nginx Compatibility](http://wiki.nginx.org/HttpLuaModule#Nginx_Compatibility))
|
||||
|
|
@ -4413,14 +4413,14 @@ Build the source with this module:
|
|||
wget 'http://nginx.org/download/nginx-1.2.1.tar.gz'
|
||||
tar -xzvf nginx-1.2.1.tar.gz
|
||||
cd nginx-1.2.1/
|
||||
|
||||
# tell nginx's build system where to find LuaJIT:
|
||||
export LUAJIT_LIB=/path/to/luajit/lib
|
||||
export LUAJIT_INC=/path/to/luajit/include/luajit-2.0
|
||||
|
||||
# tell nginx's build system where to find lua:
|
||||
export LUA_LIB=/path/to/lua/lib
|
||||
export LUA_INC=/path/to/lua/include
|
||||
|
||||
# or tell where to find LuaJIT when if using JIT instead
|
||||
# export LUAJIT_LIB=/path/to/luajit/lib
|
||||
# export LUAJIT_INC=/path/to/luajit/include/luajit-2.0
|
||||
# or tell where to find Lua if using Lua instead:
|
||||
#export LUA_LIB=/path/to/lua/lib
|
||||
#export LUA_INC=/path/to/lua/include
|
||||
|
||||
# Here we assume Nginx is to be installed under /opt/nginx/.
|
||||
./configure --prefix=/opt/nginx \
|
||||
|
|
@ -4434,20 +4434,34 @@ Build the source with this module:
|
|||
Installation on Ubuntu 11.10
|
||||
----------------------------
|
||||
|
||||
To install lua 5.1 from repository run the following command:
|
||||
Note that it is recommended to use LuaJIT 2.0 instead of the standard Lua 5.1 interpreter where possible.
|
||||
|
||||
If the standard Lua 5.1 interpreter is required however, run the following command to install it from the Ubuntu repository:
|
||||
|
||||
|
||||
apt-get install -y lua5.1 liblua5.1-0 liblua5.1-0-dev
|
||||
|
||||
|
||||
Everything should be installed correctly, except one small tweak. Library name `liblua.so` has been changed in liblua5.1 package, it
|
||||
only comes with `liblua5.1.so`, which needs to be symlinked to `/usr/lib` so it could be found during the configuration process.
|
||||
Everything should be installed correctly, except for one small tweak.
|
||||
|
||||
Library name `liblua.so` has been changed in liblua5.1 package, it only comes with `liblua5.1.so`, which needs to be symlinked to `/usr/lib` so it could be found during the configuration process.
|
||||
|
||||
|
||||
ln -s /usr/lib/x86_64-linux-gnu/liblua5.1.so /usr/lib/liblua.so
|
||||
|
||||
|
||||
It is recommended, however, to use LuaJIT 2.0 instead of the standard Lua 5.1 interpreter with this module wherever possible.
|
||||
Community
|
||||
=========
|
||||
|
||||
English Mailing List
|
||||
--------------------
|
||||
|
||||
The [openresty-en](https://groups.google.com/group/openresty-en) mailing list is for English speakers.
|
||||
|
||||
Chinese Mailing List
|
||||
--------------------
|
||||
|
||||
The [openresty](https://groups.google.com/group/openresty) mailing list is for Chinese speakers.
|
||||
|
||||
Bugs and Patches
|
||||
================
|
||||
|
|
@ -4536,7 +4550,7 @@ This module is licensed under the BSD license.
|
|||
|
||||
Copyright (C) 2009-2012, by Xiaozhe Wang (chaoslawful) <chaoslawful@gmail.com>.
|
||||
|
||||
Copyright (C) 2009-2012, by Zhang "agentzh" Yichun (章亦春) <agentzh@gmail.com>.
|
||||
Copyright (C) 2009-2012, by Yichun "agentzh" Zhang (章亦春) <agentzh@gmail.com>.
|
||||
|
||||
All rights reserved.
|
||||
|
||||
|
|
|
|||
|
|
@ -10,7 +10,7 @@ This module is under active development and is production ready.
|
|||
|
||||
= Version =
|
||||
|
||||
This document describes ngx_lua [https://github.com/chaoslawful/lua-nginx-module/tags v0.5.11] released on 30 July 2012.
|
||||
This document describes ngx_lua [https://github.com/chaoslawful/lua-nginx-module/tags v0.5.12] released on 4 August 2012.
|
||||
|
||||
= Synopsis =
|
||||
<geshi lang="nginx">
|
||||
|
|
@ -793,6 +793,8 @@ Note that the following API functions are currently disabled within this context
|
|||
* Subrequest API functions (e.g., [[#ngx.location.capture|ngx.location.capture]] and [[#ngx.location.capture_multi|ngx.location.capture_multi]])
|
||||
* Cosocket API functions (e.g., [[#ngx.socket.tcp|ngx.socket.tcp]] and [[#ngx.req.socket|ngx.req.socket]]).
|
||||
|
||||
Nginx output filters may be called multiple times for a single request because response body may be delivered in chunks. Thus, the Lua code specified by in this directive may also run multiple times in the lifetime of a single HTTP request.
|
||||
|
||||
This directive was first introduced in the <code>v0.5.0rc32</code> release.
|
||||
|
||||
== body_filter_by_lua_file ==
|
||||
|
|
@ -1632,7 +1634,7 @@ There is a hard-coded upper limit on the number of concurrent subrequests possib
|
|||
|
||||
The limit can be manually modified if required by editing the definition of the <code>NGX_HTTP_MAX_SUBREQUESTS</code> macro in the <code>nginx/src/http/ngx_http_request.h</code> file in the Nginx source tree.
|
||||
|
||||
Please also refer to restrictions on [[#Locations_With_HttpEchoModule_Directives|capturing locations that include Echo Module directives]].
|
||||
Please also refer to restrictions on capturing locations configured by [[#Locations_Configured_by_Subrequest_Directives_of_Other_Modules|subrequest directives of other modules]].
|
||||
|
||||
== ngx.location.capture_multi ==
|
||||
'''syntax:''' ''res1, res2, ... = ngx.location.capture_multi({ {uri, options?}, {uri, options?}, ... })''
|
||||
|
|
@ -1691,7 +1693,7 @@ of this function. Logically speaking, the [[#ngx.location.capture|ngx.location.c
|
|||
end
|
||||
</geshi>
|
||||
|
||||
Please also refer to restrictions on [[#Locations_With_HttpEchoModule_Directives|capturing locations that include Echo Module directives]].
|
||||
Please also refer to restrictions on capturing locations configured by [[#Locations_Configured_by_Subrequest_Directives_of_Other_Modules|subrequest directives of other modules]].
|
||||
|
||||
== ngx.status ==
|
||||
'''context:''' ''set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua, log_by_lua*''
|
||||
|
|
@ -1711,7 +1713,7 @@ before sending out the response headers.
|
|||
|
||||
'''context:''' ''rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua, log_by_lua*''
|
||||
|
||||
Set, add to, or clear the current request <code>HEADER</code> response header.
|
||||
Set, add to, or clear the current request's <code>HEADER</code> response header that is to be sent.
|
||||
|
||||
Underscores (<code>_</code>) in the header names will be replaced by hyphens (<code>-</code>) by default. This transformation can be turned off via the [[#lua_transform_underscores_in_response_headers|lua_transform_underscores_in_response_headers]] directive.
|
||||
|
||||
|
|
@ -4173,13 +4175,13 @@ Alternatively, the regex pattern can be presented as a long-bracketed Lua string
|
|||
Here, <code>[[\\d+]]</code> is stripped down to <code>[[\d+]]</code> by the Nginx config file parser and this is processed correctly.
|
||||
|
||||
Note that a longer from of the long bracket, <code>[=[...]=]</code>, may be required if the regex pattern contains <code>[...]</code> sequences.
|
||||
The <code>[=[...]=]</code> form may be used as the default form if desired and it may help with readability if a space is inserted between the long brackets and the regex patterns.
|
||||
The <code>[=[...]=]</code> form may be used as the default form if desired.
|
||||
|
||||
<geshi lang="nginx">
|
||||
# nginx.conf
|
||||
location /test {
|
||||
content_by_lua '
|
||||
local regex = [=[ [0-9]+ ]=]
|
||||
local regex = [=[[0-9]+]=]
|
||||
local m = ngx.re.match("hello, 1234", regex)
|
||||
if m then ngx.say(m[0]) else ngx.say("not matched!") end
|
||||
';
|
||||
|
|
@ -4228,8 +4230,6 @@ The Lua state (Lua VM instance) is shared across all the requests handled by a s
|
|||
|
||||
On a ThinkPad T400 2.80 GHz laptop, the Hello World example readily achieves 28k req/sec using <code>http_load -p 10</code>. By contrast, Nginx + php-fpm 5.2.8 + Unix Domain Socket yields 6k req/sec and [http://nodejs.org/ Node.js] v0.6.1 yields 10.2k req/sec for their Hello World equivalents.
|
||||
|
||||
This module performs best when built with [http://luajit.org/luajit.html LuaJIT 2.0].
|
||||
|
||||
= Nginx Compatibility =
|
||||
The module is compatible with the following versions of Nginx:
|
||||
|
||||
|
|
@ -4249,7 +4249,7 @@ The [http://openresty.org ngx_openresty bundle] can be used to install Nginx, <c
|
|||
|
||||
Alternatively, <code>ngx_lua</code> can be manually compiled into Nginx:
|
||||
|
||||
# Install LuaJIT 2.0 (Recommended) or Lua 5.1 (Lua 5.2 is ''not'' supported yet). Lua can be obtained free from the [http://luajit.org/download.html the LuaJIT download page] or [http://www.lua.org/ the standard Lua homepage]. Some distribution package managers also distribute Lua and LuaJIT.
|
||||
# Install LuaJIT 2.0 (Recommended) or Lua 5.1 (Lua 5.2 is ''not'' supported yet). LuajIT can be downloaded from the [http://luajit.org/download.html the LuaJIT project website] and Lua 5.1, from the [http://www.lua.org/ Lua project website]. Some distribution package managers also distribute LuajIT and/or Lua.
|
||||
# Download the latest version of the ngx_devel_kit (NDK) module [http://github.com/simpl/ngx_devel_kit/tags HERE].
|
||||
# Download the latest version of <code>ngx_lua</code> [http://github.com/chaoslawful/lua-nginx-module/tags HERE].
|
||||
# Download the latest version of Nginx [http://nginx.org/ HERE] (See [[#Nginx Compatibility|Nginx Compatibility]])
|
||||
|
|
@ -4260,14 +4260,14 @@ Build the source with this module:
|
|||
wget 'http://nginx.org/download/nginx-1.2.1.tar.gz'
|
||||
tar -xzvf nginx-1.2.1.tar.gz
|
||||
cd nginx-1.2.1/
|
||||
|
||||
# tell nginx's build system where to find LuaJIT:
|
||||
export LUAJIT_LIB=/path/to/luajit/lib
|
||||
export LUAJIT_INC=/path/to/luajit/include/luajit-2.0
|
||||
|
||||
# tell nginx's build system where to find lua:
|
||||
export LUA_LIB=/path/to/lua/lib
|
||||
export LUA_INC=/path/to/lua/include
|
||||
|
||||
# or tell where to find LuaJIT when if using JIT instead
|
||||
# export LUAJIT_LIB=/path/to/luajit/lib
|
||||
# export LUAJIT_INC=/path/to/luajit/include/luajit-2.0
|
||||
# or tell where to find Lua if using Lua instead:
|
||||
#export LUA_LIB=/path/to/lua/lib
|
||||
#export LUA_INC=/path/to/lua/include
|
||||
|
||||
# Here we assume Nginx is to be installed under /opt/nginx/.
|
||||
./configure --prefix=/opt/nginx \
|
||||
|
|
@ -4280,20 +4280,31 @@ Build the source with this module:
|
|||
|
||||
== Installation on Ubuntu 11.10 ==
|
||||
|
||||
To install lua 5.1 from repository run the following command:
|
||||
Note that it is recommended to use LuaJIT 2.0 instead of the standard Lua 5.1 interpreter where possible.
|
||||
|
||||
If the standard Lua 5.1 interpreter is required however, run the following command to install it from the Ubuntu repository:
|
||||
|
||||
<geshi lang="bash">
|
||||
apt-get install -y lua5.1 liblua5.1-0 liblua5.1-0-dev
|
||||
</geshi>
|
||||
|
||||
Everything should be installed correctly, except one small tweak. Library name <code>liblua.so</code> has been changed in liblua5.1 package, it
|
||||
only comes with <code>liblua5.1.so</code>, which needs to be symlinked to <code>/usr/lib</code> so it could be found during the configuration process.
|
||||
Everything should be installed correctly, except for one small tweak.
|
||||
|
||||
Library name <code>liblua.so</code> has been changed in liblua5.1 package, it only comes with <code>liblua5.1.so</code>, which needs to be symlinked to <code>/usr/lib</code> so it could be found during the configuration process.
|
||||
|
||||
<geshi lang="bash">
|
||||
ln -s /usr/lib/x86_64-linux-gnu/liblua5.1.so /usr/lib/liblua.so
|
||||
</geshi>
|
||||
|
||||
It is recommended, however, to use LuaJIT 2.0 instead of the standard Lua 5.1 interpreter with this module wherever possible.
|
||||
= Community =
|
||||
|
||||
== English Mailing List ==
|
||||
|
||||
The [https://groups.google.com/group/openresty-en openresty-en] mailing list is for English speakers.
|
||||
|
||||
== Chinese Mailing List ==
|
||||
|
||||
The [https://groups.google.com/group/openresty openresty] mailing list is for Chinese speakers.
|
||||
|
||||
= Bugs and Patches =
|
||||
|
||||
|
|
@ -4375,7 +4386,7 @@ This module is licensed under the BSD license.
|
|||
|
||||
Copyright (C) 2009-2012, by Xiaozhe Wang (chaoslawful) <chaoslawful@gmail.com>.
|
||||
|
||||
Copyright (C) 2009-2012, by Zhang "agentzh" Yichun (章亦春) <agentzh@gmail.com>.
|
||||
Copyright (C) 2009-2012, by Yichun "agentzh" Zhang (章亦春) <agentzh@gmail.com>.
|
||||
|
||||
All rights reserved.
|
||||
|
||||
|
|
|
|||
Загрузка…
Ссылка в новой задаче