本文分享自华为云社区《华为云短信服务教你用Perl完成Smgp协议》，作者：张俭。

引言&协议概述

中国电信短消息网关协议（SMGP）是中国网通为完成短信业务而制定的一种通讯协议，全称叫做Short Message Gateway Protocol，用于在短消息网关（SMGW）和服务供给商（SP）之间、短消息网关（SMGW）和短消息网关（SMGW）之间通讯。

Perl是一个老牌脚本语言，在很多Linux系统上都会默认装置，比如在ubuntu的22.04版别的根底镜像中，乃至没有Python，可是仍然装置了Perl，Perl的遍及度可见一斑。Perl的IO::Async模块供给了一套简洁的异步IO编程模型。

SMGP 协议基于客户端/服务端模型工作。由客户端（短信运用，如手机，运用程序等）先和短信网关（SMGW Short Message Gateway）建立起 TCP 长衔接，并运用 CNGP 命令与SMGW进行交互，完成短信的发送和接纳。在CNGP协议中，无需同步等待呼应就能够发送下一个指令，完成者能够依据自己的需要，完成同步、异步两种消息传输形式，满意不同场景下的性能要求。

时序图

衔接成功，发送短信

衔接成功，从SMGW接纳到短信

协议帧介绍

SMGP Header

Header包含以下字段，巨细长度都是4字节

Packet Length：整个PDU的长度，包括Header和Body。
Request ID：用于标识PDU的类型（例如，Login、Submit等）。
Sequence Id：序列号，用来匹配请求和呼应。

运用perl完成SMGP协议栈里的建立衔接

├── Makefile.PL
├── examples
│   └── smgp_client_login_example.pl
└── lib
    └── Smgp
        ├── BoundAtomic.pm
        ├── Client.pm
        ├── Constant.pm
        └── Protocol.pm

Makefile.PL：用来生成Makefile

examples：寄存示例代码

smgp_client_login_example.pl：寄存Smgp的login样例

lib/Smgp：包含所有的Perl模块文件

BoundAtomic.pm：递加工具类，用来生成SequenceId
Client.pm：Smgp界说，担任与Smgp服务进行通讯，例如建立衔接、发送短信等
Protocol.pm：寄存PDU，编解码等

完成sequence_id递加

sequence_id是从1到0x7FFFFFFF的值

package Smgp::BoundAtomic;
use strict;
use warnings FATAL => 'all';
sub new {
    my ($class, %args) = @_;
    my $self = {
        min     => $args{min},
        max     => $args{max},
        value   => $args{min},
    };
    bless $self, $class;
    return $self;
}
sub increment {
    my ($self) = @_;
    if ($self->{value} >= $self->{max}) {
        $self->{value} = $self->{min};
    } else {
        $self->{value}++;
    }
    return $self->{value};
}
sub get {
    my ($self) = @_;
    return $self->{value};
}
1;

在Perl中界说SMGP PDU以及编解码函数

package Smgp::Protocol;
use strict;
use warnings FATAL => 'all';
use Smgp::Constant;
sub new_login {
    my ($class, %args) = @_;
    my $self = {
        clientId            => $args{clientId},
        authenticatorClient => $args{authenticatorClient},
        loginMode           => $args{loginMode},
        timeStamp           => $args{timeStamp},
        version             => $args{version},
    };
    return bless $self, $class;
}
sub encode_login {
    my ($self) = @_;
    return pack("A8A16CNC", @{$self}{qw(clientId authenticatorClient loginMode timeStamp version)});
}
sub decode_login_resp {
    my ($class, $buffer) = @_;
    my ($status, $authenticatorServer, $version) = unpack("N4A16C", $buffer);
    return bless {
        status              => $status,
        authenticatorServer => $authenticatorServer,
        version             => $version,
    }, $class;
}
sub new_header {
    my ($class, %args) = @_;
    my $self = {
        total_length   => $args{total_length},
        request_id     => $args{request_id},
        command_status => $args{command_status},
        sequence_id    => $args{sequence_id},
    };
    return bless $self, $class;
}
sub encode_header {
    my ($self, $total_length) = @_;
    return pack("N3", $total_length, @{$self}{qw(request_id sequence_id)});
}
sub new_pdu {
    my ($class, %args) = @_;
    my $self = {
        header => $args{header},
        body   => $args{body},
    };
    return bless $self, $class;
}
sub encode_login_pdu {
    my ($self) = @_;
    my $encoded_body = $self->{body}->encode_login();
    return $self->{header}->encode_header(length($encoded_body) + 12) . $encoded_body;
}
sub decode_pdu {
    my ($class, $buffer) = @_;
    my ($request_id, $sequence_id) = unpack("N2", substr($buffer, 0, 8));
    my $body_buffer = substr($buffer, 8);
    my $header = $class->new_header(
        total_length   => 0,
        request_id     => $request_id,
        sequence_id    => $sequence_id,
    );
    my $body;
    if ($request_id == Smgp::Constant::LOGIN_RESP_ID) {
        $body = $class->decode_login_resp($body_buffer);
    } else {
        die "Unsupported request_id: $request_id";
    }
    return $class->new_pdu(
        header => $header,
        body   => $body,
    );
}
1;

