Openresty使用

Posted 2022-07-14 soy-technology

OpenResty是一个全功能的 Web 应用服务器。它打包了标准的 nginx 核心，常用的第三方模块以及大多数依赖项。 可以把它看成是Nginx附加众多的第三方插件的合集。其主体是嵌入lua脚本的支持，让你能够使用lua灵活地处理运算逻辑。

本课程主要讲lua为Nginx带来的新的处理方式，及OpenResty组件的使用。

12.1. Openresty的安装配置

12.1.1. 简易的yum安装方式

此方式简单，缺点是无法干预启停插件

yum install yum-utils

yum-config-manager --add-repo https://openresty.org/package/centos/openresty.repo

yum install openresty 

12.1.2. 源码安装方式

wget https://openresty.org/download/openresty-1.15.8.1.tar.gz 

tar -zxvf openresty-1.15.8.1.tar.gz 

##选择需要的插件启用, --with-Components 激活组件，--without 则是禁止组件 

./configure  --without-http_redis2_module  --with-http_iconv_module

make  && make install

 

vi /etc/profile ##加入path路径

export PATH=$PATH:/usr/local/openresty/nginx/sbin/

source /etc/profile ##生效配置

12.1.3. 安装检测

nginx  -V   ##如下显示，则表示安装成功

 

 

12.2. Lua介入Nginx带来的基础api

主要帮助对http请求取参、取header头、输出等

ngx.arg	指令参数，如跟在content_by_lua_file后面的参数
ngx.var	request变量，ngx.var.VARIABLE引用某个变量
ngx.ctx	请求的lua上下文
ngx.header	响应头，ngx.header.HEADER引用某个头
ngx.status	响应码
ngx.log	输出到error.log
ngx.send_headers	发送响应头
ngx.headers_sent	响应头是否已发送
ngx.resp.get_headers	获取响应头
ngx.is_subrequest	当前请求是否是子请求
ngx.location.capture	发布一个子请求
ngx.location.capture_multi	发布多个子请求
ngx.print	输出响应
ngx.say	输出响应，自动添加‘\\n‘
ngx.flush	刷新响应
ngx.exit	结束请求

12.3. Lua嵌入Nginx的时机阶段

Nginx执行lua脚本片断时，需要明确指明执行的nginx阶段时机。主要有以下几种时机：

 

set_by_lua* : 设置nginx变量，实现复杂的赋值逻辑 

rewrite_by_lua* : 实现转发、重定向等功能 

access_by_lua* : IP 准入、接口访问权限等情况集中处理 

content_by_lua* : 接收请求处理并输出响应 

header_filter_by_lua* : 设置header和cookie

body_filter_by_lua* : 对响应数据进行过滤，如截断/替换等

12.4. Lua基础功能使用介绍

12.4.1. hello world

在content阶段，执行lua脚本，输出hello，peter

 

 

12.4.2. 执行lua脚本文件

 

 

12.4.3. lua取get参数

页面请求路径：http://lua.enjoy.com/args?a=20&b=50

则ngx.var.arg_a即取得a参数值，如下图：

 

 

12.4.4. lua取全量参数

请求：http://lua.enjoy.com/args_read?a=20&b=50

 

 

12.4.5. lua取request中header信息

 

 

12.4.6. 给lua脚本传参

使用端传参：

 

 

脚本中借助ngx.arg取参

 

 

12.4.7. 权限校验

一般校验动作，指定在access阶段执行脚本

 

 

脚本处理

 

 

12.4.8. 内容过滤

Nginx有时候，需要对下游服务生成的内容进行处理过滤，如下图

 

 

脚本中的处理

 

 

12.5. Lua引入第三方模块的使用

OpenResty提供了非常多的第三方插件，支持操作redis/mysql等服务，lua使用它们的模式一般按以下流程

u require  “resty/xxx” ：导入模块功能，类似java中的import导入类

u local  obj = xxx:new() ：模块创建对象obj

u local ok, err  = obj :connect ：对象连接到目标库

u obj :method ：这里可以为所欲为，尽情操纵目标库了

 

12.5.1. Lua-resty-redis连接redis用法

Lua-resty-redis插件，对Nginx操作redis的支持十分强大，成熟的用法演示如下：

基础的引入、连接动作

 

 

redis操作动作

 

 

具体全量的程序，见源码配置包

12.5.2. Lua-resty-mysql连接mysql数据库

引入模块、创建连接

 

 

mysql查询操作