利用阔乐通信实现PHP网页收发短信

利用宽乐通信实现PHP网页收发短信

一直想为网站提供收发短信的功能。

最近学习了一下宽乐通信,  它是电信提供的一个服务，是华为公司开发的，以WebService方式提供了收发短信的开发接口， 用PHP调用这个接口就可以收发短信了。

使用宽乐通信前，要先开通一个帐号、密码（在电信公司开通，帐号即电话号码，开通时要声明是WebService方式的，否则不能用）

发短信是需要收费的，每条8分，接收免费。

宽乐通信有一个接口文档，用于二次开发的。在百度搜索 ”宽乐通信接口“ 即可找到

宽乐通信提供两种接口：

一种是SDK方式，即以Windows COM组件方式提供，用于编写Windows客户端程序

另一种是WebService方式，可用于网站开发。

所谓WebService，就是Web服务，是一种网络函数，可以看作另一个网站给你提供的函数，是一个网站调用另一个网站的功能的一种标准接口，具体来说，如果要调用其它网站的功能，向指定的URL发出一个POST请求，请求内容中包含的函数名和参数(XML格式), 响应结果中是函数返回值。  要详细了解WebService的数据格式, 具体看相关文档。

PHP5中提供了两个类  SoapClient (客户端, 使用WebService）和 SoapServer(服务器，提供WebService），可以很容易地调用WebService.

宽乐通信接口文档很长，简单讲一下收发短信的原理：

宽乐通信提供了一系列接口，其中与短信相关的有： Register, SendSMS两个接口

发短信的过程：

1， 首先通过WebService方式调用  Register 接口中的 函数  getRandom(), 取得宽乐通信平台下发的一个随机数rand

2， 然后调用 Register 接口中的 setCallBackAddr()函数实现登录

       函数原型：String setCallBackAddr(String uc, String pw, String rand, String url);

        参数： uc 是帐号

                     pw 是getRandom获取的随机数 rand+UC密码+UC密码 经过MD5加密后的字符串 (就是把rand与密码字符串两次相连后，进行MD5加密）

                     rand 是getRandom获取的随机数

                     url 是回调函数的url (这个回调函数是在接收短信时用到的，在这个URL上你要先实现一个WebService, 当你的宽乐通信帐号收到短信，宽乐通信平台将会调用你的WebService)

         返回值是一个连接ID (connID), 这个ID用于后续发短信

3，然后，就可以通过调用 SendSMS 接口中的 sendSMS()函数发送短信了

       函数原型：String sendSMS(String uc, String pw, String rand, String callee[], String isreturn, String cont, int msgid, String connID);

       参数： uc 是帐号

                    pw 是getRandom获取的随机数 rand+UC密码+UC密码 经过MD5加密后的字符串 (就是把rand与密码字符串两次相连后，进行MD5加密）

                    rand 是getRandom获取的随机数

                    callee 是接收短信的号码，是一个字符串数组，可以放多个号码

                    isreturn 是否需要短信回执，这是宽乐通信很强的一个功能，当接收方已接收到短信，则宽乐通信平台会发送一个回执给短信发送方

                     cont  是短信内容，中文必须是gbk编码， 还要再进行base64编码

                    msgid 是短信的唯一编号， 你自己编的，收到短信回执中有这个msgid编号，这样就可以知道是哪条短信被接收了

                     connID 就是setCallBackAddr()函数返回的连接ID

收短信的过程：

调用 setCallBackAddr() 函数时要提供一个回调函数的url , 把这个URL指向你的网站，在这个URL上你要先实现一个WebService, 提供三个函数：echoOfSendSMS(), recvSMS(), NotifyStatus().

当收到短信时，宽乐通信平台会调用你指定的URL中的recvSMS()函数

当收到短信回执时，宽乐通信平台会调用你指定的URL中的echoOfSendSMS()函数

当状态变化时，宽乐通信平台会调用你指定的URL中的NotifyStatus()函数

你在自已的网站通过编写这三个webservice函数, 就可以实现接收短信了。

函数原型：String recvSMS(String caller, String time, String cont, String ucNum);

       参数： caller是发送短信的号码，cont是短信内容(需要base64解码）,  ucNum是短信接受者号码

函数原型：void echoOfSendSMS(String ucNum, String cee, int msgid, int res, String recvt);

函数原型：void NotifyStatus(int eventID, String sessionID,int res,String para1);

原理讲完了，看一下PHP代码的实现：

开发语言：PHP 5.X

发送短信的代码如下：

$uc="02087XXXX1";    //宽乐通信帐号
$pass="uu1XXXX56";   //宽乐通信密码
$callBackURL='http://www.some.com/receive_sms.php'; //回调URL,如果不想接收短信，则这个URL可以随便写

$urlRegister="http://202.105.212.146:8080/jboss-net/services/Register?wsdl"; //Register接口URL
$client = new SoapClient($urlRegister); //生成一个SoapClient对象, 使用Register接口
$rand = $client->__call("getRandom", array()); //调用getRandom()函数，取得随机数
$pw = md5($rand.$pass.$pass); //计算PW值，
$connID = $client->__call("setCallBackAddr", array($uc,$pw,$rand,$callBackURL));//调用setCallBackAddr()函数，取得连接ID
if ($connID__call("sendSMS", array($uc,$pw,$rand,$callee,$needReceipt,$content,$msgId,$connID));
if ($result==0) {  //如果返回值为0，则发送成功
  print "send OK";
} else {
  print "send error, error code=".$result; //否则，返回值即是错误码
}

程序注释已经很清晰了，补充说明：上述程序中的帐号、密码要更改为你的实际帐号密码

下面是，接收短信的php代码, 文件： receive_sms.php

/**
 * 接收短信回执
 * 函数原型：void echoOfSendSMS(String ucNum, String cee, int msgid, int res, String recvt);
 * @param string $ucNum 发送方号码
 * @param string $cee 接收方号码
 * @param int $msgid 短消息编号，用于客户端匹配请求消息
 * @param int $res 回执的结果(=1表示接收方成功接收短信， -1为系统异常；-12：系统超时；-92：短信无法送达对方）
 * @param string $recvt 短消息时间
 * @return 无返回值
 */
function echoOfSendSMS($ucNum,$cee,$msgid,$res,$recvt){
    $filename = "echo.txt";
    $data = "ucNum=".$ucNum." cee=".$cee." msgid=".$msgid." res=".$res." recvt=".$recvt."\r\n";
    file_put_contents($filename, $data, FILE_APPEND);
}

/**
 * 接收短信
 * 函数原型：String recvSMS(String caller, String time, String cont, String ucNum);
 * @param string $caller 短信的发送者号码
 * @param string $time 短信发送时间
 * @param string $cont 短信内容（需要对短信内容进行BASE64解码）
 * @param string $ucNum 短信接受者号码（接收短信的UC号码）
 * @return string =0：成功返回,  "http://www.some.com/receive_sms.php"));//这个uri要写本php文件所在的uri  

//注册三个函数
$server->addFunction(array("echoOfSendSMS","recvSMS","NotifyStatus"));

//启动soap server
$server->handle();

程序注释很清晰，就是定义三个函数，生成一个WebService服务
程序中接收到短信后，只是存盘。你可以修改recvSMS()函数，增加自己想要的功能，比如：写数据库、回复短信等

为简化发送短信的过程，我编写了一个Sms类，对发短信过程进行了封装，使用者不需要懂宽乐通信接口，只要有宽乐通信帐号密码，发送短信只需要三句，例如：

$sms = new Sms(); //产生一个Sms类的对象
if ($sms->login($account, $password))   //登录
    $sms->send("139876XXXXX", "hello,sms"); //发短信

够简单了吧。 

Sms类的源码文件 class.Sms.php 及接收短信的源码 receive_sms.php 可以在我的资源中下载，分享给大家

网站能收发短信后，就可以实现很多功能，比如：发送验证码、有人登录网站时可以发短信通知到你的手机、发短信就可以触发网站运行。
网站因此就活动起来了！！！