**下载并载入SDK到项目中**
--
**方法`A`** 使用 [Composer](https://getcomposer.org) 下载安装，`SDK`符合`PSR`标准**（推荐）**。
---
>1. 用`composer`来下载安装`SDK`，需要确定框架会不会自动加载`vendor/autoload.php`文件
>2. 如果框架不能自动`vendor/autoload.php`，那么可以在项目中手动加载`vendor/autoload.php`文件
```
// 使用命名行下载SDK文件
composer require zoujingli/wechat-php-sdk
//在项目合适的地方向SDK注入配置参数（字段见下面）
\Wechat\Loader::config($options);
// 实例SDK相关的操作对象
$pay = new \Wechat\WechatPay();
```
**方法`B`** 普通文件加载（需要独立加载`\Wechat\Loader.php`文件）
---
>1. 首先通过 [Github](https://github.com/zoujingli/wechat-php-sdk) 或 [OSChina](http://git.oschina.net/zoujingli/wechat-php-sdk) 下载最新的微信SDK源代码
>2. 在项目中引入`include.php`是一个自动注册类加载的文件，功能与 [Composer](https://getcomposer.org) 类似。
```
// 引入SDK加载注册文件
include "zoujingli/wechat-php-sdk/include.php"
//在项目合适的地方向SDK注入配置参数（字段见下面）
\Wechat\Loader::config($options);
// 实例SDK相关的操作对象
$pay = new \Wechat\WechatPay();
...
```
**微信SDK所需要的参数**
--
使用前，需要准备好SDK的配置参数
---
```
$options = array(
'token' => '', // 填写你设定的key
'appid' => '', // 填写高级调用功能的app id, 请在微信开发模式后台查询
'appsecret' => '', // 填写高级调用功能的密钥
'encodingaeskey' => '', // 填写加密用的EncodingAESKey（可选，接口传输选择加密时必需）
'mch_id' => '', // 微信支付，商户ID（可选）
'partnerkey' => '', // 微信支付，密钥（可选）
'ssl_cer' => '', // 微信支付，证书cert的路径（可选，操作退款或打款时必需）
'ssl_key' => '', // 微信支付，证书key的路径（可选，操作退款或打款时必需）
'cachepath' => '', // 设置SDK缓存目录（可选，默认位置在./src/Cache下，请保证写权限）
);
```
**微信SDK实例的几种方法**
--
* 如：微信支付接口实例
```php
// 实例方法一 （在IDE工具上没有SDK方法的提示）
$pay = & \Wechat\Loader::get('Pay',$options);
// 实例方法二 （在IDE工具上没有SDK方法的提示）
\Wechat\Loader::config($options); // 在项目合适的地方向SDK注入配置参数（字段见上面）
$pay = & \Wechat\Loader::get('Pay'); // 这行可以在任何地方New，IDE会带提示功能哦
// 实例方法三 （在IDE工具上有SDK方法的提示）
$pay = new \Wechat\WechatPay($options);
// 实例方法四 （在IDE工具有SDK方法的提示）
\Wechat\Loader::config($options); // 在项目合适的地方向SDK注入配置参数（字段见上面）
$pay = new \Wehcat\WechatPay(); // 这行可以在任何地方New，IDE会带提示功能哦
```
* 如：微信菜单接口实例
```php
// 实例方法一 （在IDE工具上没有SDK方法的提示）
$menu = & \Wechat\Loader::get('Menu',$options);
// 实例方法二 （在IDE工具上没有SDK方法的提示）
\Wechat\Loader::config($options); // 在项目合适的地方向SDK注入配置参数（字段见上面）
$menu = & \Wechat\Loader::get('Menu'); // 这行可以在任何地方New，IDE会带提示功能哦
// 实例方法三 （在IDE工具上有SDK方法的提示）
$menu = new \Wechat\WechatMenu($options);
// 实例方法四 （在IDE工具有SDK方法的提示）
\Wechat\Loader::config($options); // 在项目合适的地方向SDK注入配置参数（字段见上面）
$menu = new \Wehcat\WechatMenu(); // 这行可以在任何地方New，IDE会带提示功能哦
```
**我们建议在项目中放置这样的函数，方便加载SDK对象**
---
* 下面是`load_wechat`助手函数标准代码，请根据自己项目的情况动态读取微信配置参数
```
/**
* 获取微信操作对象（单例模式）
* @staticvar array $wechat 静态对象缓存对象
* @param type $type 接口名称 ( Card|Custom|Device|Extend|Media|Oauth|Pay|Receive|Script|User )
* @return \Wehcat\WechatReceive 返回接口对接
*/
function & load_wechat($type = '') {
static $wechat = array();
$index = md5(strtolower($type));
if (!isset($wechat[$index])) {
// 定义微信公众号配置参数（这里是可以从数据库读取的哦）
$options = array(
'token' => '', // 填写你设定的key
'appid' => '', // 填写高级调用功能的app id, 请在微信开发模式后台查询
'appsecret' => '', // 填写高级调用功能的密钥
'encodingaeskey' => '', // 填写加密用的EncodingAESKey（可选，接口传输选择加密时必需）
'mch_id' => '', // 微信支付，商户ID（可选）
'partnerkey' => '', // 微信支付，密钥（可选）
'ssl_cer' => '', // 微信支付，双向证书（可选，操作退款或打款时必需）
'ssl_key' => '', // 微信支付，双向证书（可选，操作退款或打款时必需）
'cachepath' => '', // 设置SDK缓存目录（可选，默认位置在Wechat/Cache下，请保证写权限）
);
\Wechat\Loader::config($options);
$wechat[$index] = \Wechat\Loader::get($type);
}
return $wechat[$index];
}
```
这样我们就不用管什么配置参数了，单例模式加载，省心省力。^_^
----
* 获取粉丝列表
```
// 加载SDK对象
$user = & load_wechat('User');
// 读取调用接口，读取微信官方粉丝列表
$result = $user->getUserList();
// 接口异常的处理
if ($result === FALSE) {
echo $user->errMsg;
echo $user->errCode;
} else {
// 接口正常的处理
}
```
* 读取单个粉丝的信息
```
// 加载SDK对象
$user = & load_wechat('User');
// 读取调用接口，读取微信粉丝信息，需要传入粉丝的openid
$result = $user->getUserInfo($openid);
// 接口异常的处理
if ($result === FALSE) {
echo $user->errMsg;
echo $user->errCode;
} else {
// 接口正常的处理
}
```
* 所有接口实例以此类推，方法一致。
想了解更多关于SDK的功能，请阅读下面的章节。
有什么不明白地方，可以阅读对应的源代码，相信代码这代码也是一种不错的表达试。
当然，我们也欢乐您在下面提出您的疑问。
```
// 微信多客服接口
$custom = & load_wechat('Custom');
// 微信周边设备接口
$device = & load_wechat('Device');
// 微信其它工具接口
$extends = & load_wechat('Extends');
// 微信媒体素材接口
$media = & load_wechat('Media');
// 微信菜单操作接口
$menu = & load_wechat('Menu');
// 微信网页授权接口
$oauth = & load_wechat('Oauth');
// 微信支付相关接口
$pay = & load_wechat('Pay');
// 微信被动消息处理SDK
$receive = & load_wechat('Receive');
// 微信网页脚本工具
$script = & load_wechat('Script');
// 微信粉丝操作接口
$user = & load_wechat('User');
```
- 0.1 关于微信SDK的介绍
- 0.2 微信SDK下载与安装使用
- 0.3 微信SDK源文件结构与介绍
- 1.0 微信API验证与事件推送回复
- 1.1 微信自定义菜单及个性化菜单
- 1.2 微信粉丝用户及粉丝标签管理
- 1.3 微信网页JSSDK签名包生成
- 1.4 微信红包和JSAPI支付及扫码支付
- 1.4.0 微信支付状态通知处理
- 1.4.1 微信扫码支付（模式一）
- 1.4.2 微信扫码支付（模式二）
- 1.4.3 微信发起JSAPI支付
- 1.4.4 微信支付统一下单接口
- 1.5 微信各种素材管理及图文推送
- 1.6 微信各种卡券及微信门店管理
- 1.7 微信设备管理
- 1.9 微信OAuth授权及用户资料获取
- 2.1 用数据库管理微信SDK所需参数
- 2.2 自定微信SDK缓存设置方式
- 3.1 第三方平台配置参数及实例
- 3.2 第三方平台AccessToken获取
- 3.3 第三方平台Ticket推送处理
- 3.4 第三方平台代发起网页授权
- 4.1 案例之 CodeIgniter 3 集成方法
- 4.2 案例之 ThinkPHP 3.2 集成方法
- 4.3 案例之 ThinkPHP 5.0 集成方法
- 4.4 案例之 ThinkPHP 5.0 微信扫码支付