## 接口實例及配置參數
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. 異常處理代碼建議優化為日志記錄,方便后續問題排查。