最近公司用到了微信公众平台,所以研究了一下微信公众号的开发技术,总体来说比较简单,结合现有的平台核技术,实现起来非常方便。
首先先来了解一下微信公众平台。
“微信,是一个生活方式” ,这是微信的自我评价,是不是觉得如果那天不在朋友圈里分享一下自己的最新状态,
并且收到几个赞和评价的话,会觉得空虚寂寞呢?它实实在在的改变了我们的生活方式。
“ 微信,也是一个生意方式 ”,在微信成为我们日常必备之app的同时,它同样具备巨大的的商业
或许不应该称为潜力,因为有很多人已经获利,名人们在微信上开设公众账户来吸金,商家来做推广,
服务行业借此拓展渠道,甚至微信已经支持支付了,
还有越来越的自媒体在微信平台涌现出来。
这篇文章就是介绍如何快速的成为公众平台开发者,由于个人只能申请订阅号,因此本文是以订阅号为例。
关于订阅号和服务号的区别,请参见 微信公众平台服务号、订阅号的相关说明。
从微信用户角度简单来说:
订阅号 主要用于信息辐射,典型的如各家 新闻媒体 。
服务号 主要由于自助服务,典型的如 招商银行 。
关于微信公众帐号注册的步骤就不再多说了,可以找到大量的图文教程。
帐号注册成功之后,需要验证自己的服务器,如果你没有自己的服务器,那可以用新浪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方法只是第一次验证服务器调用,验证完后即可删掉。
原文:http://www.cnblogs.com/hanc/p/3714186.html