利用宽乐通信实现PHP网页收发短信
一直想为网站提供收发短信的功能。
最近学习了一下宽乐通信, 它是电信提供的一个服务,是华为公司开发的,以WebService方式提供了收发短信的开发接口, 用PHP调用这个接口就可以收发短信了。
使用宽乐通信前,要先开通一个帐号、密码(在电信公司开通,帐号即电话号码,开通时要声明是WebService方式的,否则不能用)
发短信是需要收费的,每条8分,接收免费。
所谓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
发送短信的代码如下:
$sms = new Sms(); //产生一个Sms类的对象if ($sms->login($account, $password)) //登录 $sms->send("139876XXXXX", "hello,sms"); //发短信