数据载入中,请稍后......
 
展开
懒人码库客户端 点击或扫描下载
欢迎来到懒人码库!懒人码库QQ群:19651313
欢迎来到懒人码库!懒人码库QQ群:19651313  
当前位置:懒人码库 > 服务端脚本 > PHP

微信公众平台示例代码分析

2014-04-13 23:10 来源:www.lanrenmaku.com / 作者:懒人 已被阅读:次 分类:PHP 上一篇:PHP如何给数组中每个元素都加一个指定值? 下一篇:Swoole: PHP的异步、并行、分布式扩展

一、摘要

微信公众平台提供了一个简单的php示例代码,在做进一步开发之前,我们有必要将其详细了解一下。

二、获取代码

微信官网:http://mp.weixin.qq.com/mpres/htmledition/res/wx_sample.zip

三、分析代码

完整代码如下:

 

  1. <?php 
  2. /** 
  3.   * wechat php test 
  4.   */ 
  5.  
  6. //define your token 
  7. define("TOKEN""weixin"); 
  8. $wechatObj = new wechatCallbackapiTest(); 
  9. $wechatObj->valid(); 
  10.  
  11. class wechatCallbackapiTest 
  12.     public function valid() 
  13.     { 
  14.         $echoStr = $_GET["echostr"]; 
  15.  
  16.         //valid signature , option 
  17.         if($this->checkSignature()){ 
  18.             echo $echoStr
  19.             exit
  20.         } 
  21.     } 
  22.  
  23.     public function responseMsg() 
  24.     { 
  25.         //get post data, May be due to the different environments 
  26.         $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; 
  27.  
  28.         //extract post data 
  29.         if (!emptyempty($postStr)){ 
  30.                  
  31.                 $postObj = simplexml_load_string($postStr'SimpleXMLElement', LIBXML_NOCDATA); 
  32.                 $fromUsername = $postObj->FromUserName; 
  33.                 $toUsername = $postObj->ToUserName; 
  34.                 $keyword = trim($postObj->Content); 
  35.                 $time = time(); 
  36.                 $textTpl = "<xml> 
  37.                             <ToUserName><![CDATA[%s]]></ToUserName> 
  38.                             <FromUserName><![CDATA[%s]]></FromUserName> 
  39.                             <CreateTime>%s</CreateTime> 
  40.                             <MsgType><![CDATA[%s]]></MsgType> 
  41.                             <Content><![CDATA[%s]]></Content> 
  42.                             <FuncFlag>0</FuncFlag> 
  43.                             </xml>";              
  44.                 if(!emptyempty$keyword )) 
  45.                 { 
  46.                     $msgType = "text"
  47.                     $contentStr = "Welcome to wechat world!"
  48.                     $resultStr = sprintf($textTpl$fromUsername$toUsername$time$msgType$contentStr); 
  49.                     echo $resultStr
  50.                 }else
  51.                     echo "Input something..."
  52.                 } 
  53.  
  54.         }else { 
  55.             echo ""
  56.             exit
  57.         } 
  58.     } 
  59.          
  60.     private function checkSignature() 
  61.     { 
  62.         $signature = $_GET["signature"]; 
  63.         $timestamp = $_GET["timestamp"]; 
  64.         $nonce = $_GET["nonce"];     
  65.                  
  66.         $token = TOKEN; 
  67.         $tmpArr = array($token$timestamp$nonce); 
  68.         sort($tmpArr); 
  69.         $tmpStr = implode( $tmpArr ); 
  70.         $tmpStr = sha1( $tmpStr ); 
  71.          
  72.         if$tmpStr == $signature ){ 
  73.             return true; 
  74.         }else
  75.             return false; 
  76.         } 
  77.     } 
  78.  
  79. ?> 

3.1 整体分析

原始示例代码大致分为四个部分:

  • 定义TOKEN
  • 声明一个类 wechatCallbackapiTest
  • 创建类wechatCallbackapiTest 的一个实例对象 $wechatObj
  • 调用类的 valid() 方法。

3.2 详细分析

3.2.1 定义TOKEN

define("TOKEN", "weixin");

define 是用来给常量赋值的函数,这句话的意思是赋予“TOKEN”这个常量值为“weixin”。

TOKEN 是用来进行交互安全认证的,开发者可以随意定义,要和公众平台里设置的一样。

