OpenResty学习笔记一

最新推荐文章于 2025-05-21 11:30:00 发布

原创最新推荐文章于 2025-05-21 11:30:00 发布 · 398 阅读

0 ·

CC 4.0 BY-SA版权

OpenResty 专栏收录该内容

5 篇文章

订阅专栏

本文档介绍了如何安装OpenResty，包括lua环境与lua库的设置，详细阐述了配置环境的过程，特别是HttpLuaModule的使用。在配置完成后，通过一个简单的HelloWorld示例展示了如何在OpenResty中运行lua代码，并提到了lua代码的外部存储与lua_code_cache的管理。在遇到问题时，建议检查错误日志。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

OpenResty学习笔记一

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

安装环境

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

lua语法，nginx基本使用等可参考https://moonbingbing.gitbooks.io/openresty-best-practices/

目录简要介绍

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

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

{prefix}/nginx ：安装的nginx；

查看nginx版本和安装的模块：

 {prefix}/nginx/sbin/nginx  -V

启动nginx：

 {prefix}/nginx/sbin/nginx

配置环境

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

编辑nginx.conf配置文件

vi  {prefix}/nginx/conf/nginx.conf

在http部分添加如下配置

#lua模块路径，多个之间”;”分隔，其中”;;”表示默认搜索路径，默认到/usr/servers/nginx下找  
lua_package_path "{prefix}/lualib/?.lua;;";  #lua 模块  
lua_package_cpath "{prefix}/lualib/?.so;;";  #c模块

方便管理在 {prefix}/nginx/conf目录下创建一个lua.conf

#lua.conf  
server {  
    listen       80;  
    server_name  _;  
}

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

include lua.conf;

测试

{prefix}/nginx/sbin/nginx  -t

HelloWorld

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

location /lua {  
    default_type text/html;  
        content_by_lua ngx.say("hello world");  
}

测试配置是否正确

{prefix}/nginx/sbin/nginx  -t

重启nginx

{prefix}/nginx/sbin/nginx  -s reload

访问http://{ip}/lua ，可以看到hello world
lua代码文件
lua代码放在nginx配置中会随着lua的代码的增加导致配置文件太长不好维护，因此我们应该把lua代码移到外部文件中存储。

vi {prefix}/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安装目录 也可以使用绝对路径
}

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; #相对于nginx安装目录 也可以使用绝对路径
}

7、错误日志
如果运行过程中出现错误，请不要忘记查看错误日志

tail -f {prefix}/nginx/logs/error.log