微信公众平台开发入门教程
信息摘自:http://www.cnblogs.com/txw1958/p/wechat-tutorial.html!请支持原版!
一、所需相关知识:
(1)、PHP语言程序;
(2)、MySQL数据库;
(3)、计算机网络通讯;
(4)、HTTP/XML/CSS/JS基础;
二、例子
以微信公众账号方倍工作室作为讲解的例子,二维码见底部(此处不提供);
本系列教程将引导你完成如下任务:
(1)、创建新浪云计算平台应用;
(2)、启用微信公众平台开发模式;
(3)、基础接口消息及事件;
(4)、微信公众平台PHP SDK;
(5)、微信公众平台开发模式原理;
(6)、开发天气预报功能;
三、开动:准备开始我们的微信旅游吧,我的伙伴们!
第一章 申请服务器资源
1、创建新浪云计算运用
(1)、申请账号
使用SAE新浪云计算平台作为服务器资源,并且申请PHP环境+MySQL数据库作为程序运行环境。申请地址:http://sae.sina.com.cn/,使用新浪微博账号可以直接登录SAE,登录后SAE将赠送500个免费云豆。
(2)、创建应用
-》[我的首页]
-》创建新应用-继续创建
填写完二级域名AppID、应用名称、验证码,开发语言选择PHP,应用类型选择web应用。然后点击创建应用
-》结果:应用创建成功会自动跳转到应用列表,可以看到已经有刚才创建的CCTV-7应用
(3)、创建版本
-》代码管理
-》跳转到代码管理
-》创建版本
到此,就成功创建域名URL为 http://cctv7.sinaapp.com/ 的应用。
(4)、上传代码
将以下代码复制下来,另存为index.php。必须使用专业的开发编辑软件操作,例如Notepad++,不要使用Windows自带的记事本等。
-》编写index.php
<?php
/*
* 23工作室整理
* 感谢:方倍工作室 http://www.cnblogs.com/txw1958/提供;
* CopyRight All Rights Reserved
*/
// 令牌记号
define("TOKEN", "weixin");
// 微信对象
$wechatObj = new wechatCallback();
if (isset($_GET['echostr'])) {
// 验证有效
$wechatObj->valid();
}else{
// 信息响应
$wechatObj->responseMsg();
}
/*
* wechatCallback类
*/
class wechatCallback
{
// 验证有效
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;
}
}
// 响应信息
public function responseMsg()
{
// 获取原始参数
$postStr = $GLOBALS["HTTP_RAW_POST_DATA"];
if (!empty($postStr)){
$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA); // 获取xml对象;
$fromUsername = $postObj->FromUserName; // 发送方;
$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>";
// 针对"?"信息响应
if($keyword == "?" || $keyword == "?")
{
$msgType = "text"; // 消息类型,文本;
$contentStr = date("Y-m-d H:i:s",time()); // 响应的内容;
// 返回信息
$resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
echo $resultStr; // 响应;
}
}else{
echo "";
exit;
}
}
}
?>
-》压缩:将index.php文件压缩成ZIP格式,注意不能用RAR格式;
说明:这样会生成index.zip文件。或者直接下载方倍已压缩好的zip文件 点此下载;
-》上传:在代码管理界面选择操作按钮上传;说明,如果上传有问题,请在Chrome浏览器下重试一下。
-》代码编辑
说明,可看到index.php已经上传成功,双击可以查看编辑里面的代码;
第二章 启用开发模式
说明:微信公众平台地址:https://mp.weixin.qq.com;
(1)、关闭编辑模式
-》单击编辑模式进入;
滑动关闭
(2)、启用开发模式
-》进入开发模式里面
->单击成为开发者
-》填写URL和Token;
说明,此处URL为云应用的域名,而Token在index.php中定义为weixin。提交后提示你已成为开发者。
-》开启:再滑动右上角启用按钮。
恭喜,你成功启用开发模式。
至此,你的微信公众平台账号已经实现自动回复!
第四章 微信公众平台PHP SDK
方倍工作室开发微信公众平台的PHPSDK,集成目前所有消息及事件的接收及发送,代码如下:
<?php
/*
* 23工作室整理
* 感谢:方倍工作室 http://www.cnblogs.com/txw1958/提供技术支持;
* CopyRight All Rights Reserved
*/
// 令牌标识
define("TOKEN", "weixin");
// 微信对象
$wechatObj = new wechatCallback();
if (!isset($_GET['echostr'])) { // 判断是否有echostr随机数;
// 消息响应
$wechatObj->responseMsg();
}else{
// 验证身份
$wechatObj->valid();
}
/*
* wechatCallback类
*/
class wechatCallback
{
//验证消息
public function valid()
{
$echoStr = $_GET["echostr"];
if($this->checkSignature()){ // 检查验证微信加密签名;
echo $echoStr;
exit;
}
}
//检查签名
private function checkSignature()
{
$signature = $_GET["signature"]; // 原始signature签名;
$timestamp = $_GET["timestamp"]; // 时间戳;
$nonce = $_GET["nonce"]; // 随机数;
$token = TOKEN; // 令牌标识;
// 组装微信加密签名以供验证:数组-排序-连接-加密;
$tmpArr = array($token, $timestamp, $nonce);
sort($tmpArr, SORT_STRING);
$tmpStr = implode($tmpArr);
$tmpStr = sha1($tmpStr);
// 验证微信加密签名
if($tmpStr == $signature){
return true;
}else{
return false;
}
}
//响应消息
public function responseMsg()
{
// 获取原始数据
$postStr = $GLOBALS["HTTP_RAW_POST_DATA"];
if (!empty($postStr)){
$this->logger("R ".$postStr); // 日志输出;
$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA); // xml对象,注意,都是以xml文件格式传输数据;
$RX_TYPE = trim($postObj->MsgType); // 消息类型;
switch ($RX_TYPE)
{
case "event": // 事件
$result = $this->receiveEvent($postObj);
break;
case "text": // 文本
$result = $this->receiveText($postObj);
break;
case "image": // 图片
$result = $this->receiveImage($postObj);
break;
case "location": // 位置
$result = $this->receiveLocation($postObj);
break;
case "voice": // 语音
$result = $this->receiveVoice($postObj);
break;
case "video": // 视频
$result = $this->receiveVideo($postObj);
break;
case "link": // 链接
$result = $this->receiveLink($postObj);
break;
default:
$result = "unknown msg type: ".$RX_TYPE;
break;
}
$this->logger("T ".$result);
echo $result;
}else {
echo "";
exit;
}
}
// 接收事件消息
private function receiveEvent($object)
{
$content = "";
switch ($object->Event)
{
case "subscribe": // 关注
$content = "欢迎关注23工作室 ";
$content .= (!empty($object->EventKey))?("\n来自二维码场景 ".str_replace("qrscene_","",$object->EventKey)):"";
break;
case "unsubscribe": // 取消关注
$content = "取消关注";
break;
case "SCAN": // 扫描场景
$content = "扫描场景 ".$object->EventKey;
break;
case "CLICK": // 点击菜单
switch ($object->EventKey)
{
case "COMPANY":
$content = "23工作室提供互联网相关产品与服务。";
break;
default:
$content = "点击菜单:".$object->EventKey;
break;
}
break;
case "LOCATION": // 位置
$content = "上传位置:纬度 ".$object->Latitude.";经度 ".$object->Longitude;
break;
case "VIEW": // VIEW
$content = "跳转链接 ".$object->EventKey;
break;
default:
$content = "receive a new event: ".$object->Event;
break;
}
$result = $this->transmitText($object, $content); // 组装xml文件;
return $result;
}
//接收文本消息
private function receiveText($object)
{
switch ($object->Content)
{// 针对不同内容消息,响应不同;
case "文本":
$content = "这是个文本消息";
break;
case "图文":
case "单图文":
$content = array();
$content[] = array("Title"=>"单图文标题", "Description"=>"单图文内容", "PicUrl"=>"http://discuz.comli.com/weixin/weather/icon/cartoon.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
break;
case "多图文":
$content = array();
$content[] = array("Title"=>"多图文1标题", "Description"=>"", "PicUrl"=>"http://discuz.comli.com/weixin/weather/icon/cartoon.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
$content[] = array("Title"=>"多图文2标题", "Description"=>"", "PicUrl"=>"http://d.hiphotos.bdimg.com/wisegame/pic/item/f3529822720e0cf3ac9f1ada0846f21fbe09aaa3.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
$content[] = array("Title"=>"多图文3标题", "Description"=>"", "PicUrl"=>"http://g.hiphotos.bdimg.com/wisegame/pic/item/18cb0a46f21fbe090d338acc6a600c338644adfd.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
break;
case "音乐":
$content = array("Title"=>"最炫民族风", "Description"=>"歌手:凤凰传奇", "MusicUrl"=>"http://121.199.4.61/music/zxmzf.mp3", "HQMusicUrl"=>"http://121.199.4.61/music/zxmzf.mp3");
break;
default:
$content = date("Y-m-d H:i:s",time());
break;
}
if(is_array($content)){
if (isset($content[0]['PicUrl'])){
$result = $this->transmitNews($object, $content);
}else if (isset($content['MusicUrl'])){
$result = $this->transmitMusic($object, $content);
}
}else{
$result = $this->transmitText($object, $content);
}
return $result;
}
//接收图片消息
private function receiveImage($object)
{
$content = array("MediaId"=>$object->MediaId);
$result = $this->transmitImage($object, $content);
return $result;
}
//接收位置消息
private function receiveLocation($object)
{
$content = "你发送的是位置,纬度为:".$object->Location_X.";经度为:".$object->Location_Y.";缩放级别为:".$object->Scale.";位置为:".$object->Label;
$result = $this->transmitText($object, $content);
return $result;
}
//接收语音消息
private function receiveVoice($object)
{
if (isset($object->Recognition) && !empty($object->Recognition)){
$content = "你刚才说的是:".$object->Recognition;
$result = $this->transmitText($object, $content);
}else{
$content = array("MediaId"=>$object->MediaId);
$result = $this->transmitVoice($object, $content);
}
return $result;
}
//接收视频消息
private function receiveVideo($object)
{
$content = array("MediaId"=>$object->MediaId, "ThumbMediaId"=>$object->ThumbMediaId, "Title"=>"", "Description"=>"");
$result = $this->transmitVideo($object, $content);
return $result;
}
//接收链接消息
private function receiveLink($object)
{
$content = "你发送的是链接,标题为:".$object->Title.";内容为:".$object->Description.";链接地址为:".$object->Url;
$result = $this->transmitText($object, $content);
return $result;
}
//回复文本消息
private function transmitText($object, $content)
{
$textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[%s]]></Content>
</xml>";
$result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time(), $content);
return $result;
}
//回复图片消息
private function transmitImage($object, $imageArray)
{
$itemTpl = "<Image>
<MediaId><![CDATA[%s]]></MediaId>
</Image>";
$item_str = sprintf($itemTpl, $imageArray['MediaId']);
$textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
$item_str
</xml>";
$result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time());
return $result;
}
//回复语音消息
private function transmitVoice($object, $voiceArray)
{
$itemTpl = "<Voice>
<MediaId><![CDATA[%s]]></MediaId>
</Voice>";
$item_str = sprintf($itemTpl, $voiceArray['MediaId']);
$textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
$item_str
</xml>";
$result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time());
return $result;
}
//回复视频消息
private function transmitVideo($object, $videoArray)
{
$itemTpl = "<Video>
<MediaId><![CDATA[%s]]></MediaId>
<ThumbMediaId><![CDATA[%s]]></ThumbMediaId>
<Title><![CDATA[%s]]></Title>
<Description><![CDATA[%s]]></Description>
</Video>";
$item_str = sprintf($itemTpl, $videoArray['MediaId'], $videoArray['ThumbMediaId'], $videoArray['Title'], $videoArray['Description']);
$textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
$item_str
</xml>";
$result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time());
return $result;
}
//回复图文消息
private function transmitNews($object, $newsArray)
{
if(!is_array($newsArray)){
return;
}
$itemTpl = "<item>
<Title><![CDATA[%s]]></Title>
<Description><![CDATA[%s]]></Description>
<PicUrl><![CDATA[%s]]></PicUrl>
<Url><![CDATA[%s]]></Url>
</item>";
$item_str = "";
foreach ($newsArray as $item){
$item_str .= sprintf($itemTpl, $item['Title'], $item['Description'], $item['PicUrl'], $item['Url']);
}
$newsTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[news]]></MsgType>
<Content><![CDATA[]]></Content>
<ArticleCount>%s</ArticleCount>
<Articles>$item_str</Articles>
</xml>";
$result = sprintf($newsTpl, $object->FromUserName, $object->ToUserName, time(), count($newsArray));
return $result;
}
//回复音乐消息
private function transmitMusic($object, $musicArray)
{
$itemTpl = "<Music>
<Title><![CDATA[%s]]></Title>
<Description><![CDATA[%s]]></Description>
<MusicUrl><![CDATA[%s]]></MusicUrl>
<HQMusicUrl><![CDATA[%s]]></HQMusicUrl>
</Music>";
$item_str = sprintf($itemTpl, $musicArray['Title'], $musicArray['Description'], $musicArray['MusicUrl'], $musicArray['HQMusicUrl']);
$textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[music]]></MsgType>
$item_str
</xml>";
$result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time());
return $result;
}
//日志记录
private function logger($log_content)
{
if(isset($_SERVER['HTTP_APPNAME'])){ //SAE
sae_set_display_errors(false);
sae_debug($log_content);
sae_set_display_errors(true);
}else if($_SERVER['REMOTE_ADDR'] != "127.0.0.1"){ //LOCAL
$max_size = 10000;
$log_filename = "log.xml";
if(file_exists($log_filename) and (abs(filesize($log_filename)) > $max_size)){unlink($log_filename);}
file_put_contents($log_filename, date('H:i:s')." ".$log_content."\r\n", FILE_APPEND); // file_put_contents(),把字串写入文件;
}
}
}
?>
说明,将上述代码另存为index.php,压缩成index.zip,上传到SAE,你的公众账号就能接收及回复所有消息类型及事件通知。
第五章 微信公众平台开发模式原理分析
在体验上一节的各种功能之后,我们只是知其然,在这一节里,将在上面的基础上介绍微信公众平台收发消息机制及原理,这是知其所以然。
1、开发模式成为开发者时的消息校验原理
在开发者首次提交验证申请时,微信服务器将发送GET请求到填写的URL上,并且带上四个参数(signature、timestamp、nonce、echostr),开发者通过对签名(即signature)的效验,来判断此条消息的真实性。
此后,每次开发者接收用户消息的时候,微信也都会带上前面三个参数(signature、timestamp、nonce)访问开发者设置的URL,开发者依然通过对签名的效验判断此条消息的真实性。效验方式与首次提交验证申请一致。
参数 | 描述 |
signature | 微信加密签名,signature结合开发者填写的token参数和请求中的timestamp参数、nonce参数。 |
timestamp | 时间戳 |
nonce | 随机数 |
echostr | 随机字符串 |
开发者通过检验signature对请求进行校验(下面有校验方式)。若确认此次GET请求来自微信服务器,请原样返回echostr参数内容,则接入生效,成为开发者成功,否则接入失败。
加密/校验流程如下:
1. 排序:将token、timestamp、nonce三个参数进行字典序排序;
2. 拼接、加密:将三个参数字符串拼接成一个字符串进行sha1加密;
3. 签名对比:开发者获得加密后的字符串可与signature对比,标识该请求来源于微信
启用接口是由代码中的checkSignature()函数来实现校验的。如果对这一原理难以理解,可以暂时不用深究,继续看下面。
从上图可以看出,用户在发送一个?后,微信服务器将组装一个消息发送给我们自己的服务器,自己的服务器然后回复一个时间,并且将该时间也按一定的规则组装,回复给公众账号,公众账号再回复给用户,在这个收发过程中,发送方和接收方进行了调换(ToUserName和FromUserName值互换),收发都是以xml格式在后台进行传输的,所以掌握各种消息类型的收发就是进行微信公众平台开发的基础!
2、各种收发消息的XML数据包分析
文字后台格式:
<xml>
<ToUserName><![CDATA[gh_680bdefc8c5d]]></ToUserName>
<FromUserName><![CDATA[oIDrpjqASyTPnxRmpS9O_ruZGsfk]]></FromUserName>
<CreateTime>1359028446</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[测试文字]]></Content>
<MsgId>5836982729904121631</MsgId>
</xml>
表情后台格式
<xml>
<ToUserName><![CDATA[gh_680bdefc8c5d]]></ToUserName>
<FromUserName><![CDATA[oIDrpjqASyTPnxRmpS9O_ruZGsfk]]></FromUserName>
<CreateTime>1359044526</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[/::)/::~/::B/::|/:8-)]]></Content>
<MsgId>5837051792978241864</MsgId>
</xml>
XML格式讲解
ToUserName 消息接收方微信号(公众平台账号微信号);
FromUserName 消息发送方微信号;
CreateTime 消息创建时间;
MsgType 消息类型;文本消息为text;
Content 消息内容;
MsgId 消息ID号;
可以看出,文本和表情的消息类型均为文本;
后台格式:
<xml>
<ToUserName><![CDATA[gh_680bdefc8c5d]]></ToUserName>
<FromUserName><![CDATA[oIDrpjqASyTPnxRmpS9O_ruZGsfk]]></FromUserName>
<CreateTime>1359028479</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
<PicUrl><![CDATA[http://mmbiz.qpic.cn/mmbiz/L4qjYtOibummHn90t1mnaibYiaR8ljyicF3MW7XX3BLp1qZgUb7CtZ0DxqYFI4uAQH1FWs3hUicpibjF0pOqLEQyDMlg/0]]></PicUrl>
<MsgId>5836982871638042400</MsgId>
<MediaId><![CDATA[PGKsO3LAgbVTsFYO7FGu51KUYa07D0C_Nozz2fn1z6VYtHOsF59PTFl0vagGxkVH]]></MediaId>
</xml>
XML格式讲解
ToUserName 消息接收方微信号(公众平台账号微信号);
FromUserName 消息发送方微信号;
CreateTime 消息创建时间;
MsgType 消息类型;图片消息为image;
PicUrl 图片链接地址,可以用HTTP GET获取;
MsgId 消息ID号;
后台格式:
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<Format><![CDATA[Format]]></Format>
<MsgId>1234567890123456</MsgId>
</xml>
XML格式讲解;
ToUserName 消息接收方微信号(公众平台账号微信号);
FromUserName 消息发送方微信号;
CreateTime 消息创建时间;
MsgType 消息类型;语音消息为voice;
MediaId 媒体ID;
Format 语音格式,这里为amr;
MsgId 消息ID号;
附:AMR接口简介
全称AdaptiveMulti-Rate,主要用于移动设备的音频,压缩比比较大,但相对其他的压缩格式质量比较差,由于多用于人声,通话,效果还是很不错的。
后台格式:
<xml>
<ToUserName><![CDATA[gh_680bdefc8c5d]]></ToUserName>
<FromUserName><![CDATA[oIDrpjqASyTPnxRmpS9O_ruZGsfk]]></FromUserName>
<CreateTime>1359028186</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
<MediaId><![CDATA[DBVFRIj29LB2hxuYpc0R6VLyxwgyCHZPbRj_IIs6YaGhutyXUKtFSDcSCPeoqUYr]]></MediaId>
<ThumbMediaId><![CDATA[mxUJ5gcCeesJwx2T9qsk62YzIclCP_HnRdfTQcojlPeT2G9Q3d22UkSLyBFLZ01J]]></ThumbMediaId>
<MsgId>5836981613212624665</MsgId>
</xml>
XML格式讲解
ToUserName 消息接收方微信号(公众平台账号微信号);
FromUserName 消息发送方微信号;
CreateTime 消息创建时间;
MsgType 消息类型_视频消息为video类型;
MediaId 媒体ID;
ThumbMediaId 媒体缩略ID;
MsgId 消息ID号;
后台格式:
<xml>
<ToUserName><![CDATA[gh_680bdefc8c5d]]></ToUserName>
<FromUserName><![CDATA[oIDrpjqASyTPnxRmpS9O_ruZGsfk]]></FLACFromUserName>
<CreateTime>1359036619</CreateTime>
<MsgType><![CDATA[location]]></MsgType>
<Location_X>22.539968</Location_X>
<Location_Y>113.954980</Location_Y>
<Scale>16</Scale>
<Label><![CDATA[中国广东省深圳市南山区华侨城深南大道9789号邮政编码: 518057]]></Label>
<MsgId>5837017832671832047</MsgId>
</xml>
XML格式讲解
ToUserName 消息接收方微信号(公众平台账号微信号);
FromUserName 消息发送方微信号;
CreateTime 消息创建时间;
MsgType 消息类型,地理位置为location;
Location_X 地理位置纬度;
Location_Y 地理位置经度;
Scale 地图缩放大小;
Label 地理位置信息;
MsgId 消息ID号;
后台格式:
<xml>
<ToUserName><![CDATA[gh_680bdefc8c5d]]></ToUserName>
<FromUserName><![CDATA[oIDrpjl2LYdfTAM-oxDgB4XZcnc8]]></FromUserName>
<CreateTime>1359709372</CreateTime>
<MsgType><![CDATA[link]]></MsgType>
<Title><![CDATA[微信公众平台开发者的江湖]]></Title>
<Description><![CDATA[陈坤的微信公众号这段时间大火,大家..]]></Description>
<Url><![CDATA[http://israel.duapp.com/web/photo.php]]></Url>
<MsgId>5839907284805129867</MsgId>
</xml>
XML格式讲解
ToUserName 消息接收方微信号(公众平台账号微信号);
FromUserName 消息发送方微信号;
CreateTime 消息创建时间;
MsgType 消息类型,链接为link;
Title 图文消息标题;
Description 图文消息描述;
Url 点击图文消息跳转链接;
MsgId 消息ID号;
=》发送消息
说明,这里只介绍三种格式的消息:文本、图文、音乐。其中图文消息包括单条图文消息和多条图文消息,展示方式有一点点不同。
后台格式:
<xml>
<ToUserName><![CDATA[oIDrpjqASyTPnxRmpS9O_ruZGsfk]]></ToUserName>
<FromUserName><![CDATA[gh_680bdefc8c5d]]></FromUserName>
<CreateTime>1359036631</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[【深圳】天气实况 温度:27℃ 湿度:59% 风速:东北风3级
11月03日 周日 27℃~23℃ 小雨 东北风4-5级
11月04日 周一 26℃~21℃ 阵雨 微风
11月05日 周二 27℃~22℃ 阴 微风]]></Content>
<FuncFlag>0</FuncFlag>
</xml>
XML格式讲解
FromUserName 消息发送方;
ToUserName 消息接收方;
CreateTime 消息创建时间;
MsgType 消息类型,文本消息必须填写text;
Content 消息内容,大小限制在2048字节,字段为空为不合法请求;
FuncFlag 星标字段;后台格式:
<xml>
<ToUserName><![CDATA[oIDrpjqASyTPnxRmpS9O_ruZGsfk]]></ToUserName>
<FromUserName><![CDATA[gh_680bdefc8c5d]]></FromUserName>
<CreateTime>1359011899</CreateTime>
<MsgType><![CDATA[news]]></MsgType>
<Content><![CDATA[]]></Content>
<ArticleCount>1</ArticleCount>
<Articles>
<item>
<Title><![CDATA[[苹果产品信息查询]]></Title>
<Description><![CDATA[序列号:USE IMEI NUMBER
IMEI号:358031058974471
设备名称:iPhone 5C
设备颜色:
设备容量:
激活状态:已激活
电话支持:未过期[2014-01-13]
硬件保修:未过期[2014-10-14]
生产工厂:中国]]>
</Description> <PicUrl><![CDATA[http://www.doucube.com/weixin/weather/icon/banner.jpg]]></PicUrl>
<Url><![CDATA[]]></Url>
</item>
</Articles>
<FuncFlag>0</FuncFlag>
</xml>
后台数据格式
<xml>
<ToUserName><![CDATA[oIDrpjqASyTPnxRmpS9O_ruZGsfk]]></ToUserName>
<FromUserName><![CDATA[gh_680bdefc8c5d]]></FromUserName>
<CreateTime>1359011829</CreateTime>
<MsgType><![CDATA[news]]></MsgType>
<Content><![CDATA[]]></Content>
<ArticleCount>5</ArticleCount>
<Articles>
<item>
<Title><![CDATA[【深圳】天气实况 温度:3℃ 湿度:43﹪ 风速:西南风2级]]></Title>
<Description><![CDATA[]]></Description>
<PicUrl><![CDATA[http://www.doucube.com/weixin/weather/icon/banner.jpg]]></PicUrl>
<Url><![CDATA[]]></Url>
</item>
<item>
<Title><![CDATA[06月24日 周四 2℃~-7℃ 晴 北风3-4级转东南风小于3级]]></Title>
<Description><![CDATA[]]></Description>
<PicUrl><![CDATA[http://www.doucube.com/weixin/weather/icon/d00.gif]]></PicUrl>
<Url><![CDATA[]]></Url>
</item>
<item>
<Title><![CDATA[06月25日 周五 -1℃~-8℃ 晴 东南风小于3级转东北风3-4级]]></Title>
<Description><![CDATA[]]></Description>
<PicUrl><![CDATA[http://www.doucube.com/weixin/weather/icon/d00.gif]]></PicUrl>
<Url><![CDATA[]]></Url>
</item>
<item>
<Title><![CDATA[06月26日 周六 -1℃~-7℃ 多云 东北风3-4级转东南风小于3级]]></Title>
<Description><![CDATA[]]></Description>
<PicUrl><![CDATA[http://www.doucube.com/weixin/weather/icon/d01.gif]]></PicUrl>
<Url><![CDATA[]]></Url>
</item>
<item>
<Title><![CDATA[06月27日 周日 0℃~-6℃ 多云 东南风小于3级转东北风3-4级]]></Title>
<Description><![CDATA[]]></Description>
<PicUrl><![CDATA[http://www.doucube.com/weixin/weather/icon/d01.gif]]></PicUrl>
<Url><![CDATA[]]></Url>
</item>
</Articles>
<FuncFlag>0</FuncFlag>
</xml>
XML格式讲解
FromUserName 消息发送方;
ToUserName 消息接收方;
CreateTime 消息创建时间;
MsgType 消息类型,图文消息必须填写news;
Content 消息内容,图文消息可填空;
ArticleCount 图文消息个数,限制为10条以内;
Articles 多条图文消息信息,默认第一个item为大图;
Title 图文消息标题;
Description 图文消息描述;
PicUrl 图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80;
Url 点击图文消息跳转链接;
FuncFlag 星标字段;
后台格式:
<xml>
<ToUserName><![CDATA[ollB4jqgdO_cRnVXk_wRnSywgtQ8]]></ToUserName>
<FromUserName><![CDATA[gh_b629c48b653e]]></FromUserName>
<CreateTime>1372310544</CreateTime>
<MsgType><![CDATA[music]]></MsgType>
<Music>
<Title><![CDATA[最炫民族风]]></Title>
<Description><![CDATA[凤凰传奇]]></Description>
<MusicUrl><![CDATA[http://zj189.cn/zj/download/music/zxmzf.mp3]]></MusicUrl>
<HQMusicUrl><![CDATA[http://zj189.cn/zj/download/music/zxmzf.mp3]]></HQMusicUrl>
</Music>
<FuncFlag>0</FuncFlag>
</xml>
XML格式讲解
ToUserName 接收方帐号(收到的OpenID);
FromUserName 开发者微信号;
CreateTime 消息创建时间;
MsgType 消息类型,此处为music;
Title 音乐标题;
Description 音乐描述;
MusicUrl 音乐链接;
HQMusicUrl 高质量音乐链接,WIFI环境优先使用该链接播放音乐;
FuncFlag 位0x0001被标志时,星标刚收到的消息。
3、事件消息类型
目前用户在关注和取消关注,以及点击菜单的时候会自动向公众平台发送事件推送消息:
(1)、关注事件
<xml>
<ToUserName><![CDATA[gh_b629c48b653e]]></ToUserName>
<FromUserName><![CDATA[ollB4jv7LA3tydjviJp5V9qTU_kA]]></FromUserName>
<CreateTime>1372307736</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[subscribe]]></Event>
<EventKey><![CDATA[]]></EventKey>
</xml>
(2)、取消关注事件
<xml>
<ToUserName><![CDATA[gh_b629c48b653e]]></ToUserName>
<FromUserName><![CDATA[ollB4jqgdO_cRnVXk_wRnSywgtQ8]]></FromUserName>
<CreateTime>1372309890</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[unsubscribe]]></Event>
<EventKey><![CDATA[]]></EventKey>
</xml>
(3)、菜单点击事件
<xml>
<ToUserName><![CDATA[gh_680bdefc8c5d]]></ToUserName>
<FromUserName><![CDATA[oIDrpjqASyTPnxRmpS9O_ruZGsfk]]></FromUserName>
<CreateTime>1377886191</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[CLICK]]></Event>
<EventKey><![CDATA[天气深圳]]></EventKey>
</xml>
XML格式讲解
ToUserName 接收方微信号;
FromUserName 发送方微信号,若为普通用户,则是一个OpenID;
CreateTime 消息创建时间;
MsgType 消息类型,event类型;
Event 事件类型,subscribe(订阅)、unsubscribe(取消订阅)、CLICK(自定义菜单点击事件);
EventKey 事件KEY值,与自定义菜单接口中KEY值对应;
第六章 开发天气预报功能
这一章快速开发天气预报功能、我们使用方倍工作室的相应接口来实现,下面代码实现该功能:
<?php
/*
* 23工作室_第二十三小分队
* 感谢:方倍工作室提供技术支持;
* CopyRight 2014-05-30 All Rights Reserved
*/
// 签名
define("TOKEN", "weixin");
$wechatObj = new wechatCallback();
// isset()检测变量是否设置;
if (!isset($_GET['echostr'])) {
$wechatObj->responseMsg();
}else{
$wechatObj->valid();
}
/**
* wechatCallback类
*/
class wechatCallback
{
// 验证
public function valid()
{
$echoStr = $_GET["echostr"]; // 随机字符串;
if($this->checkSignature()){ // 验证签名;
echo $echoStr;
exit;
}
}
// 验证签名
private function checkSignature()
{
$signature = $_GET["signature"]; // 微信加密签名,由token、timestamp、nonce参数加密而成;
$timestamp = $_GET["timestamp"]; // 时间戳;
$nonce = $_GET["nonce"]; // 随机数;
$token = TOKEN; //签名;
// 加密签名
$tmpArr = array($token, $timestamp, $nonce);
sort($tmpArr, SORT_STRING); // sort(),把值作为字符串来处理来排序数组;
$tmpStr = implode($tmpArr); // implode(),把数组元素组合为一个字符串;
$tmpStr = sha1($tmpStr); // sha1(),计算字符串的 SHA-1 散列,使用美国 Secure Hash 算法 1,如果成功,则返回所计算的 SHA-1 散列,如果失败,则返回 false;
if($tmpStr == $signature){ // 加密签名对比;
return true;
}else{
return false;
}
}
// 响应信息
public function responseMsg()
{
$postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; // 包含有原始的 POST 数据;
if (!empty($postStr)){ // 字符串是否为空;
$this->logger("R ".$postStr);
// simplexml_load_string(),从 XML 字符串获取 SimpleXMLElement 对象;LIBXML_NOCDATA设置为把 CDATA 设置为文本节点;
$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
$RX_TYPE = trim($postObj->MsgType); // 消息类型;trim(),从字符串左侧删除空格或其他预定义字符;
switch ($RX_TYPE)
{
case "event": // 事件;
$result = $this->receiveEvent($postObj);
break;
case "text": // 文本;
$result = $this->receiveText($postObj);
break;
}
$this->logger("T ".$result);
echo $result;
}else {
echo "";
exit;
}
}
// 事件处理
private function receiveEvent($object)
{
$content = "";
switch ($object->Event)
{
case "subscribe":
$content = "欢迎关注23工作室 ";
break;
}
$result = $this->transmitText($object, $content); // 组装XML文件;
return $result;
}
// 文本处理
private function receiveText($object)
{
$keyword = trim($object->Content); // 信息内容;
$url = "http://apix.sinaapp.com/weather/?appkey=".$object->ToUserName."&city=".urlencode($keyword); // 文件地址;包含json数组;
$output = file_get_contents($url); // file_get_contents()函数把整个文件读入一个字符串中;
$content = json_decode($output, true); // json_decode(), 解析中文;第二个参数为true时,返回数组;
$result = $this->transmitNews($object, $content); // 组装文件;
return $result;
}
// 事件xml文件组装
private function transmitText($object, $content)
{
$textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[%s]]></Content>
</xml>";
// sprintf(),把格式化的字符串写入一个变量中;
$result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time(), $content);
return $result;
}
// 文本xml文件组件
private function transmitNews($object, $newsArray)
{
if(!is_array($newsArray)){ // is_array(), 判断是否为数组;
return;
}
$itemTpl = "<item>
<Title><![CDATA[%s]]></Title>
<Description><![CDATA[%s]]></Description>
<PicUrl><![CDATA[%s]]></PicUrl>
<Url><![CDATA[%s]]></Url>
</item>";
$item_str = "";
foreach ($newsArray as $item){
$item_str .= sprintf($itemTpl, $item['Title'], $item['Description'], $item['PicUrl'], $item['Url']);
}
$newsTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[news]]></MsgType>
<Content><![CDATA[]]></Content>
<ArticleCount>%s</ArticleCount>
<Articles>$item_str</Articles>
</xml>";
$result = sprintf($newsTpl, $object->FromUserName, $object->ToUserName, time(), count($newsArray));
return $result;
}
// 日志
private function logger($log_content)
{
}
}
/*
[{
"Title": "深圳天气预报",
"Description": "",
"PicUrl": "",
"Url": ""
}, {
"Title": "【实况】温度30℃ 湿度76%% 西南风2级 发布时间:17:30",
"Description": "",
"PicUrl": "",
"Url": ""
}, {
"Title": "【炎热】天气炎热,建议着短衫、短裙、短裤、薄型T恤衫等清凉夏季服装。",
"Description": "",
"PicUrl": "",
"Url": ""
}, {
"Title": "05月31日 周六 多云 27℃ 日出日落:05:38~19:03",
"Description": "",
"PicUrl": "http://discuz.comli.com/weixin/weather/icon/d01.jpg",
"Url": ""
}, {
"Title": "06月01日 周日 雷阵雨 27℃ 无持续风向 微风 日出日落:05:38~19:03",
"Description": "",
"PicUrl": "http://discuz.comli.com/weixin/weather/icon/d04.jpg",
"Url": ""
}, {
"Title": "06月02日 周一 阵雨 26℃ 无持续风向 微风 日出日落:05:38~19:04",
"Description": "",
"PicUrl": "http://discuz.comli.com/weixin/weather/icon/d03.jpg",
"Url": ""
}]
*/
?>
在公众账号中使用的命令如下:
在你的公众账号输入相应的命令,实现效果类似如下所示:
第七章 小结
你的收获:
(1)、得到免费云计算空间;
(2)、启用微信工作平台开发模式,能自动回复时间;
(3)、能快速体验各种消息接收及发送;
(4)、理解微信公众平台开发原理,熟悉各种消息及其发送;
书籍推荐:
<微信公众平台开发最佳实践>(方倍工作室编写,机械工业出版社出版)
包含很多php开发技巧、数据库使用、及近30项微信公众平台实用功能或技术;
开发指导[收费服务]
另外我们提供微信公众平台开发实战指导,内容包括:
1. 微信公众平台基础疑难解答;
2. 赠送微信公众平台开发实战教程电子版,高级接口教程电子版,赠送《微信公众平台开发最佳实践》;
3.微信公众平台开发技术咨询;
4. 所有问题在24小时内得到回复;
5.紧急技术问题的电话指导;
6. 提供天气、快递、点歌、翻译、人脸识别、四六级、星座、解梦、笑话、苹果产品查询等功能源码;7. 专属QQ群指导。欢迎加入。
服务购买地址 http://item.taobao.com/item.htm?id=37979420283