php sdk 如何安装使用,0.2 微信SDK下载与安装使用
**下载并载入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');
```