3.2.2 声明一个类

class wechatCallbackapiTest{

}

声明一个类 wechatCallbackapiTest,该类中包含有三个方法(函数)。

a. public function valid()

用于申请 成为开发者 时向微信发送验证信息。

b. public function responseMsg()

处理并回复用户发送过来的消息,也是用的最多的一个函数,几乎所有的功能都在这里实现。

 

  1. responseMsg 函数详解: 
  2.  
  3. $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; 
  4. 接收微信公众平台发送过来的用户消息,该消息数据结构为XML,不是php默认的识别数据类型,因此这里用了$GLOBALS['HTTP_RAW_POST_DATA']来接收,同时赋值给了$postStr 
  5.  
  6. if (!emptyempty($postStr)) 
  7. 判断$postStr是否为空,如果不为空(接收到了数据),就继续执行下面的语句;如果为空,则跳转到与之相对应的else语句。 
  8.  
  9. $postObj = simplexml_load_string($postStr'SimpleXMLElement', LIBXML_NOCDATA); 
  10. 使用simplexml_load_string() 函数将接收到的XML消息数据载入对象$postObj中。这个严谨的写法后面还得加个判断是否载入成功的条件语句,不过不写也没事。 
  11.  
  12. $fromUsername = $postObj->FromUserName; 
  13. 将对象$postObj中的发送消息用户的OPENID赋值给$fromUsername变量 
  14.  
  15. $toUsername = $postObj->ToUserName; 
  16. 将对象$postObj中的公众账号的ID赋值给$toUsername变量 
  17.  
  18. $keyword = trim($postObj->Content); 
  19. trim() 函数从字符串的两端删除空白字符和其他预定义字符,这里就可以得到用户输入的关键词 
  20.  
  21. $time = time(); 
  22. time() 函数返回当前时间的 Unix 时间戳,即自从 Unix 纪元(格林威治时间 1970 年 1 月 1 日 00:00:00)到当前时间的秒数。 
  23.  
  24. $textTpl = "<xml> 
  25.        <ToUserName><![CDATA[%s]]></ToUserName> 
  26.        <FromUserName><![CDATA[%s]]></FromUserName> 
  27.         <CreateTime>%s</CreateTime> 
  28.        <MsgType><![CDATA[%s]]></MsgType> 
  29.        <Content><![CDATA[%s]]></Content> 
  30.        <FuncFlag>0</FuncFlag> 
  31.        </xml>"; 
  32. 存放微信输出内容的模板 
  33.  
  34. if(!emptyempty$keyword )) 
  35. 判断$keyword是否为空,不为空则继续执行下面的语句;如果为空,则跳转到与之相对应的else语句,即 echo "Input something..."
  36.  
  37. $msgType = "text"
  38. 消息类型是文本类型 
  39.  
  40. $contentStr = "Welcome to wechat world!"
  41. 回复的消息内容 
  42.  
  43. $resultStr = sprintf($textTpl$fromUsername$toUsername$time$msgType$contentStr); 
  44. 使用sprintf() 函数将格式化的数据写入到变量中去; 
  45. $fromUsername$toUsername$time$msgType$contentStr 分别顺序替换模板里“%s”位置,也即是“$resultStr”这个变量最后实际为: 
  46. <xml> 
  47.                             <ToUserName><![CDATA[$toUsername]]></ToUserName> 
  48.                             <FromUserName><![CDATA[$fromUsername]]></FromUserName> 
  49.                             <CreateTime>$time</CreateTime> 
  50.                             <MsgType><![CDATA[$msgType]]></MsgType> 
  51.                             <Content><![CDATA[$contentStr]]></Content> 
  52.                             <FuncFlag>0</FuncFlag>      //位0x0001被标志时,星标刚收到的消息。 
  53.                             </xml>。 

四、总结

以上是对微信官方示例代码的一个分析,有解释不对的地方,还请高手指出。另外,该代码只是官方给出的简单示例代码,如果要做复杂的开发,还是要求开发者按照严谨的开发模式改写该段代码,会在后续教程中娓娓道来。

五、参考

微信官方公众平台API文档:http://mp.weixin.qq.com/wiki/index.php

小贴士:懒人码库 为网页前端人员提供建站常用的广告代码和网页特效,内容涵盖焦点图,导航菜单,jQuery代码,图片特效,对联广告,日历控件,在线客服等。