微信公眾平台PHP開發版本例子

最近在做微信公眾平台開發，一口氣寫了二十幾個功能，挺有意思的～
 

 
今天來分享一下開發經驗~
微信公眾平台提供的介面很簡單，先看看訊息互動流程:
 

 
說的通俗一些，使用者使用微信發送訊息 -> 微信將資料發送給開發人員 -> 開發人員處理訊息並返回資料至微信 -> 微信把返回資料發送給使用者，期間資料互動通過XML完成，就這麼簡單。
 
下面寫個執行個體，開發微信智能聊天機器人:
 
1. 註冊微信公眾平台帳號

微信公眾平台:
https://mp.weixin.qq.com/

注: 目前一張身份證只能註冊兩個帳號，帳號名稱關乎加V認證，請謹慎註冊。
 
2. 申請伺服器/虛擬機器主機
沒有伺服器/虛擬機器主機的童鞋可以使用BAE和SAE，不多介紹。
 
3. 開啟開發人員模式
微信公眾平台有兩個模式，一個是編輯模式（傻瓜模式），簡單但功能單一。另一個是開發人員模式，可以通過開發實現複雜功能。兩個模式互斥，顯而易見，登入微信公眾平台並通過“進階功能”菜單開啟開發人員模式。
 
4. 填寫介面配置資訊
同樣是在“進階功能”菜單中配置，需要配置兩項參數:
URL: 開發人員應用訪問地址，目前僅支援80連接埠，以“http://www.YoonPer.com/weixin/index.php”為例。
TOKEN: 隨意填寫，用於產生簽名，以“YoonPer”為例。
填寫完把下面代碼儲存為index.php並上傳至http://www.YoonPer.com/weixin/目錄，最後點擊“提交”完成驗證

<?php
define("TOKEN", "YoonPer"); //TOKEN值
$wechatObj = new wechat();
$wechatObj->valid();
class wechat {
 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;
  }
 }
}
?>

這玩意兒就是微信公眾平台校正URL是否正確接入，研究代碼沒有實質性意義，驗證完即可刪除檔案，就不詳細說明了，有興趣的童鞋可以查看官方文檔。
微信公眾平台API文檔:
http://mp.weixin.qq.com/wiki/index.php

5. 開發微信公眾平台功能
OK，上面提到了，微信公眾平台與開發人員之間的資料互動是通過XML完成的，既然用到XML，當然得遵循規範，所以在著手開發之前先看看官方介面文檔提供的XML規範，以簡訊為例:
 
當使用者向微信公眾帳號發送訊息時，微信伺服器會POST給開發人員一些資料:
<xml>
<!--開發人員微訊號-->
<ToUserName><![CDATA[toUser]]></ToUserName>
<!--發送方帳號（OpenID）-->
<FromUserName><![CDATA[fromUser]]></FromUserName>
<!--訊息建立時間 （整型）-->
<CreateTime>12345678</CreateTime>
<!--訊息類別 （text簡訊）-->
<MsgType><![CDATA1]></MsgType>
<!--訊息內容-->
<Content><![CDATA[content]]></Content>
<!--訊息ID （64位整型）-->
<MsgId>1234567890123456</MsgId>
</xml>
 
開發人員在處理完訊息後需要返回資料給微信伺服器:
<xml>
<!--接收方帳號（OpenID）-->
<ToUserName><![CDATA[toUser]]></ToUserName>
<!--開發人員微訊號-->
<FromUserName><![CDATA[fromUser]]></FromUserName>
<!--訊息建立時間 （整型）-->
<CreateTime>12345678</CreateTime>
<!--訊息類別 （text簡訊）-->
<MsgType><![CDATA1]></MsgType>
<!--回複訊息內容-->
<Content><![CDATA[content]]></Content>
<!--星標操作（位0x0001被標誌時 星標剛收到的訊息）-->
<FuncFlag>0</FuncFlag>
</xml>
除簡訊外，微信公眾平台還支援使用者發送圖片訊息、地理位置訊息、連結訊息、事件推送，而開發人員還可以向微信公眾平台回複音樂訊息和圖文訊息，各類訊息XML規範也可以參見官方文檔。
 
來看看官方提供的一個PHP樣本，我做了一些精簡:
<?php
$wechatObj = new wechat();
$wechatObj->responseMsg();
class wechat {
 public function responseMsg() {

  //---------- 接 收 數 據 ---------- //

  $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; //擷取POST資料

  //用SimpleXML解析POST過來的XML資料
  $postObj = simplexml_load_string($postStr,'SimpleXMLElement',LIBXML_NOCDATA);

  $fromUsername = $postObj->FromUserName; //擷取發送方帳號（OpenID）
  $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>";

  $msgType = "text"; //訊息類型
  $contentStr = 'http://www.YoonPer.com'; //返回訊息內容

  //格式化訊息模板
  $resultStr = sprintf($textTpl,$fromUsername,$toUsername,
  $time,$msgType,$contentStr);
  echo $resultStr; //輸出結果
 }
}
?>
把代碼儲存為index.php並上傳至http://www.YoonPer.com/weixin/目錄，如果剛才沒刪除該檔案，則直接覆蓋。
 
現在使用者通過微信公眾平台發送任何訊息公眾帳號均會返回一條內容為“http://www.YoonPer.com”的訊息。
接下來需要做的就是根據使用者訊息動態返回結果~
 
SimSimi（小黃雞）是目前比較火的聊天機器人，我用CURL開發了一個免費的SimSimi（小黃雞）介面，傳入關鍵詞會返迴文本回複，這部分不是本文重點，就不多說明，直接上代碼(2014.07.28更新):
<?php
function simsimi ($keyword)
{
    $keyword = urlencode($keyword);
    //----------- 擷取COOKIE ----------//
    $url = "http://www.simsimi.com/";
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_HEADER, 1);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    $content = curl_exec($ch);
    list($header, $body) = explode("\r\n\r\n", $content);
    preg_match_all("/set\-cookie:([^\r\n]*);/iU", $header, $matches);
    $cookie = implode(';', $matches[1]).";simsimi_uid=1;";
    curl_close($ch);
    //----------- 抓 取 回 複 ----------//
    $url = "http://www.simsimi.com/func/reqN?lc=ch&ft=0.0&req=$keyword&fl=http%3A%2F%2Fwww.simsimi.com%2Ftalk.htm";
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_COOKIE, $cookie);
    $content = json_decode(curl_exec($ch), 1);
    curl_close($ch);
    if ( $content['result'] == '200' ) {
        return $content['sentence_resp'];
    } else {
        return '我還不會回答這個問題...';
    }
}
?>
把上面兩段代碼整合在一起就大功告成了，需要說明一點，微信伺服器在5秒內收不到響應會斷掉串連，通過此介面有可能會逾時，且SimSimi已經屏蔽了BAE和SAE上的抓取請求，推薦使用SimSimi官方收費API，速度比較快~