From 4ae6a5d9ecdb4fb01dea819822fe5cd13c6e806d Mon Sep 17 00:00:00 2001 From: Anyon Date: Fri, 26 Jan 2018 18:36:17 +0800 Subject: [PATCH] =?UTF-8?q?[=E6=8F=90=E4=BA=A4]=E4=B8=8A=E4=BC=A0=E5=BE=AE?= =?UTF-8?q?=E4=BF=A1=E5=BC=80=E5=8F=91=E5=B7=A5=E5=85=B7=E5=8C=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Wechat/Card.php | 628 ++++++++++++++++++ Wechat/Contracts/Config.php | 110 +++ Wechat/Contracts/Error.php | 194 ++++++ Wechat/Contracts/Request.php | 317 +++++++++ Wechat/Contracts/Wechat.php | 158 +++++ Wechat/Custom.php | 220 ++++++ .../Exceptions/InvalidArgumentException.php | 25 + .../Exceptions/InvalidResponseException.php | 41 ++ Wechat/Exceptions/LocalCacheException.php | 42 ++ Wechat/Media.php | 183 +++++ Wechat/Menu.php | 109 +++ Wechat/Product.php | 178 +++++ Wechat/Qrcode.php | 72 ++ Wechat/Tags.php | 109 +++ Wechat/Template.php | 110 +++ Wechat/User.php | 131 ++++ 16 files changed, 2627 insertions(+) create mode 100644 Wechat/Card.php create mode 100644 Wechat/Contracts/Config.php create mode 100644 Wechat/Contracts/Error.php create mode 100644 Wechat/Contracts/Request.php create mode 100644 Wechat/Contracts/Wechat.php create mode 100644 Wechat/Custom.php create mode 100644 Wechat/Exceptions/InvalidArgumentException.php create mode 100644 Wechat/Exceptions/InvalidResponseException.php create mode 100644 Wechat/Exceptions/LocalCacheException.php create mode 100644 Wechat/Media.php create mode 100644 Wechat/Menu.php create mode 100644 Wechat/Product.php create mode 100644 Wechat/Qrcode.php create mode 100644 Wechat/Tags.php create mode 100644 Wechat/Template.php create mode 100644 Wechat/User.php diff --git a/Wechat/Card.php b/Wechat/Card.php new file mode 100644 index 0000000..e6262fd --- /dev/null +++ b/Wechat/Card.php @@ -0,0 +1,628 @@ +registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 设置买单接口 + * @param string $card_id + * @param bool $is_open + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function setPaycell($card_id, $is_open = true) + { + $url = "https://api.weixin.qq.com/card/paycell/set?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['card_id' => $card_id, 'is_open' => $is_open]); + } + + /** + * 设置买单接口 + * @param string $card_id + * @param bool $is_open + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function setConsumeCell($card_id, $is_open = true) + { + $url = "https://api.weixin.qq.com/card/selfconsumecell/set?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['card_id' => $card_id, 'is_open' => $is_open]); + } + + /** + * 创建二维码接口 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function createQrc(array $data) + { + $url = "https://api.weixin.qq.com/card/qrcode/create?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 创建货架接口 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function createLandingPage(array $data) + { + $url = "https://api.weixin.qq.com/card/landingpage/create?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 导入自定义code + * @param string $card_id + * @param array $code + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function deposit($card_id, array $code) + { + $url = "https://api.weixin.qq.com/card/code/deposit?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['card_id' => $card_id, 'code' => $code]); + } + + /** + * 查询导入code数目 + * @param string $card_id + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getDepositCount($card_id) + { + $url = "https://api.weixin.qq.com/card/code/getdepositcount?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['card_id' => $card_id]); + } + + /** + * 核查code接口 + * @param string $card_id 进行导入code的卡券ID + * @param array $code 已经微信卡券后台的自定义code，上限为100个 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function checkCode($card_id, array $code) + { + $url = "https://api.weixin.qq.com/card/code/checkcode?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['card_id' => $card_id, 'code' => $code]); + } + + /** + * 图文消息群发卡券 + * @param string $card_id + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getNewsHtml($card_id) + { + $url = "https://api.weixin.qq.com/card/mpnews/gethtml?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['card_id' => $card_id]); + } + + /** + * 设置测试白名单 + * @param array $openids + * @param array $usernames + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function setTestWhiteList($openids = [], $usernames = []) + { + $url = "https://api.weixin.qq.com/card/testwhitelist/set?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['openid' => $openids, 'username' => $usernames]); + } + + /** + * 线下核销查询Code + * @param string $code 单张卡券的唯一标准 + * @param string $card_id 卡券ID代表一类卡券。自定义code卡券必填 + * @param bool $check_consume 是否校验code核销状态，填入true和false时的code异常状态返回数据不同 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getCode($code, $card_id = null, $check_consume = null) + { + $data = ['code' => $code]; + is_null($card_id) ?: $data['card_id'] = $card_id; + is_null($check_consume) ?: $data['check_consume'] = $check_consume; + $url = "https://api.weixin.qq.com/card/code/get?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 线下核销核销Code + * @param string $code 需核销的Code码 + * @param null $card_id 券ID。创建卡券时use_custom_code填写true时必填。非自定义Code不必填写 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function consume($code, $card_id = null) + { + $data = ['code' => $code]; + is_null($card_id) ?: $data['card_id'] = $card_id; + $url = "https://api.weixin.qq.com/card/code/consume?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * Code解码接口 + * @param string $encrypt_code + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function decrypt($encrypt_code) + { + $url = "https://api.weixin.qq.com/card/code/decrypt?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['encrypt_code' => $encrypt_code]); + } + + /** + * 获取用户已领取卡券接口 + * @param string $openid + * @param null|string $card_id + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getCardList($openid, $card_id = null) + { + $data = ['openid' => $openid]; + is_null($card_id) ?: $data['card_id'] = $card_id; + $url = "https://api.weixin.qq.com/card/user/getcardlist?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 查看卡券详情 + * @param string $card_id + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getCard($card_id) + { + $url = "https://api.weixin.qq.com/card/get?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['card_id' => $card_id]); + } + + /** + * 批量查询卡券列表 + * @param int $offset 查询卡列表的起始偏移量，从0开始，即offset: 5是指从从列表里的第六个开始读取 + * @param int $count 需要查询的卡片的数量（数量最大50） + * @param array $status_list 支持开发者拉出指定状态的卡券列表 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function batchGet($offset, $count = 50, array $status_list = []) + { + $data = ['offset' => $offset, 'count' => $count]; + empty($status_list) ?: $data['status_list'] = $status_list; + $url = "https://api.weixin.qq.com/card/batchget?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 更改卡券信息接口 + * @param string $card_id + * @param array $member_card + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function updateCard($card_id, array $member_card) + { + $url = "https://api.weixin.qq.com/card/update?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['card_id' => $card_id, 'member_card' => $member_card]); + } + + /** + * 修改库存接口 + * @param string $card_id 卡券ID + * @param null|integer $increase_stock_value 增加多少库存，支持不填或填0 + * @param null|integer $reduce_stock_value 减少多少库存，可以不填或填0 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function modifyStock($card_id, $increase_stock_value = null, $reduce_stock_value = null) + { + $data = ['card_id' => $card_id]; + is_null($increase_stock_value) ?: $data['increase_stock_value'] = $increase_stock_value; + is_null($reduce_stock_value) ?: $data['reduce_stock_value'] = $reduce_stock_value; + $url = "https://api.weixin.qq.com/card/modifystock?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 更改Code接口 + * @param string $code 需变更的Code码 + * @param string $new_code 变更后的有效Code码 + * @param null|string $card_id 卡券ID + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function updateCode($code, $new_code, $card_id = null) + { + $data = ['code' => $code, 'new_code' => $new_code]; + is_null($card_id) ?: $data['card_id'] = $card_id; + $url = "https://api.weixin.qq.com/card/code/update?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 删除卡券接口 + * @param string $card_id + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function deleteCard($card_id) + { + $url = "https://api.weixin.qq.com/card/delete?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['card_id' => $card_id]); + } + + /** + * 设置卡券失效接口 + * @param string $code + * @param string $card_id + * @param null|string $reason + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function unAvailable($code, $card_id, $reason = null) + { + $data = ['code' => $code, 'card_id' => $card_id]; + is_null($reason) ?: $data['reason'] = $reason; + $url = "https://api.weixin.qq.com/card/code/unavailable?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 拉取卡券概况数据接口 + * @param string $begin_date 查询数据的起始时间 + * @param string $end_date 查询数据的截至时间 + * @param string $cond_source 卡券来源(0为公众平台创建的卡券数据 1是API创建的卡券数据) + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getCardBizuininfo($begin_date, $end_date, $cond_source) + { + $data = ['begin_date' => $begin_date, 'end_date' => $end_date, 'cond_source' => $cond_source]; + $url = "https://api.weixin.qq.com/datacube/getcardbizuininfo?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 获取免费券数据接口 + * @param string $begin_date 查询数据的起始时间 + * @param string $end_date 查询数据的截至时间 + * @param integer $cond_source 卡券来源，0为公众平台创建的卡券数据、1是API创建的卡券数据 + * @param null $card_id 卡券ID + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getCardCardinfo($begin_date, $end_date, $cond_source, $card_id = null) + { + $data = ['begin_date' => $begin_date, 'end_date' => $end_date, 'cond_source' => $cond_source]; + is_null($card_id) ?: $data['card_id'] = $card_id; + $url = "https://api.weixin.qq.com/datacube/getcardcardinfo?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 拉取会员卡概况数据接口 + * @param string $begin_date 查询数据的起始时间 + * @param string $end_date 查询数据的截至时间 + * @param string $cond_source 卡券来源(0为公众平台创建的卡券数据 1是API创建的卡券数据) + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getCardMemberCardinfo($begin_date, $end_date, $cond_source) + { + $data = ['begin_date' => $begin_date, 'end_date' => $end_date, 'cond_source' => $cond_source]; + $url = "https://api.weixin.qq.com/datacube/getcardmembercardinfo?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 拉取单张会员卡数据接口 + * @param string $begin_date 查询数据的起始时间 + * @param string $end_date 查询数据的截至时间 + * @param string $card_id 卡券id + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getCardMemberCardDetail($begin_date, $end_date, $card_id) + { + $data = ['begin_date' => $begin_date, 'end_date' => $end_date, 'card_id' => $card_id]; + $url = "https://api.weixin.qq.com/datacube/getcardmembercarddetail?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 拉取会员信息（积分查询）接口 + * @param string $card_id 查询会员卡的cardid + * @param string $code 所查询用户领取到的code值 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getCardMemberCard($card_id, $code) + { + $data = ['card_id' => $card_id, 'code' => $code]; + $url = "https://api.weixin.qq.com/card/membercard/userinfo/get?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 设置支付后投放卡券接口 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function payGiftCard(array $data) + { + $url = "https://api.weixin.qq.com/card/paygiftcard/add?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 删除支付后投放卡券规则 + * @param integer $rule_id 支付即会员的规则名称 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function delPayGiftCard($rule_id) + { + $url = "https://api.weixin.qq.com/card/paygiftcard/add?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['rule_id' => $rule_id]); + } + + /** + * 查询支付后投放卡券规则详情 + * @param integer $rule_id 要查询规则id + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getPayGiftCard($rule_id) + { + $url = "https://api.weixin.qq.com/card/paygiftcard/getbyid?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['rule_id' => $rule_id]); + } + + /** + * 批量查询支付后投放卡券规则 + * @param integer $offset 起始偏移量 + * @param integer $count 查询的数量 + * @param bool $effective 是否仅查询生效的规则 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function batchGetPayGiftCard($offset = 0, $count = 10, $effective = true) + { + $data = ['type' => 'RULE_TYPE_PAY_MEMBER_CARD', 'offset' => $offset, 'count' => $count, 'effective' => $effective]; + $url = "https://api.weixin.qq.com/card/paygiftcard/batchget?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 创建支付后领取立减金活动 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function addActivity(array $data) + { + $url = "https://api.weixin.qq.com/card/mkt/activity/create?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 开通券点账户接口 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function payActivate() + { + $url = "https://api.weixin.qq.com/card/pay/activate?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpGetForJson($url); + } + + /** + * 对优惠券批价 + * @param string $card_id 需要来配置库存的card_id + * @param integer $quantity 本次需要兑换的库存数目 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getPayprice($card_id, $quantity) + { + $url = "POST https://api.weixin.qq.com/card/pay/getpayprice?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['card_id' => $card_id, 'quantity' => $quantity]); + } + + /** + * 查询券点余额接口 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getCoinsInfo() + { + $url = "https://api.weixin.qq.com/card/pay/getcoinsinfo?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpGetForJson($url); + } + + /** + * 确认兑换库存接口 + * @param string $card_id 需要来兑换库存的card_id + * @param integer $quantity 本次需要兑换的库存数目 + * @param string $order_id 仅可以使用上面得到的订单号，保证批价有效性 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function payConfirm($card_id, $quantity, $order_id) + { + $data = ['card_id' => $card_id, 'quantity' => $quantity, 'order_id' => $order_id]; + $url = "https://api.weixin.qq.com/card/pay/confirm?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 充值券点接口 + * @param integer $coin_count + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function payRecharge($coin_count) + { + $url = "https://api.weixin.qq.com/card/pay/recharge?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['coin_count' => $coin_count]); + } + + /** + * 查询订单详情接口 + * @param string $order_id + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function payGetOrder($order_id) + { + $url = "https://api.weixin.qq.com/card/pay/getorder?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['order_id' => $order_id]); + } + + /** + * 查询券点流水详情接口 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function payGetList(array $data) + { + $url = "https://api.weixin.qq.com/card/pay/getorderlist?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 获取JSAPI_TICKET接口 + * @param string $type TICKET类型(wx_card|jsapi) + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getTicket($type = 'jsapi') + { + $url = "https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type={$type}"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpGetForJson($url); + } + +} \ No newline at end of file diff --git a/Wechat/Contracts/Config.php b/Wechat/Contracts/Config.php new file mode 100644 index 0000000..de5a3cd --- /dev/null +++ b/Wechat/Contracts/Config.php @@ -0,0 +1,110 @@ +config = $options; + } + + /** + * 设置配置项值 + * @param string $offset + * @param string|array|null|integer $value + */ + public function set($offset, $value) + { + $this->offsetSet($offset, $value); + } + + /** + * 获取配置项参数 + * @param string|null $offset + * @return array|string|null + */ + public function get($offset = null) + { + return $this->offsetGet($offset); + } + + /** + * 设置配置项值 + * @param string $offset + * @param string|array|null|integer $value + */ + public function offsetSet($offset, $value) + { + if (is_null($offset)) { + $this->config[] = $value; + } else { + $this->config[$offset] = $value; + } + } + + /** + * 判断配置Key是否存在 + * @param string $offset + * @return bool + */ + public function offsetExists($offset) + { + return isset($this->config[$offset]); + } + + /** + * 清理配置项 + * @param string|null $offset + */ + public function offsetUnset($offset = null) + { + if (is_null($offset)) { + $this->config = []; + } else { + unset($this->config[$offset]); + } + } + + /** + * 获取配置项参数 + * @param string|null $offset + * @return array|string|null + */ + public function offsetGet($offset = null) + { + if (is_null($offset)) { + return $this->config; + } + return isset($this->config[$offset]) ? $this->config[$offset] : null; + } +} \ No newline at end of file diff --git a/Wechat/Contracts/Error.php b/Wechat/Contracts/Error.php new file mode 100644 index 0000000..016e72c --- /dev/null +++ b/Wechat/Contracts/Error.php @@ -0,0 +1,194 @@ + '系统繁忙，此时请开发者稍候再试', + 0 => '请求成功', + 40001 => '获取 access_token 时 AppSecret 错误，或者 access_token 无效。请开发者认真比对 AppSecret 的正确性，或查看是否正在为恰当的公众号调用接口', + 40002 => '不合法的凭证类型', + 40003 => '不合法的 OpenID ，请开发者确认 OpenID （该用户）是否已关注公众号，或是否是其他公众号的 OpenID', + 40004 => '不合法的媒体文件类型', + 40005 => '不合法的文件类型', + 40006 => '不合法的文件大小', + 40007 => '不合法的媒体文件 id', + 40008 => '不合法的消息类型', + 40009 => '不合法的图片文件大小', + 40010 => '不合法的语音文件大小', + 40011 => '不合法的视频文件大小', + 40012 => '不合法的缩略图文件大小', + 40013 => '不合法的 AppID ，请开发者检查 AppID 的正确性，避免异常字符，注意大小写', + 40014 => '不合法的 access_token ，请开发者认真比对 access_token 的有效性（如是否过期），或查看是否正在为恰当的公众号调用接口', + 40015 => '不合法的菜单类型', + 40016 => '不合法的按钮个数', + 40017 => '不合法的按钮个数', + 40018 => '不合法的按钮名字长度', + 40019 => '不合法的按钮 KEY 长度', + 40020 => '不合法的按钮 URL 长度', + 40021 => '不合法的菜单版本号', + 40022 => '不合法的子菜单级数', + 40023 => '不合法的子菜单按钮个数', + 40024 => '不合法的子菜单按钮类型', + 40025 => '不合法的子菜单按钮名字长度', + 40026 => '不合法的子菜单按钮 KEY 长度', + 40027 => '不合法的子菜单按钮 URL 长度', + 40028 => '不合法的自定义菜单使用用户', + 40029 => '不合法的 oauth_code', + 40030 => '不合法的 refresh_token', + 40031 => '不合法的 openid 列表', + 40032 => '不合法的 openid 列表长度', + 40033 => '不合法的请求字符，不能包含 \\uxxxx 格式的字符', + 40035 => '不合法的参数', + 40038 => '不合法的请求格式', + 40039 => '不合法的 URL 长度', + 40050 => '不合法的分组 id', + 40051 => '分组名字不合法', + 40060 => '删除单篇图文时，指定的 article_idx 不合法', + 40117 => '分组名字不合法', + 40118 => 'media_id 大小不合法', + 40119 => 'button 类型错误', + 40120 => 'button 类型错误', + 40121 => '不合法的 media_id 类型', + 40132 => '微信号不合法', + 40137 => '不支持的图片格式', + 40155 => '请勿添加其他公众号的主页链接', + 41001 => '缺少 access_token 参数', + 41002 => '缺少 appid 参数', + 41003 => '缺少 refresh_token 参数', + 41004 => '缺少 secret 参数', + 41005 => '缺少多媒体文件数据', + 41006 => '缺少 media_id 参数', + 41007 => '缺少子菜单数据', + 41008 => '缺少 oauth code', + 41009 => '缺少 openid', + 42001 => 'access_token 超时，请检查 access_token 的有效期，请参考基础支持 - 获取 access_token 中，对 access_token 的详细机制说明', + 42002 => 'refresh_token 超时', + 42003 => 'oauth_code 超时', + 42007 => '用户修改微信密码， accesstoken 和 refreshtoken 失效，需要重新授权', + 43001 => '需要 GET 请求', + 43002 => '需要 POST 请求', + 43003 => '需要 HTTPS 请求', + 43004 => '需要接收者关注', + 43005 => '需要好友关系', + 43019 => '需要将接收者从黑名单中移除', + 44001 => '多媒体文件为空', + 44002 => 'POST 的数据包为空', + 44003 => '图文消息内容为空', + 44004 => '文本消息内容为空', + 45001 => '多媒体文件大小超过限制', + 45002 => '消息内容超过限制', + 45003 => '标题字段超过限制', + 45004 => '描述字段超过限制', + 45005 => '链接字段超过限制', + 45006 => '图片链接字段超过限制', + 45007 => '语音播放时间超过限制', + 45008 => '图文消息超过限制', + 45009 => '接口调用超过限制', + 45010 => '创建菜单个数超过限制', + 45011 => 'API 调用太频繁，请稍候再试', + 45015 => '回复时间超过限制', + 45016 => '系统分组，不允许修改', + 45017 => '分组名字过长', + 45018 => '分组数量超过上限', + 45047 => '客服接口下行条数超过上限', + 46001 => '不存在媒体数据', + 46002 => '不存在的菜单版本', + 46003 => '不存在的菜单数据', + 46004 => '不存在的用户', + 47001 => '解析 JSON/XML 内容错误', + 48001 => 'api 功能未授权，请确认公众号已获得该接口，可以在公众平台官网 - 开发者中心页中查看接口权限', + 48002 => '粉丝拒收消息（粉丝在公众号选项中，关闭了 “ 接收消息 ” ）', + 48004 => 'api 接口被封禁，请登录 mp.weixin.qq.com 查看详情', + 48005 => 'api 禁止删除被自动回复和自定义菜单引用的素材', + 48006 => 'api 禁止清零调用次数，因为清零次数达到上限', + 48008 => '没有该类型消息的发送权限', + 50001 => '用户未授权该 api', + 50002 => '用户受限，可能是违规后接口被封禁', + 61451 => '参数错误 (invalid parameter)', + 61452 => '无效客服账号 (invalid kf_account)', + 61453 => '客服帐号已存在 (kf_account exsited)', + 61454 => '客服帐号名长度超过限制 ( 仅允许 10 个英文字符，不包括 @ 及 @ 后的公众号的微信号 )(invalid kf_acount length)', + 61455 => '客服帐号名包含非法字符 ( 仅允许英文 + 数字 )(illegal character in kf_account)', + 61456 => '客服帐号个数超过限制 (10 个客服账号 )(kf_account count exceeded)', + 61457 => '无效头像文件类型 (invalid file type)', + 61450 => '系统错误 (system error)', + 61500 => '日期格式错误', + 65301 => '不存在此 menuid 对应的个性化菜单', + 65302 => '没有相应的用户', + 65303 => '没有默认菜单，不能创建个性化菜单', + 65304 => 'MatchRule 信息为空', + 65305 => '个性化菜单数量受限', + 65306 => '不支持个性化菜单的帐号', + 65307 => '个性化菜单信息为空', + 65308 => '包含没有响应类型的 button', + 65309 => '个性化菜单开关处于关闭状态', + 65310 => '填写了省份或城市信息，国家信息不能为空', + 65311 => '填写了城市信息，省份信息不能为空', + 65312 => '不合法的国家信息', + 65313 => '不合法的省份信息', + 65314 => '不合法的城市信息', + 65316 => '该公众号的菜单设置了过多的域名外跳（最多跳转到 3 个域名的链接）', + 65317 => '不合法的 URL', + 9001001 => 'POST 数据参数不合法', + 9001002 => '远端服务不可用', + 9001003 => 'Ticket 不合法', + 9001004 => '获取摇周边用户信息失败', + 9001005 => '获取商户信息失败', + 9001006 => '获取 OpenID 失败', + 9001007 => '上传文件缺失', + 9001008 => '上传素材的文件类型不合法', + 9001009 => '上传素材的文件尺寸不合法', + 9001010 => '上传失败', + 9001020 => '帐号不合法', + 9001021 => '已有设备激活率低于 50% ，不能新增设备', + 9001022 => '设备申请数不合法，必须为大于 0 的数字', + 9001023 => '已存在审核中的设备 ID 申请', + 9001024 => '一次查询设备 ID 数量不能超过 50', + 9001025 => '设备 ID 不合法', + 9001026 => '页面 ID 不合法', + 9001027 => '页面参数不合法', + 9001028 => '一次删除页面 ID 数量不能超过 10', + 9001029 => '页面已应用在设备中，请先解除应用关系再删除', + 9001030 => '一次查询页面 ID 数量不能超过 50', + 9001031 => '时间区间不合法', + 9001032 => '保存设备与页面的绑定关系参数错误', + 9001033 => '门店 ID 不合法', + 9001034 => '设备备注信息过长', + 9001035 => '设备申请参数不合法', + 9001036 => '查询起始值 begin 不合法', + ]; + + /** + * 异常代码解析描述 + * @param string $code + * @return string + */ + public static function toMessage($code) + { + return isset(self::$message[$code]) ? self::$message[$code] : $code; + } + +} \ No newline at end of file diff --git a/Wechat/Contracts/Request.php b/Wechat/Contracts/Request.php new file mode 100644 index 0000000..44e4f37 --- /dev/null +++ b/Wechat/Contracts/Request.php @@ -0,0 +1,317 @@ +" . self::_data_to_xml($data) . ""; + } + + /** + * XML内容生成 + * @param array $data 数据 + * @param string $content + * @return string + */ + private static function _data_to_xml($data, $content = '') + { + foreach ($data as $key => $val) { + $content .= "<{$key}>"; + if (is_array($val) || is_object($val)) { + $content .= self::_data_to_xml($val); + } elseif (is_string($val)) { + $content .= ''; + } else { + $content .= $val; + } + $content .= ""; + } + return $content; + } + + /** + * 解析XML内容到数组 + * @param string $xml + * @return array + */ + public static function fromXml($xml) + { + return json_decode(self::toJson(simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA)), true); + } + + /** + * 数组转xml内容 + * @param array $data + * @return null|string|string + */ + public static function toJson($data) + { + return preg_replace_callback('/\\\\u([0-9a-f]{4})/i', function ($matches) { + return mb_convert_encoding(pack("H*", $matches[1]), "UTF-8", "UCS-2BE"); + }, json_encode($data)); + } + + /** + * 解析JSON内容到数组 + * @param string $json + * @return array + * @throws InvalidResponseException + */ + public static function fromJson($json) + { + $result = json_decode($json, true); + if (empty($result)) { + throw new InvalidResponseException('invalid response.', '0'); + } + if (!empty($result['errcode'])) { + throw new InvalidResponseException($result['errmsg'], $result['errcode'], $result); + } + return $result; + } + + /** + * CURL模拟网络请求 + * @param string $method 请求方法 + * @param string $url 请求方法 + * @param array $options 请求参数[headers,data,ssl_cer,ssl_key] + * @return bool|string + */ + protected static function doRequest($method, $url, $options = []) + { + $curl = curl_init(); + // GET参数设置 + if (!empty($options['query'])) { + $url .= (stripos($url, '?') !== false ? '&' : '?') . http_build_query($options['query']); + } + // POST数据设置 + if (strtolower($method) === 'post') { + curl_setopt($curl, CURLOPT_POST, true); + curl_setopt($curl, CURLOPT_POSTFIELDS, self::build($options['data'])); + } + // CURL头信息设置 + if (!empty($options['headers'])) { + curl_setopt($curl, CURLOPT_HTTPHEADER, $options['headers']); + } + // 证书文件设置 + if (!empty($options['ssl_cer'])) { + if (file_exists($options['ssl_cer'])) { + curl_setopt($curl, CURLOPT_SSLCERTTYPE, 'PEM'); + curl_setopt($curl, CURLOPT_SSLCERT, $options['ssl_cer']); + } else { + throw new InvalidArgumentException("Certificate files that do not exist. --- [{$options['ssl_cer']}]"); + } + } + // 证书文件设置 + if (!empty($options['ssl_key'])) { + if (file_exists($options['ssl_key'])) { + curl_setopt($curl, CURLOPT_SSLKEYTYPE, 'PEM'); + curl_setopt($curl, CURLOPT_SSLKEY, $options['ssl_key']); + } else { + throw new InvalidArgumentException("Certificate files that do not exist. --- [{$options['ssl_key']}]"); + } + } + curl_setopt($curl, CURLOPT_URL, $url); + curl_setopt($curl, CURLOPT_TIMEOUT, 60); + curl_setopt($curl, CURLOPT_HEADER, false); + curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); + curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false); + curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); + list($content, $status) = [curl_exec($curl), curl_getinfo($curl), curl_close($curl)]; + return (intval($status["http_code"]) === 200) ? $content : false; + } + + /** + * POST数据过滤处理 + * @param array $data + * @return array + */ + private static function build($data) + { + if (is_array($data)) { + foreach ($data as $key => $value) { + if (is_string($value) && class_exists('CURLFile', false) && stripos($value, '@') === 0) { + $filename = realpath(trim($value, '@')); + if ($filename && file_exists($filename)) { + $data[$key] = new \CURLFile($filename); + } + } + } + } + return $data; + } + + /** + * 缓存配置与存储 + * @param string $name 缓存名称 + * @param string $value 缓存内容 + * @param int $expired 缓存时间(0表示永久缓存) + * @throws LocalCacheException + */ + public static function setCache($name, $value = '', $expired = 3600) + { + $cache_file = self::getCacheName($name); + $content = serialize(['name' => $name, 'value' => $value, 'expired' => time() + intval($expired)]); + if (!file_put_contents($cache_file, $content)) { + throw new LocalCacheException('local cache error.', '0'); + } + } + + /** + * 获取缓存内容 + * @param string $name 缓存名称 + * @return null|mixed + */ + public static function getCache($name) + { + $cache_file = self::getCacheName($name); + if (file_exists($cache_file) && ($content = file_get_contents($cache_file))) { + $data = unserialize($content); + if (isset($data['expired']) && (intval($data['expired']) === 0 || intval($data['expired']) >= time())) { + return $data['value']; + } + self::delCache($name); + } + return null; + } + + /** + * 移除缓存文件 + * @param string $name 缓存名称 + * @return bool + */ + public static function delCache($name) + { + $cache_file = self::getCacheName($name); + return file_exists($cache_file) ? unlink($cache_file) : true; + } + + /** + * 应用缓存目录 + * @param string $name + * @return string + */ + private static function getCacheName($name) + { + if (empty(self::$cache_path)) { + self::$cache_path = dirname(__DIR__) . DIRECTORY_SEPARATOR . 'Cache' . DIRECTORY_SEPARATOR; + } + self::$cache_path = rtrim(self::$cache_path, '/\\') . DIRECTORY_SEPARATOR; + file_exists(self::$cache_path) || mkdir(self::$cache_path, 0755, true); + return self::$cache_path . md5($name); + } +} \ No newline at end of file diff --git a/Wechat/Contracts/Wechat.php b/Wechat/Contracts/Wechat.php new file mode 100644 index 0000000..bfa9c31 --- /dev/null +++ b/Wechat/Contracts/Wechat.php @@ -0,0 +1,158 @@ +config = new Config($options); + } + + /** + * 获取访问accessToken + * @return string + * @throws \Wechat\Exceptions\InvalidResponseException + * @throws \Wechat\Exceptions\LocalCacheException + */ + public function getAccesstoken() + { + if (!empty($this->access_token)) { + return $this->access_token; + } + $cacheKey = $this->config->get('appid') . '_accesstoken'; + $this->access_token = Request::getCache($cacheKey); + if (!empty($this->access_token)) { + return $this->access_token; + } + list($appid, $secret) = [$this->config->get('appid'), $this->config->get('secret')]; + $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={$appid}&secret={$secret}"; + $result = Request::fromJson(Request::get($url)); + if (!empty($result['access_token'])) { + Request::setCache($cacheKey, $result['access_token'], 6000); + } + return $result['access_token']; + } + + /** + * 清理删除accessToken + * @return bool + */ + public function delAccessToken() + { + $this->access_token = ''; + return Request::delCache($this->config->get('appid') . '_accesstoken'); + } + + + /** + * 以GET获取接口数据并转为数组 + * @param string $url 接口地址 + * @return array + */ + protected function httpGetForJson($url) + { + try { + return Request::fromJson(Request::get($url)); + } catch (InvalidResponseException $e) { + if (!$this->isTry && in_array($e->getCode(), ['40014', '40001', '41001', '42001'])) { + $this->delAccessToken(); + $this->isTry = true; + return call_user_func_array([$this, $this->currentMethod['method']], $this->currentMethod['arguments']); + } + } + } + + /** + * 以POST获取接口数据并转为数组 + * @param string $url 接口地址 + * @param array $data 请求数据 + * @param bool $buildToJson + * @return array + */ + protected function httpPostForJson($url, array $data, $buildToJson = true) + { + try { + return Request::fromJson(Request::post($url, $buildToJson ? Request::toJson($data) : $data)); + } catch (InvalidResponseException $e) { + if (!$this->isTry && in_array($e->getCode(), ['40014', '40001', '41001', '42001'])) { + $this->delAccessToken(); + $this->isTry = true; + return call_user_func_array([$this, $this->currentMethod['method']], $this->currentMethod['arguments']); + } + } + } + + /** + * 注册当前请求接口 + * @param string $url 接口地址 + * @param string $method 当前接口方法 + * @param array $arguments 请求参数 + * @return mixed + * @throws \Wechat\Exceptions\InvalidResponseException + * @throws \Wechat\Exceptions\LocalCacheException + */ + protected function registerApi(&$url, $method, $arguments = []) + { + $this->currentMethod = ['method' => $method, 'arguments' => $arguments]; + if (empty($this->access_token)) { + $this->access_token = $this->getAccesstoken(); + } + return $url = str_replace('ACCESS_TOKEN', $this->access_token, $url); + } + +} \ No newline at end of file diff --git a/Wechat/Custom.php b/Wechat/Custom.php new file mode 100644 index 0000000..763599a --- /dev/null +++ b/Wechat/Custom.php @@ -0,0 +1,220 @@ + $kf_account, 'nickname' => $nickname, 'password' => $password]; + $url = "https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 修改客服帐号 + * @param string $kf_account 客服账号 + * @param string $nickname 客服昵称 + * @param string $password 账号密码 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function updateAccount($kf_account, $nickname, $password) + { + $data = ['kf_account' => $kf_account, 'nickname' => $nickname, 'password' => $password]; + $url = "https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 删除客服帐号 + * @param string $kf_account 客服账号 + * @param string $nickname 客服昵称 + * @param string $password 账号密码 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function deleteAccount($kf_account, $nickname, $password) + { + $data = ['kf_account' => $kf_account, 'nickname' => $nickname, 'password' => $password]; + $url = "https://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 获取所有客服账号 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getAccountList() + { + $url = "https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpGetForJson($url); + } + + /** + * 客服接口-发消息 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function send(array $data) + { + $url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 客服输入状态 + * @param string $openid 普通用户（openid） + * @param string $command Typing:正在输入,CancelTyping:取消正在输入 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function typing($openid, $command = 'Typing') + { + $url = "https://api.weixin.qq.com/cgi-bin/message/custom/typing?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['touser' => $openid, 'command' => $command]); + } + + /** + * 根据标签进行群发【订阅号与服务号认证后均可用】 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function massSendAll(array $data) + { + $url = "https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 根据OpenID列表群发【订阅号不可用，服务号认证后可用】 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function massSend(array $data) + { + $url = "https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 删除群发【订阅号与服务号认证后均可用】 + * @param integer $msg_id 发送出去的消息ID + * @param null|integer $article_idx 要删除的文章在图文消息中的位置，第一篇编号为1，该字段不填或填0会删除全部文章 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function massDelete($msg_id, $article_idx = null) + { + $data = ['msg_id' => $msg_id]; + is_null($article_idx) ?: $article_idx; + $url = "https://api.weixin.qq.com/cgi-bin/message/mass/delete?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 预览接口【订阅号与服务号认证后均可用】 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function massPreview(array $data) + { + $url = "https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 查询群发消息发送状态【订阅号与服务号认证后均可用】 + * @param integer $msg_id 群发消息后返回的消息id + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function massGet($msg_id) + { + $url = "https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['msg_id' => $msg_id]); + } + + /** + * 获取群发速度 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function massGetSeed() + { + $url = "https://api.weixin.qq.com/cgi-bin/message/mass/speed/get?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, []); + } + + /** + * 设置群发速度 + * @param integer $speed 群发速度的级别 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function massSetSeed($speed) + { + $url = "https://api.weixin.qq.com/cgi-bin/message/mass/speed/set?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, []); + } + + +} \ No newline at end of file diff --git a/Wechat/Exceptions/InvalidArgumentException.php b/Wechat/Exceptions/InvalidArgumentException.php new file mode 100644 index 0000000..1701e12 --- /dev/null +++ b/Wechat/Exceptions/InvalidArgumentException.php @@ -0,0 +1,25 @@ +raw = $raw; + } + +} \ No newline at end of file diff --git a/Wechat/Exceptions/LocalCacheException.php b/Wechat/Exceptions/LocalCacheException.php new file mode 100644 index 0000000..e654f41 --- /dev/null +++ b/Wechat/Exceptions/LocalCacheException.php @@ -0,0 +1,42 @@ +raw = $raw; + } + +} \ No newline at end of file diff --git a/Wechat/Media.php b/Wechat/Media.php new file mode 100644 index 0000000..0d4701b --- /dev/null +++ b/Wechat/Media.php @@ -0,0 +1,183 @@ +registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['media' => Request::createCurlFile($filename)], false); + } + + /** + * 获取临时素材 + * @param string $media_id + * @return bool|string + * @throws Exceptions\LocalCacheException + * @throws InvalidResponseException + */ + public function get($media_id) + { + $url = "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id={$media_id}"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return Request::get($url); + } + + /** + * 新增临时素材 + * @param array $data 文件名称 + * @return array + * @throws Exceptions\LocalCacheException + * @throws InvalidResponseException + */ + public function addNews($data) + { + $url = "https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 新增临时素材 + * @param string $media_id 要修改的图文消息的id + * @param int $index 要更新的文章在图文消息中的位置（多图文消息时，此字段才有意义），第一篇为0 + * @param array $news 文章内容 + * @return array + * @throws Exceptions\LocalCacheException + * @throws InvalidResponseException + */ + public function updateNews($media_id, $index, $news) + { + $data = ['media_id' => $media_id, 'index' => $index, 'articles' => $news]; + $url = "https://api.weixin.qq.com/cgi-bin/material/update_news?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 上传图文消息内的图片获取URL + * @param string $filename + * @return array + * @throws Exceptions\LocalCacheException + * @throws InvalidResponseException + */ + public function uploadImg($filename) + { + $url = "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['media' => Request::createCurlFile($filename)], false); + } + + /** + * 新增其他类型永久素材 + * @param string $filename 文件名称 + * @param string $type 媒体文件类型(image|voice|video|thumb) + * @param array $description 包含素材的描述信息 + * @return array + * @throws Exceptions\LocalCacheException + * @throws InvalidResponseException + */ + public function addMaterial($filename, $type = 'image', $description = []) + { + if (!in_array($type, ['image', 'voice', 'video', 'thumb'])) { + throw new InvalidResponseException('Invalid Media Type.', '0'); + } + $url = "https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type={$type}"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['media' => Request::createCurlFile($filename), 'description' => Request::toJson($description)], false); + } + + /** + * 获取永久素材 + * @param string $media_id + * @return array + * @throws Exceptions\LocalCacheException + * @throws InvalidResponseException + */ + public function getMaterial($media_id) + { + $url = "https://api.weixin.qq.com/cgi-bin/material/get_material?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['media_id' => $media_id]); + } + + /** + * 删除永久素材 + * @param string $media_id + * @return array + * @throws Exceptions\LocalCacheException + * @throws InvalidResponseException + */ + public function delMaterial($media_id) + { + $url = "https://api.weixin.qq.com/cgi-bin/material/del_material?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['media_id' => $media_id]); + } + + /** + * 获取素材总数 + * @return array + * @throws Exceptions\LocalCacheException + * @throws InvalidResponseException + */ + public function getMaterialCount() + { + $url = "https://api.weixin.qq.com/cgi-bin/material/get_materialcount?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpGetForJson($url); + } + + /** + * 获取素材列表 + * @param string $type + * @param int $offset + * @param int $count + * @return array + * @throws Exceptions\LocalCacheException + * @throws InvalidResponseException + */ + public function batchGetMaterial($type, $offset = 0, $count = 20) + { + if (!in_array($type, ['image', 'voice', 'video', 'news'])) { + throw new InvalidResponseException('Invalid Media Type.', '0'); + } + $url = "https://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['type' => $type, 'offset' => $offset, 'count' => $count]); + } +} \ No newline at end of file diff --git a/Wechat/Menu.php b/Wechat/Menu.php new file mode 100644 index 0000000..09f9152 --- /dev/null +++ b/Wechat/Menu.php @@ -0,0 +1,109 @@ +registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpGetForJson($url); + } + + /** + * 自定义菜单删除接口 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function delete() + { + $url = "https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpGetForJson($url); + } + + /** + * 自定义菜单创建 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function create(array $data) + { + $url = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 创建个性化菜单 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function addConditional(array $data) + { + $url = "https://api.weixin.qq.com/cgi-bin/menu/addconditional?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 删除个性化菜单 + * @param string $menuid + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function delConditional($menuid) + { + $url = "https://api.weixin.qq.com/cgi-bin/menu/delconditional?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['menuid' => $menuid]); + } + + /** + * 测试个性化菜单匹配结果 + * @param string $openid + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function tryConditional($openid) + { + $url = "https://api.weixin.qq.com/cgi-bin/menu/trymatch?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['user_id' => $openid]); + } + +} \ No newline at end of file diff --git a/Wechat/Product.php b/Wechat/Product.php new file mode 100644 index 0000000..f868cba --- /dev/null +++ b/Wechat/Product.php @@ -0,0 +1,178 @@ + $keystandard, 'keystr' => $keystr, 'status' => $status]; + $url = "https://api.weixin.qq.com/scan/product/modstatus?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 设置测试人员白名单 + * @param array $openids 测试人员的openid列表 + * @param array $usernames 测试人员的微信号列表 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function setTestWhiteList(array $openids = [], array $usernames = []) + { + $data = ['openid' => $openids, 'username' => $usernames]; + $url = "https://api.weixin.qq.com/scan/testwhitelist/set?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 获取商品二维码 + * @param string $keystandard 商品编码标准 + * @param string $keystr 商品编码内容 + * @param integer $qrcode_size 二维码的尺寸（整型），数值代表边长像素数，不填写默认值为100 + * @param array $extinfo 由商户自定义传入，建议仅使用大小写字母、数字及-_().*这6个常用字符 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getQrcode($keystandard, $keystr, $qrcode_size, $extinfo = []) + { + $data = ['keystandard' => $keystandard, 'keystr' => $keystr, 'qrcode_size' => $qrcode_size]; + empty($extinfo) ?: $data['extinfo'] = $extinfo; + $url = "https://api.weixin.qq.com/scan/product/getqrcode?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 查询商品信息 + * @param string $keystandard 商品编码标准 + * @param string $keystr 商品编码内容 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getProduct($keystandard, $keystr) + { + $data = ['keystandard' => $keystandard, 'keystr' => $keystr]; + empty($extinfo) ?: $data['extinfo'] = $extinfo; + $url = "https://api.weixin.qq.com/scan/product/get?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 批量查询商品信息 + * @param integer $offset 批量查询的起始位置，从0开始，包含该起始位置 + * @param integer $limit 批量查询的数量 + * @param null|string $status 支持按状态拉取。on为发布状态，off为未发布状态，check为审核中状态，reject为审核未通过状态，all为所有状态 + * @param string $keystr 支持按部分编码内容拉取。填写该参数后，可将编码内容中包含所传参数的商品信息拉出。类似关键词搜索 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getProductList($offset, $limit = 10, $status = null, $keystr = '') + { + $data = ['offset' => $offset, 'limit' => $limit]; + is_null($status) ?: $data['status'] = $status; + empty($keystr) ?: $data['keystr'] = $keystr; + $url = "https://api.weixin.qq.com/scan/product/get?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + + /** + * 更新商品信息 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function updateProduct(array $data) + { + $url = "https://api.weixin.qq.com/scan/product/update?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 清除商品信息 + * @param string $keystandard 商品编码标准 + * @param string $keystr 商品编码内容 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function clearProduct($keystandard, $keystr) + { + $url = "https://api.weixin.qq.com/scan/product/clear?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['keystandard' => $keystandard, 'keystr' => $keystr]); + } + + + /** + * 检查wxticket参数 + * @param string $ticket + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function scanTicketCheck($ticket) + { + $url = "https://api.weixin.qq.com/scan/scanticket/check?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['ticket' => $ticket]); + } + + /** + * 清除扫码记录 + * @param string $keystandard 商品编码标准 + * @param string $keystr 商品编码内容 + * @param string $extinfo 调用“获取商品二维码接口”时传入的extinfo，为标识参数 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function clearScanticket($keystandard, $keystr, $extinfo) + { + $data = ['keystandard' => $keystandard, 'keystr' => $keystr, 'extinfo' => $extinfo]; + $url = "https://api.weixin.qq.com/scan/scanticket/check?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + +} \ No newline at end of file diff --git a/Wechat/Qrcode.php b/Wechat/Qrcode.php new file mode 100644 index 0000000..4bd9c4f --- /dev/null +++ b/Wechat/Qrcode.php @@ -0,0 +1,72 @@ + 'QR_LIMIT_SCENE', 'action_info' => ['scene' => ['scene_id' => $scene]]]; + } else { + $data = ['action_name' => 'QR_LIMIT_STR_SCENE', 'action_info' => ['scene' => ['scene_str' => $scene]]]; + } + empty($expire_seconds) ?: $data['expire_seconds'] = $expire_seconds; + $url = "https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 通过ticket换取二维码 + * @param string $ticket + * @return string + */ + public function url($ticket) + { + return "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket={$ticket}"; + } + + /** + * 长链接转短链接接口 + * @param string $longUrl 需要转换的长链接 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function shortUrl($longUrl) + { + $url = "https://api.weixin.qq.com/cgi-bin/shorturl?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['action' => 'long2short', 'long_url' => $longUrl]); + } + +} \ No newline at end of file diff --git a/Wechat/Tags.php b/Wechat/Tags.php new file mode 100644 index 0000000..829beca --- /dev/null +++ b/Wechat/Tags.php @@ -0,0 +1,109 @@ +registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpGetForJson($url); + } + + /** + * 创建粉丝标签 + * @param string $name + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function createTags($name) + { + $url = "https://api.weixin.qq.com/cgi-bin/tags/create?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['tag' => ['name' => $name]]); + } + + /** + * 删除粉丝标签 + * @param int $tagId + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function deleteTags($tagId) + { + $url = 'https://api.weixin.qq.com/cgi-bin/tags/delete?access_token=ACCESS_TOKEN'; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['tag' => ['id' => $tagId]]); + } + + /** + * 批量为用户打标签 + * @param array $openids + * @param integer $tagId + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function batchTagging(array $openids, $tagId) + { + $url = 'https://api.weixin.qq.com/cgi-bin/tags/members/batchtagging?access_token=ACCESS_TOKEN'; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['openid_list' => $openids, $tagId]); + } + + /** + * 批量为用户取消标签 + * @param array $openids + * @param integer $tagId + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function batchUntagging(array $openids, $tagId) + { + $url = 'https://api.weixin.qq.com/cgi-bin/tags/members/batchuntagging?access_token=ACCESS_TOKEN'; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['openid_list' => $openids, $tagId]); + } + + /** + * 获取用户身上的标签列表 + * @param string $openid + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getUserTagId($openid) + { + $url = 'https://api.weixin.qq.com/cgi-bin/tags/getidlist?access_token=ACCESS_TOKEN'; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['openid' => $openid]); + } +} \ No newline at end of file diff --git a/Wechat/Template.php b/Wechat/Template.php new file mode 100644 index 0000000..4bebd8e --- /dev/null +++ b/Wechat/Template.php @@ -0,0 +1,110 @@ +registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['industry_id1' => $industry_id1, 'industry_id2' => $industry_id2]); + } + + /** + * 获取设置的行业信息 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getIndustry() + { + $url = "https://api.weixin.qq.com/cgi-bin/template/get_industry?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpGetForJson($url); + } + + /** + * 获得模板ID + * @param string $tpl_id 板库中模板的编号，有“TM**”和“OPENTMTM**”等形式 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function addTemplate($tpl_id) + { + $url = "https://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['template_id_short' => $tpl_id]); + } + + /** + * 获取模板列表 + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getAllPrivateTemplate() + { + $url = "https://api.weixin.qq.com/cgi-bin/template/get_all_private_template?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpGetForJson($url); + } + + /** + * 获得模板ID + * @param string $tpl_id 公众帐号下模板消息ID + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function delPrivateTemplate($tpl_id) + { + $url = "https://api.weixin.qq.com/cgi-bin/template/del_private_template?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['template_id' => $tpl_id]); + } + + /** + * 发送模板消息 + * @param array $data + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function send(array $data) + { + $url = "https://api.weixin.qq.com/cgi-bin/template/del_private_template?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + +} \ No newline at end of file diff --git a/Wechat/User.php b/Wechat/User.php new file mode 100644 index 0000000..9422a72 --- /dev/null +++ b/Wechat/User.php @@ -0,0 +1,131 @@ +registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['openid' => $openid, 'remark' => $remark]); + } + + /** + * 获取用户基本信息（包括UnionID机制） + * @param string $openid + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getUserInfo($openid) + { + $url = "https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid={$openid}&lang=zh_CN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpGetForJson($url); + } + + /** + * 批量获取用户基本信息 + * @param array $openids + * @param string $lang + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getBatchUserInfo(array $openids, $lang = 'zh_CN') + { + $url = 'https://api.weixin.qq.com/cgi-bin/user/info/batchget?access_token=ACCESS_TOKEN'; + $data = ['user_list' => []]; + foreach ($openids as $openid) { + $data['user_list'][] = ['openid' => $openid, 'lang' => $lang]; + } + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, $data); + } + + /** + * 获取用户列表 + * @param string $next_openid + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getUserList($next_openid = '') + { + $url = "https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid={$next_openid}"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpGetForJson($url); + } + + /** + * 获取公众号的黑名单列表 + * @param string $begin_openid + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function getBlackList($begin_openid = '') + { + $url = "https://api.weixin.qq.com/cgi-bin/tags/members/getblacklist?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['begin_openid' => $begin_openid]); + } + + /** + * 批量拉黑用户 + * @param array $openids + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function batchBlackList(array $openids) + { + $url = "https://api.weixin.qq.com/cgi-bin/tags/members/batchblacklist?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['openid_list' => $openids]); + } + + /** + * 批量取消拉黑用户 + * @param array $openids + * @return array + * @throws Exceptions\InvalidResponseException + * @throws Exceptions\LocalCacheException + */ + public function batchUnblackList(array $openids) + { + $url = "https://api.weixin.qq.com/cgi-bin/tags/members/batchunblacklist?access_token=ACCESS_TOKEN"; + $this->registerApi($url, __FUNCTION__, func_get_args()); + return $this->httpPostForJson($url, ['openid_list' => $openids]); + } + +} \ No newline at end of file