一、简介
当普通微信用户向公众账号发消息时，微信服务器将用户发送的消息封装成XML数据包，通过POST消息发送到开发者的URL上。
微信服务器在五秒内收不到服务器的响应会断掉连接，并且重新发起请求，总共重试三次。关于重试的消息排重，推荐使用msgid排重。
假如服务器无法保证在五秒内处理并回复，可以直接回复空串，微信服务器不会对此作任何处理，并且不会发起重试。
当前支持如下的普通消息：
- 1 文本消息
- 2 图片消息
- 3 语音消息
- 4 视频消息
- 5 地理位置消息
- 6 链接消息
二、适用场景
普通微信用户通过微信给公众账号转发其他链接消息时，微信服务器就会将此消息的参数封装为链接消息发送到开发者URL。服务器接收到此消息后，可以解析出此消息的：标题，描述和链接URL。通过URL，可以获取用户转发来的网页信息。
三、消息格式说明
1 <xml> 2 <ToUserName><![CDATA[toUser]]></ToUserName> 3 <FromUserName><![CDATA[fromUser]]></FromUserName> 4 <CreateTime>1351776360</CreateTime> 5 <MsgType><![CDATA[link]]></MsgType> 6 <Title><![CDATA[公众平台官网链接]]></Title> 7 <Description><![CDATA[公众平台官网链接]]></Description> 8 <Url><![CDATA[url]]></Url> 9 <MsgId>1234567890123456</MsgId> 10 </xml>
| 参数 | 描述 |
|---|---|
| ToUserName | 接收方微信号 |
| FromUserName | 发送方微信号，若为普通用户，则是一个OpenID |
| CreateTime | 消息创建时间 |
| MsgType | 消息类型，link |
| Title | 消息标题 |
| Description | 消息描述 |
| Url | 消息链接 |
| MsgId | 消息id，64位整型 |
四、代码示例
1 <?php 2 /** 3 * wechat php test 4 */ 5 6 //define your token 7 define("TOKEN", "weixin"); 8 $wechatObj = new wechatCallbackapiTest(); 9 $wechatObj->responseMsg(); 10 11 class wechatCallbackapiTest 12 { 13 public function responseMsg() 14 { 15 //get post data, May be due to the different environments 16 $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; 17 18 if (!empty($postStr)){ 19 $postObj = simplexml_load_string($postStr, ‘SimpleXMLElement‘, LIBXML_NOCDATA); 20 $MSG_TYPE = trim($postObj->MsgType); 21 22 switch ($MSG_TYPE) { 23 case "text": 24 $resultStr = $this->handleText($postObj); 25 break; 26 case "image": 27 $resultStr = $this->handleImage($postObj); 28 break; 29 case "voice": 30 $resultStr = $this->handleVoice($postObj); 31 break; 32 case "video": 33 $resultStr = $this->handleVideo($postObj); 34 break; 35 case "location": 36 $resultStr = $this->handleLocation($postObj); 37 break; 38 case "link": 39 $resultStr = $this->handleLink($postObj); 40 break; 41 default: 42 $resultStr = "Unknow message type: " . $MSG_TYPE; 43 break; 44 } 45 //echo $postStr; 46 echo $resultStr; 47 }else { 48 echo ""; 49 exit; 50 } 51 } 52 53 private function handleLink($postObj) 54 { 55 //标题 56 $title = trim($postObj->Title); 57 //消息描述 58 $description = trim($postObj->Description); 59 //链接地址 60 $url = trim($postObj->Url); 61 62 if(!empty($url)){ 63 $contentStr = "Title : " . $title ."\n" 64 . "Description : " . $description . "\n" 65 . "URL : " . $url . "\n" ; 66 $resultStr = $this->responseText($postObj, $contentStr); 67 }else{ 68 $resultStr = "URL is empty."; 69 } 70 71 return $resultStr; 72 } 73 74 private function responseText($object, $content, $flag=0) 75 { 76 $textTpl = "<xml> 77 <ToUserName><![CDATA[%s]]></ToUserName> 78 <FromUserName><![CDATA[%s]]></FromUserName> 79 <CreateTime>%s</CreateTime> 80 <MsgType><![CDATA[text]]></MsgType> 81 <Content><![CDATA[%s]]></Content>