微信公众平台提供的接口很简单,先看看消息交互流程:
说的通俗一些,用户使用微信发送消息 -> 微信将数据发送给开发者 -> 开发者处理消息并返回数据至微信 -> 微信把返回数据发送给用户,期间数据交互通过XML完成,就这么简单。
下面写个实例,开发微信智能聊天机器人:
1. 注册微信公众平台账号
微信公众平台:
https://mp.weixin.qq.com/
注: 目前一张身份证只能注册两个账号,账号名称关乎加V认证,请慎重注册。
2. 申请服务器/虚拟主机
没有服务器/虚拟主机的童鞋可以使用BAE和SAE,不多介绍。
3. 开启开发者模式
微信公众平台有两个模式,一个是编辑模式(傻瓜模式),简单但功能单一。另一个是开发者模式,可以通过开发实现复杂功能。两个模式互斥,显而易见,登录微信公众平台并通过“高级功能”菜单开启开发者模式。
4. 填写接口配置信息
同样是在“高级功能”菜单中配置,需要配置两项参数:
URL: 开发者应用访问地址,目前仅支持80端口,以“http://www.YoonPer.com/weixin/index.php”为例。
TOKEN: 随意填写,用于生成签名,以“YoonPer”为例。
填写完把下面代码保存为index.php并上传至http://www.YoonPer.com/weixin/目录,最后点击“提交”完成验证。
<?php
define(
"TOKEN"
,
"YoonPer"
);
//TOKEN值
$wechatObj
=
new
wechat();
$wechatObj
->valid();
class
wechat {
public
function
valid() {
$echoStr
=
$_GET
[
"echostr"
];
if
(
$this
->checkSignature()){
echo
$echoStr
;
exit
;
}
}
private
function
checkSignature() {
$signature
=
$_GET
[
"signature"
];
$timestamp
=
$_GET
[
"timestamp"
];
$nonce
=
$_GET
[
"nonce"
];
$token
= TOKEN;
$tmpArr
=
array
(
$token
,
$timestamp
,
$nonce
);
sort(
$tmpArr
);
$tmpStr
= implode(
$tmpArr
);
$tmpStr
= sha1(
$tmpStr
);
if
(
$tmpStr
==
$signature
) {
return
true;
}
else
{
return
false;
}
}
}
?>
这玩意儿就是微信公众平台校验URL是否正确接入,研究代码没有实质性意义,验证完即可删除文件,就不详细说明了,有兴趣的童鞋可以查看官方文档。
微信公众平台API文档:
http://mp.weixin.qq.com/wiki/index.php
5. 开发微信公众平台功能
OK,上面提到了,微信公众平台与开发者之间的数据交互是通过XML完成的,既然用到XML,当然得遵循规范,所以在着手开发之前先看看官方接口文档提供的XML规范,以文本消息为例:
当用户向微信公众账号发送消息时,微信服务器会POST给开发者一些数据:
<
xml
>
<!--开发者微信号-->
<
ToUserName
>
<![CDATA[toUser]]>
</
ToUserName
>
<!--发送方帐号(OpenID)-->
<
FromUserName
>
<![CDATA[fromUser]]>
</
FromUserName
>
<!--消息创建时间 (整型)-->
<
CreateTime
>12345678</
CreateTime
>
<!--消息类别 (text文本消息)-->
<
MsgType
><![CDATA1]></
MsgType
>
<!--消息内容-->
<
Content
>
<![CDATA[content]]>
</
Content
>
<!--消息ID (64位整型)-->
<
MsgId
>1234567890123456</
MsgId
>
</
xml
>
开发者在处理完消息后需要返回数据给微信服务器:
<
xml
>
<!--接收方帐号(OpenID)-->
<
ToUserName
>
<![CDATA[toUser]]>
</
ToUserName
>
<!--开发者微信号-->
<
FromUserName
>
<![CDATA[fromUser]]>
</
FromUserName
>
<!--消息创建时间 (整型)-->
<
CreateTime
>12345678</
CreateTime
>
<!--消息类别 (text文本消息)-->
<
MsgType
><![CDATA1]></
MsgType
>
<!--回复消息内容-->
<
Content
>
<![CDATA[content]]>
</
Content
>
<!--星标操作(位0x0001被标志时 星标刚收到的消息)-->
<
FuncFlag
>0</
FuncFlag
>
</
xml
>
除文本消息外,微信公众平台还支持用户发送图片消息、地理位置消息、链接消息、事件推送,而开发者还可以向微信公众平台回复音乐消息和图文消息,各类消息XML规范也可以参见官方文档。
来看看官方提供的一个PHP示例,我做了一些精简:
<?php
/*-------------------------------------------------
| index.php [ 微信公众平台接口 ]
+--------------------------------------------------
| Author: LimYoonPer
+------------------------------------------------*/
$wechatObj
=
new
wechat();
$wechatObj
->responseMsg();
class
wechat {
public
function
responseMsg() {
//---------- 接 收 数 据 ---------- //
$postStr
=
$GLOBALS
[
"HTTP_RAW_POST_DATA"
];
//获取POST数据
//用SimpleXML解析POST过来的XML数据
$postObj
= simplexml_load_string(
$postStr
,
'SimpleXMLElement'
,LIBXML_NOCDATA);
$fromUsername
=
$postObj
->FromUserName;
//获取发送方帐号(OpenID)
$toUsername
=
$postObj
->ToUserName;
//获取接收方账号
$keyword
= trim(
$postObj
->Content);
//获取消息内容
$time
= time();
//获取当前时间戳
//---------- 返 回 数 据 ---------- //
//返回消息模板
$textTpl
= "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[%s]]></MsgType>
<Content><![CDATA[%s]]></Content>
<FuncFlag>0</FuncFlag>
</xml>";
$msgType
=
"text"
;
//消息类型
include
(
'simsimi.php'
);
$contentStr
= simsimi(
$keyword
);
//返回消息内容
//格式化消息模板
$resultStr
= sprintf(
$textTpl
,
$fromUsername
,
$toUsername
,
$time
,
$msgType
,
$contentStr
);
echo
$resultStr
;
//输出结果
}
}
?>
把代码保存为index.php并上传至http://www.YoonPer.com/weixin/目录,如果刚才没删除该文件,则直接覆盖。
现在用户通过微信公众平台发送任何消息公众账号均会返回一条内容为“http://www.YoonPer.com”的消息。
接下来需要做的就是根据用户消息动态返回结果~
SimSimi(小黄鸡)是目前比较火的聊天机器人,我用CURL开发了一个免费的SimSimi(小黄鸡)接口,传入关键词会返回文本回复,这部分不是本文重点,就不多说明,直接上代码(2014.07.28更新):
<?php
/*-------------------------------------------------
| simsimi.php [ 智能聊天(simsimi) ]
+--------------------------------------------------
| Author: LimYoonPer
+------------------------------------------------*/
function
simsimi (
$keyword
)
{
$keyword
= urlencode(
$keyword
);
//----------- 获取COOKIE ----------//
$url
=
"http://www.simsimi.com/"
;
$ch
= curl_init(
$url
);
curl_setopt(
$ch
, CURLOPT_HEADER, 1);
curl_setopt(
$ch
, CURLOPT_RETURNTRANSFER, 1);
$content
= curl_exec(
$ch
);
list(
$header
,
$body
) =
explode
(
"\r\n\r\n"
,
$content
);
preg_match_all(
"/set\-cookie:([^\r\n]*);/iU"
,
$header
,
$matches
);
$cookie
= implode(
';'
,
$matches
[1]).
";simsimi_uid=1;"
;
curl_close(
$ch
);
//----------- 抓 取 回 复 ----------//
$url
=
"http://www.simsimi.com/func/reqN?lc=ch&ft=0.0&req=$keyword&fl=http%3A%2F%2Fwww.simsimi.com%2Ftalk.htm"
;
$ch
= curl_init(
$url
);
curl_setopt(
$ch
, CURLOPT_RETURNTRANSFER, 1);
curl_setopt(
$ch
, CURLOPT_COOKIE,
$cookie
);
$content
= json_decode(curl_exec(
$ch
), 1);
curl_close(
$ch
);
if
(
$content
[
'result'
] ==
'200'
) {
return
$content
[
'sentence_resp'
];
}
else
{
return
'我还不会回答这个问题...'
;
}
}
?>
把上面两段代码整合在一起就大功告成了,需要说明一点,微信服务器在5秒内收不到响应会断掉连接,通过此接口有可能会超时,且SimSimi已经屏蔽了BAE和SAE上的抓取请求,推荐使用SimSimi官方收费API,速度比较快~
希望本文所述对大家基于php的微信公众平台开发有所帮助。