opensips开启python支持

申建兵

操作系统 ：CentOS 7.6_x64  opensips版本： 2.4.9  python版本：2.7.5python作为脚本语言，使用起来很方便，查了下opensips的文档，支持使用python脚本写逻辑代码。今天整理下CentOS7环境下opensips2.4.9的python模块笔记及使用示例，并提供运行效果视频和配套文件下载。
我将从以下几方面进行展开：

• 模块安装说明
  
• 模块参数说明
  
• 模块函数说明
  
• 模块使用示例
  

python模块官方文档：
https://opensips.org/docs/modules/2.4.x/python.html

一、模块安装说明

1）安装python开发库

1. yum install  python-devel.x86_64

复制代码

2）进入opensips源码目录

1. cd opensips-2.4.9

复制代码

3）选中 python 模块

1. make menuconfig

复制代码

 4）编译及安装opensips

1. make && make install

复制代码

 CentOS7环境下源码安装opensips，可参考如下文章：
CentOS7环境源码安装opensips2.4.9
二、模块参数说明

模块文件： python.so
模块参数如下：

• script_name
  用于设置python脚本的路径。
  
• mod_init_function
  用于设置python脚本的初始化函数，默认是mod_init
  
• child_init_method
  用于设置python脚本的子进程（子类）的初始化函数，默认是child_init
  

模块加载及配置数据库
文件：opensips.cfg
配置示例：

1. #### python module
2. loadmodule "python.so"
3. modparam("python", "script_name", "/usr/local/etc/opensips/op-test1.py")
4. #modparam("python", "mod_init_function", "module_initializer")
5. #modparam("python", "child_init_method", "child_initializer")

复制代码

三、函数说明

1、cfg文件调用函数

函数： python_exec

1. python_exec(method_name [, extra_args])

复制代码

该函数调用python脚本里面的方法。
2、python脚本内部调用函数

2.1 LM_ERR函数
在python里面，opensips作为独立的模块，导出了LM_ERR函数，定义如下（python_iface.c）：

 该函数用于打印日志，示例如下：

1. LM_ERR('test msg from python')

复制代码

2.2 sip msg相关属性及方法
属性定义如下（python_msgobj.c）：

 方法定义如下（python_msgobj.c）：

• Type
  msg的类型，SIP_REQUEST 或 SIP_REPLY
  
• Method
  msg的方法，比如："INVITE"
  
• Status
  msg的状态，只适用于reply
  
• RURI
  msg的R-URI，只适用于request
  
• src_address
  msg的源地址信息
  
• dst_address
  msg的目的地址信息
  
• copy()
  复制当前SIP消息
  
• rewrite_ruri(uri)
  修改msg的request URI，仅适用于request
  
• set_dst_uri(uri)
  修改msg的destination URI ，仅适用于request
  
• getHeader(hdr)
  获取SIP头的具体内容
  
• call_function(funName,...)
  调用其它模块的函数
  

四、使用示例

这里演示下python模块的加载，及使用该模块进行简单测试。
1、打印日志

使用LM_ERR函数进行日志打印。
示例代码（op-test1.py）：

1. from OpenSIPS import LM_ERR
3. class ObjA():
4.     def child_init(self,rank):
5.         return 0
7.     def pytest1(self,var1):
8.           LM_ERR("test msg from python script")
9.           return 1
11. def mod_init():
12.     return ObjA()

复制代码

opensips.cfg配置如下：

1. #### python module
2. loadmodule "python.so"
3. modparam("python", "script_name", "/usr/local/etc/opensips/op-test1.py")
4. #modparam("python", "mod_init_function", "module_initializer")
5. #modparam("python", "child_init_method", "child_initializer")####### Routing Logic ######### main request routing logicroute{    if(python_exec("pytest1"))  {        xlog("python test1 return true\n");    }    exit;

复制代码

运行效果如下：

运行效果视频可从如下渠道获取：
关注微信公众号（聊聊博文，文末可扫码）后回复 2024042301 获取。
2、调用其它模块函数

示例代码及配置可从如下渠道获取：
关注微信公众号（聊聊博文，文末可扫码）后回复 20240423 获取。
运行效果如下：

 运行效果视频可从如下渠道获取：
关注微信公众号（聊聊博文，文末可扫码）后回复 2024042302 获取。
3、实现呼叫路由

这里演示下python调用drouting模块函数实现话务路由的功能。
机器列表：
freeswitchA ：192.168.137.31:5080
opensips ：192.168.137.33:5060
freeswitchB ：192.168.137.32:5080
测试目标：将freeeswitchA呼叫opensips的通话路由到freeswitchB机器。
拨号方案等信息参考如下文章：
opensips使用drouting进行路由
示例代码及配置可从如下渠道获取：
关注微信公众号（聊聊博文，文末可扫码）后回复 20240423 获取。
运行效果如下：

 抓包效果如下：

 运行效果视频可从如下渠道获取：
关注微信公众号（聊聊博文，文末可扫码）后回复 2024042303 获取。
五、资源下载

本文涉及资源，可以从如下途径获取：
关注微信公众号（聊聊博文，文末可扫码）后回复 20240423 获取。

 好，就这么多了，别忘了点赞哈！

来源:https://www.cnblogs.com/MikeZhang/p/18154182/opCallPy20240423
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！