##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>
```
- 欢迎使用PhalApi!
- 接口,从简单开始!
- [1.1]-下载与安装
- [1.2]-创建一个自己的项目
- [1.3]-在线体验
- [1.4]-文档、帮助和官网
- [1.10]-对PhalApi框架的抉择
- [1.11]-快速入门(backup)
- [1.12]-参数规则:接口参数规则配置
- [1.13]-统一的接口请求方式:_sevice=XXX.XXX
- [1.14]-统一的返回格式和结构:ret-data-msg
- [1.15]-数据库操作:基于NotORM的使用及优化
- [1.16]-配置读取:内外网环境配置的完美切换
- [1.17]-日记纪录:简化版的日记接口
- [1.18]-快速函数:人性化的关怀
- [1.19]-DI服务速查:各资源服务一览表
- [1.20]-DB操作:数据库基本操作速查
- [1.21]-类的自动加载:遵循PEAR包的命名规范
- [1.22]-签名验证:自定义签名规则
- [1.23]-请求和响应:GET和POST两者皆可得及超越JSON格式返回
- [1.24]-缓存策略:更灵活地可配置化的多级缓存
- [1.25]-国际化翻译:为走向国际化提前做好翻译准备
- [1.26]-数据安全:数据对称加密方案
- [1.27]-精益开发:更富表现力的Model层和重量级数据获取的应对方案
- [1.28]-COOKIE:对COOKIE原生态的支持及记忆加密升级版
- [1.29]-开放与封闭:多入口和统一初始化
- [1.30]-保持的力量:接口开发最佳实践
- [1.31]-新型计划任务:以接口形式实现的计划任务
- [2.11]-核心思想:DI依赖注入-让资源更可控
- [2.12]-海量数据:可配置的分库分表
- [2.13]-接口调试:在线SQL语句查看与性能优化
- [2.14]-测试驱动开发:意图导向编程下的接口开发
- [2.15]-演进:新型计划任务续篇
- [2.16]-领域驱动设计:应对复杂领域业务的Domain层
- [2.17]-微服务:Api接口服务层
- [2.18]-定制化:资源服务的再实现
- [2.19]-扩展库:可重用的扩展类库
- [2.20]-约定编程:架构明显的编程风格
- [2.21]-服务器统一部署方案简明版:CentOs---Nginx---php-fpm---MySql-[--Memcached]
- [2.22]-更多工具:精益项目和团队建设
- [3.1]-扩展类库:微信开发
- [3.2]-扩展类库:代理模式下phprpc协议的轻松支持
- [3.3]-扩展类库:基于PHPMailer的邮件发送
- [3.4]-扩展类库:优酷开放平台接口调用
- [3.5]-扩展类库:七牛云存储接口调用
- [3.6]-扩展类库:新型计划任务
- [3.8]-扩展类库:用户、会话和第三方登录集成
- [3.9]-扩展类库:swoole支持下的长链接和异步任务实现
- [3.11]-扩展类库:基于FastRoute的快速路由
- [4.2]-开发实战2:模拟优酷开放平台接口项目开发
- [4.3]-开发实战3:一个简单的小型项目开发(奔跑吧兄弟投票活动)
- [5.1]-架构与思想:PhalApi核心设计和思想解读
- [5.2]-杂谈:扯一些PhalApi的前世和今生
- [5.3]-框架总结:术语表和PHP开发建议
- [5.4]-许可
- [5.5]-联系和加入我们
- [5.6]-更新日记
- [5.8]-致框架贡献者:加入PhalApi开源指南
- [6.1]-基于接口查询语言的SDK包
- [6.2]-SDK包(JAVA版)
- [6.3]-SDK包(PHP版)
- [6.4]-SDK包(Objective-C版)
- [6.5]-SDK包(javascript版)
- [6.6]-SDK包(Ruby版)
- [8.1]-PhalApi视频教程
- 附录1:接口文档参考模板