微信公众号开发总结

最近公司用到了微信公众平台，所以研究了一下微信公众号的开发技术，总体来说比较简单，结合现有的平台核技术，实现起来非常方便。

首先先来了解一下微信公众平台。

“微信，是一个生活方式” ，这是微信的自我评价，是不是觉得如果那天不在朋友圈里分享一下自己的最新状态，
并且收到几个赞和评价的话，会觉得空虚寂寞呢？它实实在在的改变了我们的生活方式。

“ 微信，也是一个生意方式 ”，在微信成为我们日常必备之app的同时，它同样具备巨大的的商业
或许不应该称为潜力，因为有很多人已经获利，名人们在微信上开设公众账户来吸金，商家来做推广，
服务行业借此拓展渠道，甚至微信已经支持支付了, 还有越来越的自媒体在微信平台涌现出来。
这篇文章就是介绍如何快速的成为公众平台开发者，由于个人只能申请订阅号，因此本文是以订阅号为例。
关于订阅号和服务号的区别，请参见 微信公众平台服务号、订阅号的相关说明。

从微信用户角度简单来说:

订阅号主要用于信息辐射，典型的如各家新闻媒体。
服务号主要由于自助服务，典型的如招商银行。

申请公众平台账户

到 微信公众平台填写注册信息

按照提示激活邮箱

上传个人照片，需要有清晰的身份证照片

选择公众账户的类型，对于个人账户只能选择订阅号

最后你会看到自己账户的所有信息，请上传账号的头像，否则无法完成开发者的申请

等待审核通过，这个过程大约需要2～3天，当你收到如下通知，那么恭喜你，你已经成功的申请到了微信公众账户了

关于微信公众帐号注册的步骤就不再多说了，可以找到大量的图文教程。

帐号注册成功之后，需要验证自己的服务器，如果你没有自己的服务器，那可以用新浪SAE或者百度BAE，本文采用的是新浪SAE平台来搭建服务器。

注册过程略，使用新浪SAE创建应用，可以选择应用开发框架，选项中有比较热门的开发框架，选择微信公众平台phpSDK，点击后跳转到介绍页面，点击安装框架，系统会生成一个搭建好的微信公众平台应用，为了方便开发，我们可以使用svn来管理此应用代码，关于svn搭建可参见sae代码部署手册。

使用新浪SAE是比较方便的，如果我们有自己的服务器，可以把代码clone到自己的服务器上，下面来看一下代码

