opensips开启lua支持

操作系统 :CentOS 7.6_x64

opensips版本 :2.4.9

lua版本:5.1
今天整理下CentOS7环境下opensips2.4.9的lua模块笔记及使用示例,并提供运行效果截图。我将从以下几方面进行展开:

  • 模块安装说明

  • 模块参数说明

  • 模块函数说明

  • 模块使用示例

lua模块官方文档:

https://opensips.org/docs/modules/2.4.x/lua.html

一、安装lua模块

1)安装lua模块依赖的开发库

复制代码
yum install lua-devel.x86_64 libmemcached-devel.x86_64

2)进入opensips源码目录

复制代码
cd opensips-2.4.9

3)编译时选中 lua 模块

4)编译及安装opensips

复制代码
make && make install

CentOS7环境下源码安装opensips,可参考如下文章:

CentOS7环境源码安装opensips2.4.9

二、模块参数说明

这里列举下常用参数,完整内容参考官方文档。模块文件:lua.so模块参数如下:

  • luafilename

lua脚本文件的路径,该文件包含需要调用的lua函数。

该参数只能设置一次,设置多次的话后面的会把前面的替换掉,只加载最后一个lua文件。

示例如下:

复制代码
modparam("lua", "luafilename", "/usr/local/etc/opensips/op-test1.lua")

三、函数说明

这里列下常用的函数,其它函数参考官方文档。

1、模块函数(op配置文件中使用)

  • lua_exec

    用于执行lua函数。

2、lua脚本可用函数

这里列下常用的函数,其它函数参考官方文档。

  • xlog

输出日志,级别(可选)如下:

ALERT

CRIT

ERR

WARN

NOTICE

INFO

DBG

示例如下:

复制代码
xlog("luaTest1 return true\n");
  • getMethod

获取sip msg的方法,比如INVITE等。

示例如下:

复制代码
xlog("msg method : " ..  getMethod(msg) .. "\n")
  • getType

获取sip msg的类型,返回 "SIP_REQUEST" 或 "SIP_REPLY"

示例代码:

复制代码
xlog("Type : " ..  getType(msg) .. "\n")
  • getURI_User

获取dst uri里面的值

示例代码:

复制代码
xlog("URI_User: " ..  getURI_User(msg) .. "\n")
  • getHeader

获取sip头,示例如下:

复制代码
xlog("sip.Content-Type: " ..  getHeader(msg,"Content-Type") .. "\n")
  • moduleFunc

调用opensips其它模块的函数。

比如:

复制代码
moduleFunc(msg,'sl_send_reply',"483","Too Many Hops")

四、使用示例

这里演示下lua模块的加载,及使用该模块进行简单测试。

opensips机器:192.168.137.33

Freeswitch机器:192.168.137.32

1、模块加载及日志打印

使用 xlog 函数打印日志。

示例代码(op-test1.lua):

复制代码
function luaTest1(msg)
    xlog("this is a lua test message\n")
    return 1
end

其中,msg是默认参数。

opensips.cfg配置如下:

复制代码
#### lua module
loadmodule "lua.so"
modparam("lua", "luafilename", "/usr/local/etc/opensips/op-test1.lua")

####### Routing Logic ########

# main request routing logic

route{

    if (lua_exec("luaTest1")) {
        xlog("luaTest1 return true\n");
    }

重启opensips :opensipsctl restart

呼叫测试:

复制代码
originate {}sofia/external/[email protected]:5060 &echo

运行效果如下:

2、调用msg函数

lua脚本示例如下:

复制代码
function luaTest2(msg)
    xlog("Type : " ..  getType(msg) .. "\n")
    xlog("msg method : " ..  getMethod(msg) .. "\n")
    xlog("URI_User: " ..  getURI_User(msg) .. "\n")
    xlog("sip.Content-Type: " ..  getHeader(msg,"Content-Type") .. "\n")
    moduleFunc(msg,'sl_send_reply',"483","Too Many Hops")
    return 1
end

opensips.cfg配置如下:

重启opensips :opensipsctl restart

呼叫测试:

复制代码
originate {}sofia/external/[email protected]:5060 &echo

运行效果如下:

好,就这么多了,别忘了点赞哈!

相关推荐
monstercl3 小时前
Lua中基础函数使用详解
lua·脚本语言
爱的叹息3 小时前
Spring Boot 集成Redis 的Lua脚本详解
spring boot·redis·lua
爱学测试的雨果2 天前
Postman —— postman实现参数化
软件测试·功能测试·测试工具·lua·postman
老狼孩111227 天前
全分辨率免ROOT懒人精灵-自动化编程思维-设计思路-实战训练
运维·自动化·lua·脚本开发·懒人精灵·全分辨率免root
数据知道7 天前
【Lua】一文快速掌握 Lua 语言指令(Lua 备忘清单)
开发语言·junit·lua
非衣居士7 天前
Lua程序设计笔记
lua·游戏开发
Winston-Tao9 天前
Skynet 中 snlua 服务启动整体流程分析
lua·游戏开发·c 语言·skynet·游戏服务器框架
发财哥fdy10 天前
3.24-3 接口测试断言
开发语言·lua
ZZDICT10 天前
OpenResty(Lua)+Redis实现动态封禁IP
redis·nginx·lua·openresty
monstercl10 天前
skynet网络包库(lua-netpack.c)的作用解析
c语言·网络·lua·skynet·游戏服务器