constant.pm寄存相关requestId

package Smgp::Constant;
use strict;
use warnings FATAL => 'all';
use constant {
    LOGIN_ID               => 0x00000001,
    LOGIN_RESP_ID          => 0x80000001,
    SUBMIT_ID              => 0x00000002,
    SUBMIT_RESP_ID         => 0x80000002,
    DELIVER_ID             => 0x00000003,
    DELIVER_RESP_ID        => 0x80000003,
    ACTIVE_TEST_ID         => 0x00000004,
    ACTIVE_TEST_RESP_ID    => 0x80000004,
    FORWARD_ID             => 0x00000005,
    FORWARD_RESP_ID        => 0x80000005,
    EXIT_ID                => 0x00000006,
    EXIT_RESP_ID           => 0x80000006,
    QUERY_ID               => 0x00000007,
    QUERY_RESP_ID          => 0x80000007,
    MT_ROUTE_UPDATE_ID     => 0x00000008,
    MT_ROUTE_UPDATE_RESP_ID => 0x80000008,
};
1;

完成client以及login办法

package Smgp::Client;
use strict;
use warnings FATAL => 'all';
use IO::Socket::INET;
use Smgp::Protocol;
use Smgp::Constant;
sub new {
    my ($class, %args) = @_;
    my $self = {
        host => $args{host} // 'localhost',
        port => $args{port} // 9000,
        socket => undef,
        sequence_id => 1,
    };
    bless $self, $class;
    return $self;
}
sub connect {
    my ($self) = @_;
    $self->{socket} = IO::Socket::INET->new(
        PeerHost => $self->{host},
        PeerPort => $self->{port},
        Proto => 'tcp',
    ) or die "Cannot connect to $self->{host}:$self->{port} $!";
}
sub login {
    my ($self, $body) = @_;
    my $header = Smgp::Protocol->new_header(
        request_id     => Smgp::Constant::LOGIN_ID,
        sequence_id    => 1,
    );
    my $pdu = Smgp::Protocol->new_pdu(
        header => $header,
        body   => $body,
    );
    $self->{socket}->send($pdu->encode_login_pdu());
    $self->{socket}->recv(my $response_length_bytes, 4);
    my $total_length = unpack("N", $response_length_bytes);
    my $remain_length = $total_length - 4;
    $self->{socket}->recv(my $response_data, $remain_length);
    return Smgp::Protocol->decode_pdu($response_data)->{body};
}
sub disconnect {
    my ($self) = @_;
    close($self->{socket}) if $self->{socket};
}
1;

运转example，验证衔接成功

package smgp_client_login_example;
use strict;
use warnings FATAL => 'all';
use Smgp::Client;
use Smgp::Protocol;
use Smgp::Constant;
sub main {
    my $client = Smgp::Client->new(
        host => 'localhost',
        port => 9000,
    );
    $client->connect();
    my $login = Smgp::Protocol->new_login(
        clientId            => '12345678',
        authenticatorClient => '1234567890123456',
        loginMode           => 1,
        timeStamp           => time(),
        version             => 0,
    );
    my $response = $client->login($login);
    if ($response->{status} == 0) {
        print "Login successful!n";
    }
    else {
        print "Login failed! Status: ", (defined $response->{status} ? $response->{status} : 'undefined'), "n";
    }
    $client->disconnect();
}
main() unless caller;
1;

总结

本文简单对SMGP协议进行了介绍，并尝试用perl完成协议栈，但实际商用发送短信往往愈加复杂，面临诸如流控、运营商对接、传输层安全等问题，能够选择华为云消息&短信（Message & SMS）服务通过HTTP协议接入，华为云短信服务是华为云携手全球多家优质运营商和途径，为企业用户供给的通讯服务。企业调用API或运用群发助手，即可运用验证码、通知短信服务。

点击关注，第一时间了解华为云新鲜技能~

教你用Perl实现Smgp协议

引言&协议概述

时序图

衔接成功，发送短信

衔接成功，从SMGW接纳到短信

协议帧介绍

SMGP Header

运用perl完成SMGP协议栈里的建立衔接

完成sequence_id递加

constant.pm寄存相关requestId

完成client以及login办法

运转example，验证衔接成功

相关开源项目

总结

作者信息

教你用Perl实现Smgp协议

引言&协议概述

时序图

衔接成功，发送短信

衔接成功，从SMGW接纳到短信

协议帧介绍

SMGP Header

运用perl完成SMGP协议栈里的建立衔接

完成sequence_id递加

constant.pm寄存相关requestId

完成client以及login办法

运转example，验证衔接成功

相关开源项目

总结

相关文章

在等GPT-5多模态？试试Genmo！Adobe AI首轮内测报告；ChatGPT三条使用哲学与实践；论文追更与阅读神器 | ShowMeAI日报

今天聊聊Java中的final关键字

数据结构 | 时间与空间复杂度就看这篇了【全站最详细】

VisionPro开发 – 利用视频材质实现一台复古小电视

作者信息