[3.1]-擴展類庫：微信開發 · PhalApi 接口開發文檔

##3.1.1 擴展類庫：微信開發此擴展可用于微信的服務號、訂閱號、企業號等功能開發，在PhalApi框架下簡單配置即可開發使用。 ##3.1.2 安裝和配置 ###(1)擴展包下載從 [PhalApi-Library](http://git.oschina.net/dogstar/PhalApi-Library) 擴展庫中下載獲取 **Wechat** 微信包，如使用： ```javascript git clone https://git.oschina.net/dogstar/PhalApi-Library.git ``` 然后把 **Wechat** 目錄復制到 **./PhalApi/Library/** 下，即： ```javascript cp ./PhalApi-Library/Wechat/ ./PhalApi/Library/ -R ``` 到此安裝完畢！接下是插件的配置。 ###(2)擴展包配置為了讓微信擴展包能接收來自微信服務器的信息以及返回信息給用戶，我們需要在 **./Config/app.php** 配置文件中追加以下配置： ```javascript /** * 插件注冊 - 項目級重用 */ 'Wechat' => array( 'plugins' => array( Wechat_InMessage::MSG_TYPE_TEXT => array('Plugin_Menu',), Wechat_InMessage::MSG_TYPE_IMAGE => array(), Wechat_InMessage::MSG_TYPE_VOICE => array(), Wechat_InMessage::MSG_TYPE_VIDEO => array(), Wechat_InMessage::MSG_TYPE_LOCATION => array(), Wechat_InMessage::MSG_TYPE_LINK => array(), Wechat_InMessage::MSG_TYPE_EVENT => array(), Wechat_InMessage::MSG_TYPE_DEVICE_EVENT => array(), Wechat_InMessage::MSG_TYPE_DEVICE_TEXT => array(), ), ) ``` 簡單說明一下上面配置的作用，很明顯，Key為對應的消息類型，如：文本、位置、語音、圖片等；然后是各種消息類型對應的處理的類名，可以有多個，從上到下依次處理。如果覺得配置很多，可以只配置需要用到的消息類型。另外，如果你的配置是其他途徑存放的，也亦然。 ##3.1.3 入門使用 ###(1)微信入口文件可以按將下面的入口代碼得到你的項目下： ```javascript //$ vim ./Public/weixin/index.php <?php // echo $_GET['echostr']; // die(); if (!isset($GLOBALS['HTTP_RAW_POST_DATA'])) { die('Access denied!'); } require_once dirname(__FILE__) . '/../init.php'; //裝載項目代碼和擴展類庫 DI()->loader->addDirs(array('Demo', 'Library')); /** ---------------- 微信輕聊版 ---------------- **/ $robot = new Wechat_Lite('YourTokenHere...', true); $rs = $robot->response(); $rs->output(); ``` **特別地** ，當首次接入微信時，需要將開頭的兩句注釋去掉，以便通過微信的驗證，即： ```javascript // echo $_GET['echostr']; // die(); ``` ##3.1.4 示例：讓紅包飛 ###(1)業務場景現在，快要過年了，各大企業都在派紅包，這里，我們也模擬一下微信服務號上紅包的派發。通常地，當我們需要添加一個新的微信服務號的功能時，可以兩步走： **先開發插件，再注冊插件** 。 ###(2)開發插件很簡單地： ```javascript // $vim ./Demo/Plugin/Money.php <?php class Plugin_Money implements Wechat_Plugin_Text { public function handleText($inMessage, &$outMessage) { $outMessage = new Wechat_OutMessage_News(); $item = new Wechat_OutMessage_News_Item(); $item->setTitle('讓紅包飛~') ->setDescription(sprintf('您已領取到一個%d元紅包~', rand(1, 100))) ->setPicUrl('http://webtools.qiniudn.com/172906_61c8663a_121026.jpeg') ->setUrl('http://git.oschina.net/dogstar/PhalApi-Library'); $outMessage->addItem($item); } } ```` 運行效果： ![webwxgetmsgimg](http://webtools.qiniudn.com/20150411005257_976929b37873ae51ca54d5cb24a61ff0) ##3.1.5 微信開發調試為了便于進行微信開發的調試，我們專門提供了一個快速模擬微信請求的腳本。以下是對上面發紅包的模擬請求： ```javascript $php ./Library/Wechat/Tests/send_wechat_text.php http://dev.wechat.com/weixin/ demo <xml> <ToUserName><![CDATA[oWNXvjipYqRViMpO8GZwXxE43pUY]]></ToUserName> <FromUserName><![CDATA[gh_43235ff1360f]]></FromUserName> <CreateTime>1423821388</CreateTime> <MsgType><![CDATA[news]]></MsgType> <ArticleCount>1</ArticleCount> <Articles> <item> <Title><![CDATA[讓紅包飛~]]></Title> <Description><![CDATA[您已領取到一個85元紅包~]]></Description> <PicUrl><![CDATA[http://webtools.qiniudn.com/172906_61c8663a_121026.jpeg]]></PicUrl> <Url><![CDATA[http://git.oschina.net/dogstar/PhalApi-Library]]></Url> </item> </Articles> <FuncFlag>0</FuncFlag> </xml> ```