本博文就月初剛上線的微信服務號，圖文進行總結分享給大家。
去年年底，我所在的團隊討論要開發微信號，話題由此拉開：
原來有一個3年前注冊的微信號，但是后台操作無法從“訂閱號”變更為“服務號”，隨即找騰訊的客服溝通，客服還算是熱情，mm耐心的告之系統已經更新，對於無法升級的微信號，只能重新注冊----“*#*（*￥）￥K30#$e&#)”，一陣抓狂后，只能重新注冊了，下面就開始從注冊到內部需求討論，到開發的圖文總結。
Step1：微信注冊
在微信公眾號官網：https://mp.weixin.qq.com，點擊注冊
如上圖所示，微信號由郵箱注冊，每個郵箱僅能申請一種帳號：服務號、訂閱號或企業號。
- 基本信息
- 郵箱激活
- 選擇類型
- 信息登記
- 公眾號信息
這里按照說明輸入公司信息即可，本次我們選擇的是認證服務號的選項：
為了認證服務號，需要支付300元/年，這個步驟稍微麻煩一些：財務打款、等待7個工作日、郵遞發票等。
需要注意的是，微信的認證不是騰訊官方，是其委托方的第三方，這個剛開始的時候還比較差異。
在完成后的認證后，認證信息如下（略過中間掃描公司的營業執照、掃描蓋公章的認證協議等細節）：
認證后的微信(帶金色對鈎的是本次開發的微信)：
Step2：微信文檔&API學習
微信開發和學習使用ComponentOne控件一樣，需要做第一件事件是看微信官方的文檔、API、demo樣例代碼，這樣能極大減少走彎路的風險。
備注：原計划看幾本熱銷的微信開發書籍，后來因為時間原因放棄了。
登陸微信后台，點擊左側的“開發者中心”，右側出現的“開發者文檔”、“在線接口調試工具”即是微信官方提供的文檔和API利器，在開發過程中，會反復、多次使用，這2個是非常重要的資料。
在公眾號“開發者中心”中，把AppID和AppSecret記下來，后面會多次用到。
微信的官方文檔，首先從上往下通讀一遍：
在文檔的開始，微信官方就提供了PHP示例代碼，下載地址。 且其明確的告之，微信公眾號接口只支持80接口.
官方文檔寫的非常細，如獲取access token是基於HTTP請求，用的是GET方式，其他的文檔請直接參閱文檔：
access_token是公眾號的全局唯一票據，公眾號調用各接口時都需使用access_token。開發者需要進行妥善保存。access_token的存儲至少要保留512個字符空間。access_token的有效期目前為2個小時，需定時刷新，重復獲取將導致上次獲取的access_token失效。
http請求方式: GET
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
備注：access_token的有效時間是7200s，既需要自行做一個緩存，2小時刷新一次access_token; 我在這里用的是文件的緩存方式，添加了時間戳。
Step3：開發環境搭建
這節，我們着手搭建環境。
首先選擇http://git.oschina.net 搭建源碼托管環境，OSC提供了免費的私有項目，配合使用TortoiseGit-1.8.11.0-64bit，使得搭建源碼托管環境非常簡單。另外，其在國內訪問Git速度超快（贊一個！）
接着安裝軟件，配置電腦開發環境：
- Windows 8.1 64位 中文版
- JetBrains PhpStorm 8.0.2
- SQL Server 2008
- PHP 5
為了方便測試，和公司網管溝通，把微信的***.gcpowertools.com.cn/ 80端口映射到我的局域網電腦。事后證明，這種本地調試方法非常高效，極大了提高了開發、調試效率。最后，為了方便調試微信數據，需要寫log進行日志呈現，這里我使用的是讀寫文件的方式。
function writeLogBegin($msg = "begin log..............")
{
$logFile = date('Y-m-d') . '.txt';
$msg = date('Y-m-d H:i:s') . ' >>> ' . $msg . "\r\n";
file_put_contents("c:\\log.txt", $msg);
}
Step4：微信開發
首先，結合業務特點，規划微信底部的自定義菜單。
小技巧：自定義菜單不用寫代碼，用微信官方自帶的調試頁面即可完成。
規划好自定義菜單后，POST JSON到微信服務器，可直接使用微信公眾平台接口調試工具。
保存生成的access_token, 類似如下的文本：
vU2rq8nzdXZWmcS3jO1OAZzRL5dnm3OIlsPF8ZCKHkTGfrG8f87QpwYa4mBpkTvnuy0pQJsfyq_L5xLIqPSoIBIqdsVAaKOuEgBrPpQ4
接着選擇“自定義菜單”，輸入剛才保存的access_token，輸入如下的JSON字符串：
{
"button":[
{
"name":"學習中心",
"sub_button":[
{
"type":"click",
"name":"聯系葡萄城",
"key":"101"
}]},
{
"name":"我的服務",
"sub_button":[
{
"type": "view",
"name": "最新動態",
"url": "https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx9665cf3fcdaee2f1&redirect_uri=http://www.gcpowertools.com.cn&response_type=code&scope=snsapi_base&state=118#wechat_redirect"
},
{
"type": "view",
"name":"最新版本",
"url": "https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx9665cf3fcdaee2f1&redirect_uri=http://www.gcpowertools.com.cn&response_type=code&scope=snsapi_base&state=118#wechat_redirect"
},
{
"type":"click",
"name":"金牌服務查詢",
"key":"102"
},
{
"type":"click",
"name":"金牌服務條款",
"key":"103"
}]
},
{
"name":"GCDN社區",
"sub_button":[
{
"type":"click",
"name":"每日簽到",
"key":"104"
},
{
"type":"click",
"name":"信息查詢",
"key":"105"
},
{
"type":"click",
"name":"我的帖子",
"key":"106"
},
{
"type":"click",
"name":"熱門問答",
"key":"107"
},
{"type":"view",
"name":"禮品兌換",
"url":"https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx9665cf3fcdaee2f1&redirect_uri=http://www.gcpowertools.com.cn&response_type=code&scope=snsapi_base&state=118#wechat_redirect"
}]
}]
}
備注：創建自定義菜單后，由於微信客戶端緩存，需要24小時微信客戶端才會展現出來。建議測試時可以嘗試取消關注公眾賬號后再次關注，則可以看到創建后的效果。
接着，我們進行核心的功能開發。
微信服務號的核心圍繞GCDN社區，故“GCDN社區”子菜單有5個二級菜單，其中每日簽到、信息查詢、我的帖子、禮品兌換功能需要首先綁定自己的GCDN賬號GCDN賬號。
依據上面的邏輯，綁定GCDN賬號是前提環節，故需要開發綁定功能。 綁定功能，做了一個頁面，通過a標簽跳轉，用戶在輸入用戶名、密碼后進行GCDN鑒權驗證，驗證通過存儲在表：包含GCDN ID、微信的OpenID，既完成賬號綁定。
后面的多個功能，通過這個表，可從微信的OpenID獲得GCDN ID，繼而可以使用GCDN論壇中的個人信息。
每日簽到功能
打開論壇頁面，在底部可看到目前GCDN使用的引擎較早，是Discuz!NT 3.6.711版本，故X3.1版本中時尚的簽到功能是沒有的。針對這個遺憾，本次微信開發做了彌補：用戶可通過微信的簽到完成這個功能。
GCDN回帖微信通知
這是另外一個特色功能：無需操作，只需要綁定GCDN賬號，當你在GCDN的發帖有人回復時，會自動收到微信通知。
這個功能的開發，主要是為了還GCDNer的一個期待：在《2013年葡萄城控件用戶滿意度調查》，論壇用戶對此類功能呼聲很高，“謝謝你們的努力和盡職盡責，我希望GCDN回帖及時些，最好有及時的短信通知功能，省的我時不時的刷新GCDN頁面，催促你們！”--某GCDN用戶。
實現思路如下圖所示：
微信通知用戶，剛開始想的是文本通知，結果發現微信公眾號的政策：如果用戶未在24小時內主動和微信互動，則無法用文本通知用戶。想到另外一個變通的辦法，各大銀行的余額動態通知功能。接着仔細找微信提供的功能，原來這種功能是“微信模板消息”。
這段文檔關於微信的模板消息寫的很詳細：
為了保證用戶不受到騷擾，在開發者出現需要主動提醒、通知用戶時，才允許開發者在公眾平台網站中模板消息庫中選擇模板，選擇后獲得模板ID，再根據模板ID向用戶主動推送提醒、通知消息。
約花了半天時間，開發出的功能效果看起來還不錯(用戶是否在24小時內主動聯系，均可發送模板消息)，截圖如下：
如想配置這個功能，通過回復文字指令。
- 回復"取消提醒"： 自動關閉微信通知提醒
- 回復"開通提醒"：自動開通微信通知提醒（需要你綁定GCDN賬號）
上面的開發過程，用到的PHP的 curl 實現HTTP GET、POST請求的源碼：
/**
* @param $url
* @param null $data
* @return mixed
*/
function https_request($url, $data = null)
{
// 模擬提交數據函數
$curl = curl_init(); // 啟動一個CURL會話
curl_setopt($curl, CURLOPT_URL, $url); // 要訪問的地址
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0); // 對認證證書來源的檢查
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 1); // 從證書中檢查SSL加密算法是否存在
curl_setopt($curl, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']); // 模擬用戶使用的瀏覽器
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1); // 使用自動跳轉
curl_setopt($curl, CURLOPT_AUTOREFERER, 1); // 自動設置Referer
if (!empty($data)) {
curl_setopt($curl, CURLOPT_POST, 1); // 發送一個常規的Post請求
curl_setopt($curl, CURLOPT_POSTFIELDS, $data); // Post提交的數據包
}
curl_setopt($curl, CURLOPT_TIMEOUT, 30); // 設置超時限制防止死循環
curl_setopt($curl, CURLOPT_HEADER, 0); // 顯示返回的Header區域內容
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // 獲取的信息以文件流的形式返回
$tmpInfo = curl_exec($curl); // 執行操作
if (curl_errno($curl)) {
echo 'Errno' . curl_error($curl);//捕抓異常
}
curl_close($curl); // 關閉CURL會話
return $tmpInfo; // 返回數據
}
雷區：如果你所在電腦有代理，務必添加如下代碼：
//使用網絡代理begin
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE);
curl_setopt($curl, CURLOPT_PROXY, '192.168.0.1'); //替換代理地址
curl_setopt($curl, CURLOPT_PROXYPORT, '880'); //替換代理端口
curl_setopt($curl, CURLOPT_PROXYTYPE, 'HTTP');
curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'grapecity/r:r'); //替換代理用戶名
//使用網絡代理end
Step5：開發總結
- 近2個月的開發時間，投入了約1.5人，粗略估算有3個人月開發投入。
- 少數的幾次非控件業務的研發，主要為了方便GCDN社區用戶的使用，橋接微信、GCDN。
- 選擇使用PHP腳本語言不錯，微信官方用PHP作為默認微信開發腳本，另外PHP開發微信的博客非常多。
- 完整項目經驗很重要：“坑才是大愛！”
坑的定義：有時候沒有問題，有時候有問題。100%有問題的，不叫坑，叫bug。
- Git利器： 協作開發，牛！
- include_onece 路徑錯誤這個坑，PHPStorm提供了足夠的智能感知，要重視。
- include_onece 路徑用單引號，不要用雙引號
- 團隊協力：人心齊、泰山移。微信功能的迭代，是一點一點溝通出來的。
小伙伴們，有微信的不妨掃一掃，看看大家還有啥需求，我們接着開發、寫博客吧：
關注微信綁定GCDN賬號，有GCDN勛章喲！
相關閱讀：
微軟 Build 2017 開發者大會：Azure 與 AI 的快速發展