## 接口实例及配置参数
WeChatDeveloper 所需的配置参数,需要提前准备好,方便在实例接口对接时使用。
~~~php
$config = [
'token' => 'test',
'appid' => 'wx60a43dd8161666d4',
'appsecret' => '71308e96a204296c57d7cd4b21b883e8',
'encodingaeskey' => 'BJIUzE0gqlWy0GxfPp4J1oPTBmOrNDIGPNav1YFH5Z5',
// 配置商户支付参数(可选,在使用支付功能时需要)
'mch_id' => "1235704602",
'mch_key' => 'IKI4kpHjU94ji3oqre5zYaQMwLHuZPmj',
// 配置商户支付双向证书目录(可选,在使用退款|打款|红包时需要)
'ssl_key' => '',
'ssl_cer' => '',
// 配置单个 P12 格式的支付证书文件路径(可选,适用于退款|打款|红包等场景)
'ssl_p12' => '',
// 缓存目录配置(可选,需拥有读写权限)
'cache_path' => '',
];
~~~
### 参数说明
* `appid` 和 `appsecret`:必需参数,用于微信接口调用身份验证。
* `token`:接口配置时需要设置,用于微信开发接口的验证。
* `encodingaeskey`:用于接口安全加密。
* `mch_id` 和 `mch_key`:商户支付功能所需参数,必须与 `appid` 对应。
* `ssl_key` 和 `ssl_cer`:退款、企业付款等涉及商户到用户交易功能时所需的双向证书。
* `ssl_p12`:支持单个 P12 格式的支付证书,简化配置。
* `cache_path`:缓存目录,需拥有读写权限,用于存储部分接口返回的数据。
### 示例代码
#### ① 使用直接实例化方式获取已关注用户列表
~~~php
try {
// 实例化接口对象
$user = new \WeChat\User($config);
// 调用接口方法
$list = $user->getUserList();
// 处理返回结果
echo '<pre>';
var_export($list);
} catch (Exception $e) {
// 处理异常
echo $e->getMessage() . PHP_EOL;
}
~~~
#### ② 使用工厂方法获取已关注用户列表
~~~php
try {
// 使用工厂方法实例化接口对象
$user = \We::WeChatUser($config);
// 调用接口方法
$list = $user->getUserList();
// 处理返回结果
echo '<pre>';
var_export($list);
} catch (Exception $e) {
// 处理异常
echo $e->getMessage() . PHP_EOL;
}
~~~
### 注意事项
1. 确保配置参数完整且正确,尤其是 `appid` 和 `appsecret`,否则可能导致接口调用失败。
2. 如果使用支付相关功能,请确认支付参数(如 `mch_id` 和证书路径)配置无误。
3. 异常处理代码建议优化为日志记录,方便后续问题排查。