首先定义一个Wechat的基类

  1 <?php
  2 /**
  3  * 微信公众平台 PHP SDK
  4  *
  5  * @author hanc <congcongsky2010@gmail.com>
  6  */
  7 
  8   /**
  9    * 微信公众平台处理类
 10    */
 11   class Wechat {
 12 
 13     /**
 14      * 调试模式，将错误通过文本消息回复显示
 15      *
 16      * @var boolean
 17      */
 18     private $debug;
 19 
 20     /**
 21      * 以数组的形式保存微信服务器每次发来的请求
 22      *
 23      * @var array
 24      */
 25     private $request;
 26 
 27     /**
 28      * 初始化，判断此次请求是否为验证请求，并以数组形式保存
 29      *
 30      * @param string $token 验证信息
 31      * @param boolean $debug 调试模式，默认为关闭
 32      */
 33     public function __construct($token, $debug = FALSE) {
 34       if ($this->isValid() && $this->validateSignature($token)) {
 35         exit($_GET[\'echostr\']);
 36       }
 37 
 38       $this->debug = $debug;
 39       set_error_handler(array(&$this, \'errorHandler\'));
 40       // 设置错误处理函数，将错误通过文本消息回复显示
 41 
 42       $xml = (array) simplexml_load_string($GLOBALS[\'HTTP_RAW_POST_DATA\'], \'SimpleXMLElement\', LIBXML_NOCDATA);
 43 
 44       $this->request = array_change_key_case($xml, CASE_LOWER);
 45       // 将数组键名转换为小写，提高健壮性，减少因大小写不同而出现的问题
 46     }
 47 
 48     /**
 49      * 判断此次请求是否为验证请求
 50      *
 51      * @return boolean
 52      */
 53     private function isValid() {
 54       return isset($_GET[\'echostr\']);
 55     }
 56 
 57     /**
 58      * 判断验证请求的签名信息是否正确
 59      *
 60      * @param  string $token 验证信息
 61      * @return boolean
 62      */
 63     private function validateSignature($token) {
 64       $signature = $_GET[\'signature\'];
 65       $timestamp = $_GET[\'timestamp\'];
 66       $nonce = $_GET[\'nonce\'];
 67 
 68       $signatureArray = array($token, $timestamp, $nonce);
 69       sort($signatureArray);
 70 
 71       return sha1(implode($signatureArray)) == $signature;
 72     }
 73 
 74     /**
 75      * 获取本次请求中的参数，不区分大小
 76      *
 77      * @param  string $param 参数名，默认为无参
 78      * @return mixed
 79      */
 80     protected function getRequest($param = FALSE) {
 81       if ($param === FALSE) {
 82         return $this->request;
 83       }
 84 
 85       $param = strtolower($param);
 86 
 87       if (isset($this->request[$param])) {
 88         return $this->request[$param];
 89       }
 90 
 91       return NULL;
 92     }
 93 
 94     /**
 95      * 用户关注时触发，用于子类重写
 96      *
 97      * @return void
 98      */
 99     protected function onSubscribe() {}
100 
101     /**
102      * 用户取消关注时触发，用于子类重写
103      *
104      * @return void
105      */
106     protected function onUnsubscribe() {}
107     
108     /**
109      * 用户自动上报地理位置触发，用于子类重写
110      *
111      * @return void
112      */
113     protected function onAutoloaction() {}
114       
115     /**
116      * 用户点击菜单时触发，用于子类重写
117      *
118      * @return void
119      */
120     protected function onClick() {}
121     
122     /**
123      * 用户点击跳转链接时触发，用于子类重写
124      *
125      * @return void
126      */
127     protected function onView() {}
128 
129     /**
130      * 收到文本消息时触发，用于子类重写
131      *
132      * @return void
133      */
134     protected function onText() {}
135 
136     /**
137      * 收到图片消息时触发，用于子类重写
138      *
139      * @return void
140      */
141     protected function onImage() {}
142 
143     /**
144      * 收到地理位置消息时触发，用于子类重写
145      *
146      * @return void
147      */
148     protected function onLocation() {}
149 
150     /**
151      * 收到链接消息时触发，用于子类重写
152      *
153      * @return void
154      */
155     protected function onLink() {}
156     /**
157      * 收到语音消息时触发，用于子类重写
158      *
159      * @return void
160      */
161     protected function onVoice() {}
162 
163     /**
164      * 收到未知类型消息时触发，用于子类重写
165      *
166      * @return void
167      */
168     protected function onUnknown() {}
169 
170     /**
171      * 回复文本消息
172      *
173      * @param  string  $content  消息内容
174      * @param  integer $funcFlag 默认为0，设为1时星标刚才收到的消息
175      * @return void
176      */
177     protected function responseText($content, $funcFlag = 0) {
178       exit(new TextResponse($this->getRequest(\'fromusername\'), $this->getRequest(\'tousername\'), $content, $funcFlag));
179     }
180 
181     /**
182      * 回复音乐消息
183      *
184      * @param  string  $title       音乐标题
185      * @param  string  $description 音乐描述
186      * @param  string  $musicUrl    音乐链接
187      * @param  string  $hqMusicUrl  高质量音乐链接，Wi-Fi 环境下优先使用
188      * @param  integer $funcFlag    默认为0，设为1时星标刚才收到的消息
189      * @return void
190      */
191     protected function responseMusic($title, $description, $musicUrl, $hqMusicUrl, $funcFlag = 0) {
192       exit(new MusicResponse($this->getRequest(\'fromusername\'), $this->getRequest(\'tousername\'), $title, $description, $musicUrl, $hqMusicUrl, $funcFlag));
193     }
194 
195     /**
196      * 回复图文消息
197      * @param  array   $items    由单条图文消息类型 NewsResponseItem() 组成的数组
198      * @param  integer $funcFlag 默认为0，设为1时星标刚才收到的消息
199      * @return void
200      */
201     protected function responseNews($items, $funcFlag = 0) {
202       exit(new NewsResponse($this->getRequest(\'fromusername\'), $this->getRequest(\'tousername\'), $items, $funcFlag));
203     }
204     /**
205      * 回复语音识别消息
206      * @param  array   $recognition  系统接收到语音后识别的字符串
207      * @param  integer $funcFlag     默认为0，设为1时星标刚才收到的消息
208      * @return void
209      */
210     protected function responseVoice($recognition, $funcFlag = 0) {
211       exit(new TextResponse($this->getRequest(\'fromusername\'), $this->getRequest(\'tousername\'), $recognition, $funcFlag));
212     }
213 
214     /**
215      * 分析消息类型，并分发给对应的函数
216      *
217      * @return void
218      */
219     public function run() {
220       switch ($this->getRequest(\'msgtype\')) {
221 
222         case \'event\':
223           switch ($this->getRequest(\'event\')) {
224 
225             case \'subscribe\':
226               $this->onSubscribe();
227               break;
228 
229             case \'unsubscribe\':
230               $this->onUnsubscribe();
231               break;
232               
233             case \'LOCATION\':
234               $this->onAutoloaction();
235               break;
236               
237             case \'CLICK\':
238               $this->onClick();
239               break;
240               
241             case \'VIEW\':
242               $this->onView();
243               break;
244 
245           }
246           break;
247 
248         case \'text\':
249           $this->onText();
250           break;
251 
252         case \'image\':
253           $this->onImage();
254           break;
255 
256         case \'location\':
257           $this->onLocation();
258           break;
259 
260         case \'link\':
261           $this->onLink();
262           break;
263 
264         case \'voice\':
265           $this->onVoice();
266           break;
267           
268         default:
269           $this->onUnknown();
270           break;
271 
272       }
273     }
274 
275     /**
276      * 自定义的错误处理函数，将 PHP 错误通过文本消息回复显示
277      * @param  int $level   错误代码
278      * @param  string $msg  错误内容
279      * @param  string $file 产生错误的文件
280      * @param  int $line    产生错误的行数
281      * @return void
282      */
283     protected function errorHandler($level, $msg, $file, $line) {
284       if ( ! $this->debug) {
285         return;
286       }
287 
288       $error_type = array(
289         // E_ERROR             => \'Error\',
290         E_WARNING           => \'Warning\',
291         // E_PARSE             => \'Parse Error\',
292         E_NOTICE            => \'Notice\',
293         // E_CORE_ERROR        => \'Core Error\',
294         // E_CORE_WARNING      => \'Core Warning\',
295         // E_COMPILE_ERROR     => \'Compile Error\',
296         // E_COMPILE_WARNING   => \'Compile Warning\',
297         E_USER_ERROR        => \'User Error\',
298         E_USER_WARNING      => \'User Warning\',
299         E_USER_NOTICE       => \'User Notice\',
300         E_STRICT            => \'Strict\',
301         E_RECOVERABLE_ERROR => \'Recoverable Error\',
302         E_DEPRECATED        => \'Deprecated\',
303         E_USER_DEPRECATED   => \'User Deprecated\',
304       );
305 
306       $template = <<<ERR
307 PHP 报错啦！
308 
309 %s: %s
310 File: %s
311 Line: %s
312 ERR;
313 
314       $this->responseText(sprintf($template,
315         $error_type[$level],
316         $msg,
317         $file,
318         $line
319       ));
320     }
321 
322   }
323 
324   /**
325    * 用于回复的基本消息类型
326    */
327   abstract class WechatResponse {
328 
329     protected $toUserName;
330     protected $fromUserName;
331     protected $funcFlag;
332 
333     public function __construct($toUserName, $fromUserName, $funcFlag) {
334       $this->toUserName = $toUserName;
335       $this->fromUserName = $fromUserName;
336       $this->funcFlag = $funcFlag;
337     }
338 
339     abstract public function __toString();
340 
341   }
342 
343 
344   /**
345    * 用于回复的文本消息类型
346    */
347   class TextResponse extends WechatResponse {
348 
349     protected $content;
350 
351     protected $template = <<<XML
352 <xml>
353   <ToUserName><![CDATA[%s]]></ToUserName>
354   <FromUserName><![CDATA[%s]]></FromUserName>
355   <CreateTime>%s</CreateTime>
356   <MsgType><![CDATA[text]]></MsgType>
357   <Content><![CDATA[%s]]></Content>
358   <FuncFlag>%s<FuncFlag>
359 </xml>
360 XML;
361 
362     public function __construct($toUserName, $fromUserName, $content, $funcFlag = 0) {
363       parent::__construct($toUserName, $fromUserName, $funcFlag);
364       $this->content = $content;
365     }
366 
367     public function __toString() {
368       return sprintf($this->template,
369         $this->toUserName,
370         $this->fromUserName,
371         time(),
372         $this->content,
373         $this->funcFlag
374       );
375     }
376 
377   }
378 
379   /**
380    * 用于回复的音乐消息类型
381    */
382   class MusicResponse extends WechatResponse {
383 
384     protected $title;
385     protected $description;
386     protected $musicUrl;
387     protected $hqMusicUrl;
388 
389     protected $template = <<<XML
390 <xml>
391   <ToUserName><![CDATA[%s]]></ToUserName>
392   <FromUserName><![CDATA[%s]]></FromUserName>
393   <CreateTime>%s</CreateTime>
394   <MsgType><![CDATA[music]]></MsgType>
395   <Music>
396     <Title><![CDATA[%s]]></Title>
397     <Description><![CDATA[%s]]></Description>
398     <MusicUrl><![CDATA[%s]]></MusicUrl>
399     <HQMusicUrl><![CDATA[%s]]></HQMusicUrl>
400   </Music>
401   <FuncFlag>%s<FuncFlag>
402 </xml>
403 XML;
404 
405     public function __construct($toUserName, $fromUserName, $title, $description, $musicUrl, $hqMusicUrl, $funcFlag) {
406       parent::__construct($toUserName, $fromUserName, $funcFlag);
407       $this->title = $title;
408       $this->description = $description;
409       $this->musicUrl = $musicUrl;
410       $this->hqMusicUrl = $hqMusicUrl;
411     }
412 
413     public function __toString() {
414       return sprintf($this->template,
415         $this->toUserName,
416         $this->fromUserName,
417         time(),
418         $this->title,
419         $this->description,
420         $this->musicUrl,
421         $this->hqMusicUrl,
422         $this->funcFlag
423       );
424     }
425 
426   }
427 
428 
429   /**
430    * 用于回复的图文消息类型
431    */
432   class NewsResponse extends WechatResponse {
433 
434     protected $items = array();
435 
436     protected $template = <<<XML
437 <xml>
438   <ToUserName><![CDATA[%s]]></ToUserName>
439   <FromUserName><![CDATA[%s]]></FromUserName>
440   <CreateTime>%s</CreateTime>
441   <MsgType><![CDATA[news]]></MsgType>
442   <ArticleCount>%s</ArticleCount>
443   <Articles>
444     %s
445   </Articles>
446   <FuncFlag>%s<FuncFlag>
447 </xml>\'
448 XML;
449 
450     public function __construct($toUserName, $fromUserName, $items, $funcFlag) {
451       parent::__construct($toUserName, $fromUserName, $funcFlag);
452       $this->items = $items;
453     }
454 
455     public function __toString() {
456       return sprintf($this->template,
457         $this->toUserName,
458         $this->fromUserName,
459         time(),
460         count($this->items),
461         implode($this->items),
462         $this->funcFlag
463       );
464     }
465 
466   }
467 
468 
469   /**
470    * 单条图文消息类型
471    */
472   class NewsResponseItem {
473 
474     protected $title;
475     protected $description;
476     protected $picUrl;
477     protected $url;
478 
479     protected $template = <<<XML
480 <item>
481   <Title><![CDATA[%s]]></Title>
482   <Description><![CDATA[%s]]></Description>
483   <PicUrl><![CDATA[%s]]></PicUrl>
484   <Url><![CDATA[%s]]></Url>
485 </item>
486 XML;
487 
488     public function __construct($title, $description, $picUrl, $url) {
489       $this->title = $title;
490       $this->description = $description;
491       $this->picUrl = $picUrl;
492       $this->url = $url;
493     }
494 
495     public function __toString() {
496       return sprintf($this->template,
497         $this->title,
498         $this->description,
499         $this->picUrl,
500         $this->url
501       );
502     }
503 
504   }

此基类我稍作了更改，包含了能实现的微信所有的接口，通过继承 `Wechat` 类进行扩展，例如通过重写 `onSubscribe()` 等方法响应关注等请求，下面是实现的示例代码：

  1 <?php
  2 /**
  3  * 微信公众平台 PHP SDK 示例文件
  4  *
  5  * @author hanc <congcongsky2010@gmail.com>
  6  */
  7 
  8   require(\'src/Wechat.php\');
  9 
 10   /**
 11    * 微信公众平台演示类
 12    */
 13   class MyWechat extends Wechat {
 14 
 15     /**
 16      * 用户关注时触发，回复「欢迎关注」
 17      *
 18      * @return void
 19      */
 20     protected function onSubscribe() {
 21       $this->responseText(\'欢迎关注韩聪的微信号\');
 22     }
 23 
 24     /**
 25      * 用户取消关注时触发
 26      *
 27      * @return void
 28      */
 29     protected function onUnsubscribe() {
 30       // 「悄悄的我走了，正如我悄悄的来；我挥一挥衣袖，不带走一片云彩。」
 31     }
 32 
 33     /**
 34      * 用户自动上报地理位置时触发
 35      *
 36      * @return void
 37      */
 38     protected function onAutoloaction() {
 39 
 40       $this->responseText(\'您的地理位置为：\' . $this->getRequest(\'Latitude\') . \',\' . $this->getRequest(\'Longitude\'));
 41     }
 42       
 43     /**
 44      * 用户点击菜单时触发
 45      *
 46      * @return void
 47      */
 48     protected function onClick() {
 49        $eventKey=$this->getRequest(\'EventKey\');
 50        switch($eventKey){
 51          case \'C001\':
 52            $this->responseText(\'我赢了\');
 53            break;
 54          case \'C002\':
 55            $this->responseText(\'我最近很好o(∩_∩)o \');
 56            break;
 57          case \'C003\':
 58            $this->responseText(\'谢谢(*^__^*) 嘻嘻\');
 59            break;
 60        }
 61     }
 62     
 63     /**
 64      * 收到文本消息时触发，回复收到的文本消息内容
 65      *
 66      * @return void
 67      */
 68     protected function onText() {
 69       $this->responseText(\'收到了文字消息：\' . $this->getRequest(\'content\'));
 70     }
 71 
 72     /**
 73      * 收到图片消息时触发，回复由收到的图片组成的图文消息
 74      *
 75      * @return void
 76      */
 77     protected function onImage() {
 78       $items = array(
 79         new NewsResponseItem(\'标题一\', \'描述一\', $this->getRequest(\'picurl\'), $this->getRequest(\'picurl\')),
 80         new NewsResponseItem(\'标题二\', \'描述二\', $this->getRequest(\'picurl\'), $this->getRequest(\'picurl\')),
 81       );
 82 
 83       $this->responseNews($items);
 84     }
 85 
 86     /**
 87      * 收到地理位置消息时触发，回复收到的地理位置
 88      *
 89      * @return void
 90      */
 91     protected function onLocation() {
 92         //$num = 1 / 0;
 93       // 故意触发错误，用于演示调试功能
 94 
 95       $this->responseText(\'收到了位置消息：\' . $this->getRequest(\'location_x\') . \',\' . $this->getRequest(\'location_y\'));
 96     }
 97 
 98     /**
 99      * 收到链接消息时触发，回复收到的链接地址
100      *
101      * @return void
102      */
103     protected function onLink() {
104       $this->responseText(\'收到了链接：\' . $this->getRequest(\'url\'));
105     }
106       
107      /**
108      * 收到语音消息时触发，回复收到的语音
109      *
110      * @return void
111      */
112     protected function onVoice() {
113       $this->responseVoice(\'收到了语音：\' . $this->getRequest(\'recognition\'));
114     }
115 
116     /**
117      * 收到未知类型消息时触发，回复收到的消息类型
118      *
119      * @return void
120      */
121     protected function onUnknown() {
122       $this->responseText(\'收到了未知类型消息：\' . $this->getRequest(\'msgtype\'));
123     }
124 
125   }
126 
127   $wechat = new MyWechat(\'hancong\', TRUE);
128   $wechat->run();

以上代码部分功能需要开通服务号并且申请认证，比如语音识别，地理信息，添加菜单的功能，申请认证需要300元/年，可以享受微信所有的接口功能。

注：如果验证服务器URL，需要修改一句代码

$wechat = new MyWechat(\'hancong\', TRUE);
//$wechat->run();
$wechat->validateSignature(\'hancong\');//参数为填写的token

验证完后回复调用run方法，validateSignature方法只是第一次验证服务器调用，验证完后即可删掉。

秒客网

微信公众号开发总结

申请公众平台账户

相关文章