├── .gitignore ├── LICENSE ├── README.md ├── demo └── index.php └── src └── TimeCheer └── Weixin ├── API ├── Base.php ├── BizWIFI │ ├── Bar.php │ ├── Base.php │ ├── ConnectUrl.php │ ├── Device.php │ ├── Homepage.php │ ├── OpenPlugin.php │ ├── Qrcode.php │ ├── Shop.php │ └── Statistics.php ├── MP │ ├── AccessToken.php │ ├── AutoReply.php │ ├── Base.php │ ├── Component.php │ ├── Kefu.php │ ├── Mass.php │ ├── Material.php │ ├── Menu.php │ ├── Message.php │ ├── Poi.php │ ├── TemplateMessage.php │ ├── Ticket.php │ ├── User.php │ ├── UserGroup.php │ └── Wifi.php └── SNS │ └── OAuth2.php ├── Autoloader.php ├── Base.php ├── Open ├── Base.php └── OAuth2.php ├── QY └── OAuth2.php ├── QYAPI ├── AccessToken.php ├── Agent.php ├── Base.php ├── Batch.php ├── Crypt │ ├── ErrorCode.php │ ├── PKCS7Encoder.php │ ├── Prpcrypt.php │ ├── SHA1.php │ ├── WXBizMsgCrypt.php │ └── XMLParse.php ├── Department.php ├── Material.php ├── Media.php ├── Menu.php ├── Message.php ├── Service.php ├── Tag.php └── User.php └── Util └── HTTPClient.php /.gitignore: -------------------------------------------------------------------------------- 1 | nbproject/private/ 2 | build/ 3 | nbbuild/ 4 | dist/ 5 | nbdist/ 6 | nbactions.xml 7 | nb-configuration.xml 8 | .DS_Store 9 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, and 10 | distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by the copyright 13 | owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all other entities 16 | that control, are controlled by, or are under common control with that entity. 17 | For the purposes of this definition, "control" means (i) the power, direct or 18 | indirect, to cause the direction or management of such entity, whether by 19 | contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the 20 | outstanding shares, or (iii) beneficial ownership of such entity. 21 | 22 | "You" (or "Your") shall mean an individual or Legal Entity exercising 23 | permissions granted by this License. 24 | 25 | "Source" form shall mean the preferred form for making modifications, including 26 | but not limited to software source code, documentation source, and configuration 27 | files. 28 | 29 | "Object" form shall mean any form resulting from mechanical transformation or 30 | translation of a Source form, including but not limited to compiled object code, 31 | generated documentation, and conversions to other media types. 32 | 33 | "Work" shall mean the work of authorship, whether in Source or Object form, made 34 | available under the License, as indicated by a copyright notice that is included 35 | in or attached to the work (an example is provided in the Appendix below). 36 | 37 | "Derivative Works" shall mean any work, whether in Source or Object form, that 38 | is based on (or derived from) the Work and for which the editorial revisions, 39 | annotations, elaborations, or other modifications represent, as a whole, an 40 | original work of authorship. For the purposes of this License, Derivative Works 41 | shall not include works that remain separable from, or merely link (or bind by 42 | name) to the interfaces of, the Work and Derivative Works thereof. 43 | 44 | "Contribution" shall mean any work of authorship, including the original version 45 | of the Work and any modifications or additions to that Work or Derivative Works 46 | thereof, that is intentionally submitted to Licensor for inclusion in the Work 47 | by the copyright owner or by an individual or Legal Entity authorized to submit 48 | on behalf of the copyright owner. For the purposes of this definition, 49 | "submitted" means any form of electronic, verbal, or written communication sent 50 | to the Licensor or its representatives, including but not limited to 51 | communication on electronic mailing lists, source code control systems, and 52 | issue tracking systems that are managed by, or on behalf of, the Licensor for 53 | the purpose of discussing and improving the Work, but excluding communication 54 | that is conspicuously marked or otherwise designated in writing by the copyright 55 | owner as "Not a Contribution." 56 | 57 | "Contributor" shall mean Licensor and any individual or Legal Entity on behalf 58 | of whom a Contribution has been received by Licensor and subsequently 59 | incorporated within the Work. 60 | 61 | 2. Grant of Copyright License. 62 | 63 | Subject to the terms and conditions of this License, each Contributor hereby 64 | grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, 65 | irrevocable copyright license to reproduce, prepare Derivative Works of, 66 | publicly display, publicly perform, sublicense, and distribute the Work and such 67 | Derivative Works in Source or Object form. 68 | 69 | 3. Grant of Patent License. 70 | 71 | Subject to the terms and conditions of this License, each Contributor hereby 72 | grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, 73 | irrevocable (except as stated in this section) patent license to make, have 74 | made, use, offer to sell, sell, import, and otherwise transfer the Work, where 75 | such license applies only to those patent claims licensable by such Contributor 76 | that are necessarily infringed by their Contribution(s) alone or by combination 77 | of their Contribution(s) with the Work to which such Contribution(s) was 78 | submitted. If You institute patent litigation against any entity (including a 79 | cross-claim or counterclaim in a lawsuit) alleging that the Work or a 80 | Contribution incorporated within the Work constitutes direct or contributory 81 | patent infringement, then any patent licenses granted to You under this License 82 | for that Work shall terminate as of the date such litigation is filed. 83 | 84 | 4. Redistribution. 85 | 86 | You may reproduce and distribute copies of the Work or Derivative Works thereof 87 | in any medium, with or without modifications, and in Source or Object form, 88 | provided that You meet the following conditions: 89 | 90 | You must give any other recipients of the Work or Derivative Works a copy of 91 | this License; and 92 | You must cause any modified files to carry prominent notices stating that You 93 | changed the files; and 94 | You must retain, in the Source form of any Derivative Works that You distribute, 95 | all copyright, patent, trademark, and attribution notices from the Source form 96 | of the Work, excluding those notices that do not pertain to any part of the 97 | Derivative Works; and 98 | If the Work includes a "NOTICE" text file as part of its distribution, then any 99 | Derivative Works that You distribute must include a readable copy of the 100 | attribution notices contained within such NOTICE file, excluding those notices 101 | that do not pertain to any part of the Derivative Works, in at least one of the 102 | following places: within a NOTICE text file distributed as part of the 103 | Derivative Works; within the Source form or documentation, if provided along 104 | with the Derivative Works; or, within a display generated by the Derivative 105 | Works, if and wherever such third-party notices normally appear. The contents of 106 | the NOTICE file are for informational purposes only and do not modify the 107 | License. You may add Your own attribution notices within Derivative Works that 108 | You distribute, alongside or as an addendum to the NOTICE text from the Work, 109 | provided that such additional attribution notices cannot be construed as 110 | modifying the License. 111 | You may add Your own copyright statement to Your modifications and may provide 112 | additional or different license terms and conditions for use, reproduction, or 113 | distribution of Your modifications, or for any such Derivative Works as a whole, 114 | provided Your use, reproduction, and distribution of the Work otherwise complies 115 | with the conditions stated in this License. 116 | 117 | 5. Submission of Contributions. 118 | 119 | Unless You explicitly state otherwise, any Contribution intentionally submitted 120 | for inclusion in the Work by You to the Licensor shall be under the terms and 121 | conditions of this License, without any additional terms or conditions. 122 | Notwithstanding the above, nothing herein shall supersede or modify the terms of 123 | any separate license agreement you may have executed with Licensor regarding 124 | such Contributions. 125 | 126 | 6. Trademarks. 127 | 128 | This License does not grant permission to use the trade names, trademarks, 129 | service marks, or product names of the Licensor, except as required for 130 | reasonable and customary use in describing the origin of the Work and 131 | reproducing the content of the NOTICE file. 132 | 133 | 7. Disclaimer of Warranty. 134 | 135 | Unless required by applicable law or agreed to in writing, Licensor provides the 136 | Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, 137 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, 138 | including, without limitation, any warranties or conditions of TITLE, 139 | NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are 140 | solely responsible for determining the appropriateness of using or 141 | redistributing the Work and assume any risks associated with Your exercise of 142 | permissions under this License. 143 | 144 | 8. Limitation of Liability. 145 | 146 | In no event and under no legal theory, whether in tort (including negligence), 147 | contract, or otherwise, unless required by applicable law (such as deliberate 148 | and grossly negligent acts) or agreed to in writing, shall any Contributor be 149 | liable to You for damages, including any direct, indirect, special, incidental, 150 | or consequential damages of any character arising as a result of this License or 151 | out of the use or inability to use the Work (including but not limited to 152 | damages for loss of goodwill, work stoppage, computer failure or malfunction, or 153 | any and all other commercial damages or losses), even if such Contributor has 154 | been advised of the possibility of such damages. 155 | 156 | 9. Accepting Warranty or Additional Liability. 157 | 158 | While redistributing the Work or Derivative Works thereof, You may choose to 159 | offer, and charge a fee for, acceptance of support, warranty, indemnity, or 160 | other liability obligations and/or rights consistent with this License. However, 161 | in accepting such obligations, You may act only on Your own behalf and on Your 162 | sole responsibility, not on behalf of any other Contributor, and only if You 163 | agree to indemnify, defend, and hold each Contributor harmless for any liability 164 | incurred by, or claims asserted against, such Contributor by reason of your 165 | accepting any such warranty or additional liability. 166 | 167 | END OF TERMS AND CONDITIONS 168 | 169 | APPENDIX: How to apply the Apache License to your work 170 | 171 | To apply the Apache License to your work, attach the following boilerplate 172 | notice, with the fields enclosed by brackets "{}" replaced with your own 173 | identifying information. (Don't include the brackets!) The text should be 174 | enclosed in the appropriate comment syntax for the file format. We also 175 | recommend that a file or class name and description of purpose be included on 176 | the same "printed page" as the copyright notice for easier identification within 177 | third-party archives. 178 | 179 | Copyright 2015 Jimmy Chaw 180 | 181 | Licensed under the Apache License, Version 2.0 (the "License"); 182 | you may not use this file except in compliance with the License. 183 | You may obtain a copy of the License at 184 | 185 | http://www.apache.org/licenses/LICENSE-2.0 186 | 187 | Unless required by applicable law or agreed to in writing, software 188 | distributed under the License is distributed on an "AS IS" BASIS, 189 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 190 | See the License for the specific language governing permissions and 191 | limitations under the License. 192 | 193 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # WeixinSDK4PHP 2 | 微信公众号SDK封装、PHP版本、目前主要从企业号开始 3 | -------------------------------------------------------------------------------- /demo/index.php: -------------------------------------------------------------------------------- 1 | doPost(self::API_SET, array('shop_id' => (int) $shopId, 'bar_type' => (int) $barType), array(), true); 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/BizWIFI/Base.php: -------------------------------------------------------------------------------- 1 | doPost(self::API_GET, array(), array(), true); 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/BizWIFI/Device.php: -------------------------------------------------------------------------------- 1 | doPost(self::API_ADD, array('shop_id' => (int) $shopId, 'ssid' => $ssid, 'password' => $password), array(), true); 26 | } 27 | 28 | /** 29 | * 查询多个门店或指定门店的设备信息 30 | * @param int $pageIndex 分页下标，默认从1开始 31 | * @param int $pageSize 每页的个数，默认10个，最大20个 32 | * @param int $shopId 门店id 33 | * @return array{ 34 | * "errcode": 0, 35 | * "data": { 36 | * "totalcount": 2, 37 | * "pageindex": 1, 38 | * "pagecount": 1, 39 | * "records": [ 40 | * { 41 | * "shop_id": 429620, 42 | * "ssid": "WX123", 43 | * "bssid": "00:1f:7a:ad:5b:a9", 44 | * "protocol_type":4 45 | * }, 46 | * { 47 | * "shop_id": 429620, 48 | * "ssid": "WX123", 49 | * "bssid": "00:1f:7a:ad:5c:a8", 50 | * "protocol_type":4 51 | * } 52 | * ] 53 | * } 54 | * } 55 | */ 56 | public function query($pageIndex = 1, $pageSize = 10, $shopId) { 57 | $data = array('pageindex' => (int) $pageIndex, 'pagesize' => (int) $pageSize); 58 | if (!empty($shopId)) { 59 | $data['shop_id'] = (int) $shopId; 60 | } 61 | return $this->doPost(self::API_LIST, $data, array(), true); 62 | } 63 | 64 | /** 65 | * 删除设备 66 | * @param string $bssid 需要删除的无线网络设备无线mac地址，格式冒号分隔，字符长度17个，并且字母小写，例如：00:1f:7a:ad:5c:a8 67 | * @return string $errcode = 0 68 | */ 69 | public function delete($bssid) { 70 | return $this->doPost(self::API_DELETE, array('bssid' => $bssid), array(), true); 71 | } 72 | 73 | } 74 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/BizWIFI/Homepage.php: -------------------------------------------------------------------------------- 1 | (int) $shopId, 'template_id' => (int) $templateId); 23 | if ($templateId == 1 && !empty($url)) { 24 | $data['struct']['url'] = $url; 25 | } 26 | return $this->doPost(self::API_SET, $data, array(), true); 27 | } 28 | 29 | /** 30 | * 查询商家主页 31 | * @param int $shopId 查询的门店的id (必填) 32 | * @return array { 33 | * "errcode": 0, 34 | * "data": { 35 | * "shop_id": 429620, 36 | * "template_id": 1, 37 | * "url": " http://wifi.weixin.qq.com/" 38 | * } 39 | * } 40 | */ 41 | public function get($shopId) { 42 | return $this->doPost(self::API_GET, array('shop_id' => (int) $shopId), array(), true); 43 | } 44 | 45 | } 46 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/BizWIFI/OpenPlugin.php: -------------------------------------------------------------------------------- 1 | doPost(self::API_OPEN, array('callback_url' => $callbackUrl), array(), true); 27 | } 28 | 29 | } 30 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/BizWIFI/Qrcode.php: -------------------------------------------------------------------------------- 1 | doPost(self::API_GET, array('shop_id' => (int) $shopId, 'img_id' => (int) $imgId), array(), true); 26 | } 27 | 28 | } 29 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/BizWIFI/Shop.php: -------------------------------------------------------------------------------- 1 | doPost(self::API_LIST, array('pageindex' => (int) $pageIndex, 'pagesize' => (int) $pageSize), array(), true); 47 | } 48 | 49 | /** 50 | * 查询某门店的WiFi信息 51 | * @param int $shopId 门店id 52 | * @return array { 53 | * "errcode": 0, 54 | * "data": { 55 | * "shop_name": "南山店", 56 | * "ssid": "WX4123", 57 | * "password": "123456789", 58 | * "protocol_type": 4, 59 | * "ap_count": 2, 60 | * "template_id": 1, 61 | * "homepage_url": "http://www.weixin.qq.com/", 62 | * "bar_type": 1 63 | * } 64 | * } 65 | */ 66 | public function get($shopId) { 67 | return $this->doPost(self::API_GET, array('shop_id' => (int) $shopId), array(), true); 68 | } 69 | 70 | /** 71 | * 清空门店网络及设备 72 | * @param int $shopId 73 | * @return array{ "errcode": 0} 74 | */ 75 | public function clean($shopId) { 76 | return $this->doPost(self::API_CLEAN, array('shop_id' => (int) $shopId),array(), true); 77 | } 78 | } 79 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/BizWIFI/Statistics.php: -------------------------------------------------------------------------------- 1 | $beginDate, 'end_date' => $endDate, 'shop_id' => $shopId); 47 | return $this->doPost(self::API_LIST, $data, array(), true); 48 | } 49 | } 50 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/MP/AccessToken.php: -------------------------------------------------------------------------------- 1 | '成功', //(no error) 19 | '61451' => '参数错误', //(invalid parameter) 20 | '61452' => '无效客服账号', //(invalid kf_account) 21 | '61453' => '账号已存在', //(kf_account exsited) 22 | '61454' => '账号名长度超过限制(前缀10个英文字符)', //(invalid kf_acount length) 23 | '61455' => '账号名包含非法字符(英文+数字)', //(illegal character in kf_account) 24 | '61456' => '账号个数超过限制(100个客服账号)', //(kf_account count exceeded) 25 | '61457' => '无效头像文件类型', //(invalid file type) 26 | ); 27 | 28 | /** 29 | * 添加客户帐号 30 | * 31 | * @param string $kf_acount 完整客服账号，格式为：账号前缀@公众号微信号 32 | * @param string $nickname 客服昵称，最长6个汉字或12个英文字符 33 | * @param string $password 客服账号登录密码，格式为密码明文的32位加密MD5值 34 | * @return boolean 35 | */ 36 | public function add($kf_acount, $nickname, $password) { 37 | $params = array( 38 | 'kf_account' => $kf_acount, 39 | 'nickname' => $nickname, 40 | 'password' => $password, 41 | ); 42 | $res = $this->doPost(self::API_ADD, $params); 43 | 44 | if (isset($res['errcode']) && $res['errcode'] === 0) { 45 | return true; 46 | } 47 | 48 | return false; 49 | } 50 | 51 | /** 52 | * 设置客户信息 53 | * 54 | * @param string $kf_acount 完整客服账号，格式为：账号前缀@公众号微信号 55 | * @param string $nickname 客服昵称，最长6个汉字或12个英文字符 56 | * @param string $password 客服账号登录密码，格式为密码明文的32位加密MD5值 57 | * @return boolean 58 | */ 59 | public function update($kf_acount, $nickname, $password) { 60 | $params = array( 61 | 'kf_account' => $kf_acount, 62 | 'nickname' => $nickname, 63 | 'password' => $password, 64 | ); 65 | $res = $this->doPost(self::API_UPDATE, $params); 66 | 67 | if (isset($res['errcode']) && $res['errcode'] === 0) { 68 | return true; 69 | } 70 | 71 | return false; 72 | } 73 | 74 | /** 75 | * 给客服帐号上传头像 76 | * 77 | * @param string $media 头像图片 78 | * @param string $kf_account 完整客服账号，格式为：账号前缀@公众号微信号 79 | * @return boolean 80 | */ 81 | public function uploadHeadImg($media, $kf_account) { 82 | $params = array( 83 | 'media' => '@' . $media, 84 | ); 85 | $res = $this->doPost(self::API_UPDATE, $params, array('kf_account' => $kf_account)); 86 | 87 | if (isset($res['errcode']) && $res['errcode'] === 0) { 88 | return true; 89 | } 90 | 91 | return false; 92 | } 93 | 94 | /** 95 | * 删除客户帐号 96 | */ 97 | public function delete($kf_account) { 98 | 99 | $res = $this->doGet(self::API_DELETE, array('kf_account' => $kf_account)); 100 | 101 | if (isset($res['errcode']) && $res['errcode'] === 0) { 102 | return true; 103 | } 104 | 105 | return false; 106 | } 107 | 108 | /** 109 | * 获取客服基本信息 110 | * 111 | * @return boolean|array array(array('kf_account'=>'***', 'kf_headimgurl'=>'***', 'kf_id'=>'1001', 'kf_nick'=>'***'),...) 112 | */ 113 | public function getKFList() { 114 | 115 | $res = $this->doGet(self::API_LIST); 116 | 117 | if (!isset($res['kf_list'])) { 118 | return false; 119 | } 120 | 121 | return $res['kf_list']; 122 | } 123 | 124 | /** 125 | * 获取在线客户接待状态 126 | * 127 | * @return boolean|array array(array('kf_account'=>'***', 'status'=>1, 'kf_id'=>'1001', 'auto_accept'=>0, 'accepted_case'=>1),...) 128 | */ 129 | public function getOnlineKFList() { 130 | 131 | $res = $this->doGet(self::API_LIST_ONLINE); 132 | 133 | if (!isset($res['kf_online_list'])) { 134 | return false; 135 | } 136 | 137 | return $res['kf_online_list']; 138 | } 139 | } -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/MP/Mass.php: -------------------------------------------------------------------------------- 1 | $msg_id, 25 | ); 26 | $res = $this->doPost(self::API_GET, $params); 27 | 28 | return !empty($res['msg_status']) ? $res['msg_status'] : false; 29 | } 30 | 31 | /** 32 | * 发送消息 33 | * 34 | * @param string|array $data 35 | * @param boolean $is_all send/sendall 36 | * @return boolean 37 | */ 38 | public function send($data, $is_all = false) { 39 | if (is_array($data)) { 40 | $data = json_encode($data); 41 | } else if (!json_decode($data)) { 42 | return false; 43 | } 44 | $res = $this->httpRequest($is_all ? self::API_SEND_ALL : self::API_SEND, $data); 45 | 46 | if (isset($res['errcode']) && $res['errcode'] == 0) { 47 | return $res; 48 | } 49 | 50 | return false; 51 | } 52 | 53 | /** 54 | * 删除群发 55 | * 
 56 |      * 1、只有已经发送成功的消息才能删除
 57 |      * 2、删除消息是将消息的图文详情页失效，已经收到的用户，还是能在其本地看到消息卡片。
 58 |      * 3、删除群发消息只能删除图文消息和视频消息，其他类型的消息一经发送，无法删除。
 59 |      * 4、如果多次群发发送的是一个图文消息，那么删除其中一次群发，就会删除掉这个图文消息也，导致所有群发都失效
 60 |      *
61 | * @param int $msg_id 发送出去的消息ID 62 | * @return boolean 63 | */ 64 | public function delete($msg_id) { 65 | $params = array( 66 | 'msg_id' => $msg_id, 67 | ); 68 | $res = $this->httpRequest($this->url . 'mass/delete?' . http_build_query($this->getParams()), $params, 'post'); 69 | 70 | if (isset($res['errcode']) && $res['errcode'] == 0) { 71 | return true; 72 | } 73 | 74 | return false; 75 | } 76 | 77 | /** 78 | * 根据分组进行群发【订阅号与服务号认证后均可用】 79 | * 80 | * @param string $media_id 81 | * @param string $msgtype 'mpnews', 'text', 'image', 'voice', 'mpvideo','wxcard' 82 | * @param boolean $is_to_all 83 | * @param int $group_id 84 | * @return false|array 85 | */ 86 | public function sendByGroup($media_id, $msgtype = 'mpnews', $is_to_all = TRUE, $group_id = 0) { 87 | $params = array( 88 | 'filter' => array('is_to_all' => ($is_to_all ? true : false)), 89 | $msgtype => array('media_id' => $media_id), 90 | 'msgtype' => $msgtype 91 | ); 92 | if (!$is_to_all) { 93 | if (!is_numeric($group_id) || $group_id < 0) { 94 | return false; 95 | } 96 | $params['filter']['group_id'] = $group_id; 97 | } 98 | 99 | $res = $this->httpRequest($this->url . 'mass/sendall?' . http_build_query($this->getParams()), $params, 'post'); 100 | 101 | if (isset($res['errcode']) && $res['errcode'] == 0) { 102 | return $res; 103 | } 104 | 105 | return false; 106 | } 107 | 108 | /** 109 | * 根据OpenID列表群发【订阅号不可用，服务号认证后可用】 110 | * 111 | * @param string|array $media 112 | * @param string $msgtype 'news', 'mpnews', 'text', 'image', 'voice', 'video','wxcard' 113 | * @param array|string $openids 114 | * @return false|array 115 | */ 116 | public function sendByOpenid($media, $msgtype = 'mpnews', $openids = null) { 117 | if (empty($openids)) { 118 | return false; 119 | } 120 | if (!is_array($openids)) { 121 | $openids = explode(',', $openids); 122 | } else { 123 | $openids = array_values($openids); 124 | } 125 | 126 | $params = array( 127 | 'touser' => $openids, 128 | 'msgtype' => $msgtype, 129 | $msgtype => array('media_id' => $media) 130 | ); 131 | switch ($msgtype) { 132 | case 'wxcard': 133 | $params[$msgtype] = array('card_id' => $media); 134 | break; 135 | case 'text': 136 | $params[$msgtype] = array('content' => $media); 137 | break; 138 | case 'video': 139 | $params[$msgtype]['title'] = $media['title']; 140 | $params[$msgtype]['description'] = $media['description']; 141 | break; 142 | default: 143 | break; 144 | } 145 | 146 | $res = $this->httpRequest($this->url . 'mass/send?' . http_build_query($this->getParams()), $params, 'post'); 147 | 148 | if (isset($res['errcode']) && $res['errcode'] == 0) { 149 | return $res; 150 | } 151 | 152 | return false; 153 | } 154 | 155 | } 156 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/MP/Material.php: -------------------------------------------------------------------------------- 1 | doPost(self::API_GET, array('media_id' => $mediaId), array(), true); 38 | } 39 | 40 | /** 41 | * 新增除图文素材外的其他类型永久素材 42 | * @param array $media 43 | * @param string $type 44 | * @param array $videoDescription 视频素材需要POST另一个表单 45 | * @return array array('media_id' => '', 'url' => '视频素材返回url') 46 | */ 47 | public function add($media, $type = self::TYPE_IMAGE, $videoDescription = array()) { 48 | if (!file_exists($media)) { 49 | $this->setError('文件路径不正确'); 50 | 51 | return false; 52 | } 53 | 54 | // 兼容php5.3-5.6 curl模块的上传操作 55 | if (version_compare(PHP_VERSION, '5.3.0') >= 0 && class_exists('CURLFile')) { 56 | $data = array('media' => new \CURLFile(realpath($media))); 57 | } else { 58 | $data = array('media' => '@' . realpath($media)); 59 | } 60 | $data['type'] = $type; 61 | if ($type == self::TYPE_VEDIO) { 62 | $data['description'] = json_encode($videoDescription); 63 | } 64 | 65 | return $this->doPost(self::API_ADD, $data); 66 | } 67 | 68 | /** 69 | * 添加图文素材 70 | * 永久素材的数量是有上限的，请谨慎新增。图文消息素材和图片素材的上限为5000，其他类型为1000 71 | * 素材的格式大小等要求与公众平台官网一致。 72 | * 具体是，图片大小不超过2M，支持bmp/png/jpeg/jpg/gif格式， 73 | * 语音大小不超过5M，长度不超过60秒，支持mp3/wma/wav/amr格式 74 | * 75 | * 在图文消息的具体内容中，将过滤外部的图片链接， 76 | * 开发者可以通过$this->uploadNewsImage接口上传图片得到URL，放到图文内容中使用 77 | * @param array $articles 多图文列表 78 | * @return string media_id 79 | */ 80 | public function addNews($articles) { 81 | return $this->doPost(self::API_ADD_NEWS, array('articles' => $articles)); 82 | } 83 | 84 | /** 85 | * 上传图文消息内的图片 86 | * 订阅号与服务号认证后均可用 87 | * @param array $media 88 | * @return string 返回图片在微信服务器的url 89 | */ 90 | public function uploadNewsImage($media) { 91 | if (!file_exists($media)) { 92 | $this->setError('文件路径不正确'); 93 | 94 | return false; 95 | } 96 | 97 | // 兼容php5.3-5.6 curl模块的上传操作 98 | if (version_compare(PHP_VERSION, '5.5.0') >= 0 && class_exists('CURLFile')) { 99 | $data = array('media' => new \CURLFile(realpath($media))); 100 | } else { 101 | $data = array('media' => '@' . realpath($media)); 102 | } 103 | 104 | return $this->doPost(self::API_UPLOAD_NEWS_IMG, $data); 105 | } 106 | 107 | /** 108 | * 删除不再需要的永久素材 109 | * @param string $mediaId 110 | * @return bool 111 | */ 112 | public function del($mediaId) { 113 | return $this->doPost(self::API_DELETE, array('media_id' => $mediaId)); 114 | } 115 | 116 | /** 117 | * 对永久图文素材进行修改 一次修改多图文中的一篇 118 | * @param string $mediaId 119 | * @param array $article 120 | * @param int $index 要更新的文章在图文消息中的位置 多图文消息时，此字段才有意义）第一篇为0 121 | * @return bool 122 | */ 123 | public function updateNews($mediaId, $article, $index = 0) { 124 | return $this->doPost(self::API_UPDATE_NEWS, array('media_id' => $mediaId, 'index' => $index, 'articles' => $article)); 125 | } 126 | 127 | /** 128 | * 获取素材总数 129 | * @return array { 130 | * "voice_count":COUNT, 131 | * "video_count":COUNT, 132 | * "image_count":COUNT, 133 | * "news_count":COUNT 134 | * } 135 | */ 136 | public function getCount() { 137 | return $this->doGet(self::API_COUNT); 138 | } 139 | 140 | /** 141 | * 分类型获取永久素材的列表 142 | * @param string $type 图片（image）、视频（video）、语音 （voice）、图文（news） 143 | * @param int $offset 0表示从第一个素材 返回 144 | * @param int $count 返回素材的数量，取值在1到20之间 145 | * @return array 146 | */ 147 | public function getAll($type = self::TYPE_IMAGE, $offset = 0, $count = 20) { 148 | return $this->doPost(self::API_LIST, array('type' => $type, 'offset' => $offset, 'count' => $count)); 149 | } 150 | 151 | /** 152 | * 上传临时素材 153 | * @param array $media 154 | * @param string $type 图片（image）、语音（voice）、视频（video）和缩略图（thumb） 155 | */ 156 | public function uploadTmp($media, $type = self::TYPE_IMAGE) { 157 | if (!file_exists($media)) { 158 | $this->setError('文件路径不正确'); 159 | 160 | return false; 161 | } 162 | 163 | // 兼容php5.5以上 curl模块的上传操作 164 | if (version_compare(PHP_VERSION, '5.3.0') >= 0 && class_exists('CURLFile')) { 165 | $data = array('media' => new \CURLFile(realpath($media))); 166 | } else { 167 | $data = array('media' => '@' . realpath($media)); 168 | } 169 | $data['type'] = $type; 170 | 171 | return $this->doPost(self::API_UPLOAD_TMP, $data); 172 | } 173 | 174 | /** 175 | * 临时素材下载。请注意，由于视频文件不支持https下载,该方法暂不能下载视频 176 | * @param string $mediaId 177 | * @return mixed 178 | */ 179 | public function downloadTmp($mediaId) { 180 | return $this->doGet(self::API_DOWNLOAD_TMP, array('media_id' => $mediaId)); 181 | } 182 | 183 | /** 184 | * 用于群发 上传图文消息素材【订阅号与服务号认证后均可用】 185 | * @link http://mp.weixin.qq.com/wiki/14/0c53fac3bdec3906aaa36987b91d64ea.html#.E4.B8.8A.E4.BC.A0.E5.9B.BE.E6.96.87.E6.B6.88.E6.81.AF.E7.B4.A0.E6.9D.90.E3.80.90.E8.AE.A2.E9.98.85.E5.8F.B7.E4.B8.8E.E6.9C.8D.E5.8A.A1.E5.8F.B7.E8.AE.A4.E8.AF.81.E5.90.8E.E5.9D.87.E5.8F.AF.E7.94.A8.E3.80.91 186 | * @param array $articles 187 | */ 188 | public function uploadNews($articles) { 189 | return $this->doPost(self::API_UPLOAD_NEWS, array('articles' => $articles)); 190 | } 191 | } -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/MP/Menu.php: -------------------------------------------------------------------------------- 1 | 19 | 按钮结构: 20 | {"type":"***","name":"***","key":"***"} 21 | {"type":"view","name":"***","url":"***"} 22 | {"type":"media_id/view_limited","name":"***","media_id":"***"} 23 | {"name":"***","sub_button":[{},{},...]} 24 | 25 | * @param array $data 26 | * @return boolean 27 | */ 28 | public function create($data) { 29 | $params = array( 30 | 'button' => $data, 31 | ); 32 | $res = $this->doPost(self::API_CREATE, $params); 33 | 34 | if (isset($res['errcode']) && $res['errcode'] === 0) { 35 | return true; 36 | } 37 | 38 | return false; 39 | } 40 | 41 | /** 42 | * 删除当前使用的自定义菜单 43 | * 44 | * @return boolean 45 | */ 46 | public function delete() { 47 | 48 | return $this->doGet(self::API_DELETE); 49 | } 50 | 51 | /** 52 | * 获取(API调用设置的)自定义菜单结构 53 | * 54 | * @return boolean|array 55 | */ 56 | public function getList() { 57 | 58 | $res = $this->doGet(self::API_GET); 59 | 60 | if (!isset($res['menu']['button'])) { 61 | return false; 62 | } 63 | 64 | return $res['menu']['button']; 65 | } 66 | 67 | /** 68 | * 公众号当前使用的自定义菜单的配置 69 | * 70 | * @return boolean|array 71 | */ 72 | public function getCurrentList() { 73 | $res = $this->doGet(self::API_GET_CURRENT); 74 | 75 | if (!isset($res['selfmenu_info']['button'])) { 76 | return false; 77 | } 78 | 79 | return $res['selfmenu_info']['button']; 80 | } 81 | 82 | } 83 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/MP/Message.php: -------------------------------------------------------------------------------- 1 | $openids, 54 | 'msgtype' => $msgtype 55 | ); 56 | switch ($msgtype) { 57 | case 'wxcard': 58 | $params[$msgtype] = array('card_id' => $media); 59 | break; 60 | case 'text': 61 | $params[$msgtype] = array('content' => $media); 62 | break; 63 | case 'video': 64 | $params[$msgtype]['title'] = $media['title']; 65 | $params[$msgtype]['description'] = $media['description']; 66 | break; 67 | case 'news': 68 | $params[$msgtype]['articles'] = $media; 69 | break; 70 | default: 71 | break; 72 | } 73 | 74 | $res = $this->httpRequest($this->url . 'custom/send?' . http_build_query($this->getParams()), $params, 'post'); 75 | //\Think\Log::write($res, \Think\Log::DEBUG, null); 76 | 77 | if (isset($res['errcode']) && $res['errcode'] == 0) { 78 | return $res; 79 | } 80 | 81 | return false; 82 | } 83 | 84 | /** 85 | * 发送消息给指定用户，在手机端预览消息的样式和排版 86 | * 87 | * @param string|array $media 88 | * @param string $msgtype 'mpnews', 'text', 'image', 'voice', 'mpvideo','wxcard' 89 | * @param string $openid 90 | * @param string $send_type openid/wechatname 91 | * @return boolean|array 92 | */ 93 | public function preview($media, $msgtype, $openid, $send_type = 'openid') { 94 | $params = array( 95 | ($send_type == 'openid' ? 'touser' : 'towxname') => $openid, 96 | 'msgtype' => $msgtype, 97 | $msgtype => array('media_id' => $media) 98 | ); 99 | switch ($msgtype) { 100 | case 'wxcard': 101 | $params[$msgtype] = array('card_id' => $media['card_id'], 'card_ext' => $media['card_ext']); 102 | break; 103 | case 'text': 104 | $params[$msgtype] = array('content' => $media); 105 | break; 106 | default: 107 | break; 108 | } 109 | $res = $this->httpRequest($this->url . 'mass/delete?' . http_build_query($this->getParams()), $params, 'post'); 110 | 111 | if (isset($res['errcode']) && $res['errcode'] == 0) { 112 | return $res; 113 | } 114 | 115 | return false; 116 | } 117 | } 118 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/MP/Poi.php: -------------------------------------------------------------------------------- 1 | doPost(self::API_UPLOAD_IMAGE); 26 | } 27 | 28 | /** 29 | * 创建门店 30 | * @param array $information 门店的信息 31 | * @return array { 32 | * "errcode":0, 33 | * "errmsg":"ok" 34 | * } 35 | */ 36 | public function add($information) { 37 | return $this->doPost(self::API_ADD, $information, array(), true); 38 | } 39 | 40 | /** 41 | * 查询门店详细信息 42 | * @param int $poiId 门店id 43 | * @return araay { 44 | * "errcode":0, 45 | * "errmsg":"ok", 46 | * "business ":{ 47 | * "base_info":{ 48 | * "sid":"001", 49 | * "business_name":"麦当劳", 50 | * "branch_name":"艺苑路店", 51 | * "province":"广东省", 52 | * "city":"广州市", 53 | * "address":"海珠区艺苑路11 号", 54 | * "telephone":"020-12345678", 55 | * "categories":["美食,小吃快餐"], 56 | * "offset_type":1, 57 | * "longitude":115.32375, 58 | * "latitude":25.097486, 59 | * "photo_list":[{"photo_url":"https:// XXX.com"} ， {"photo_url":"https://XXX.com"}], 60 | * "recommend":"麦辣鸡腿堡套餐，麦乐鸡，全家桶", 61 | * "special":"免费wifi，外卖服务", 62 | * "introduction":"麦当劳是全球大型跨国连锁餐厅，1940 年创立于美国，在世界上大", 63 | * "open_time":"8:00-20:00", 64 | * "avg_price":35 65 | * "available_state":3 66 | * "update_status":0 67 | * } 68 | * } 69 | * } 70 | */ 71 | public function get($poiId) { 72 | return $this->doPost(self::API_GET, array('poi_id' => $poiId), array(), true); 73 | } 74 | 75 | /** 76 | * 查询门店列表 77 | * $param int $begin 开始位置，0 即为从第一条开始查询 (必填) 78 | * @param int $limit 返回数据条数，最大允许50，默认为20 (必填) 79 | * @return array{ 80 | * "errcode": 81 | * "errmsg": 82 | * "business_list":[ 83 | * {"base_info":{ 84 | * "sid":"101", 85 | * "business_name":"麦当劳", 86 | * "branch_name":"艺苑路店", 87 | * "address":"艺苑路11号", 88 | * "telephone":"020-12345678", 89 | * "categories":["美食,快餐小吃"], 90 | * "city":"广州市", 91 | * "province":"广东省", 92 | * "offset_type":1, 93 | * "longitude":115.32375, 94 | * "latitude":25.097486, 95 | * "photo_list":[{"photo_url":"http: ...."}], 96 | * "introduction":"麦当劳是全球大型跨国连锁餐厅，1940 年创立于美国", 97 | * "recommend":"麦辣鸡腿堡套餐，麦乐鸡，全家桶", 98 | * "special":"免费wifi，外卖服务", 99 | * "open_time":"8:00-20:00", 100 | * "avg_price":35, 101 | * "poi_id":"285633617", 102 | * "available_state":3, 103 | * "district":"海珠区", 104 | * "update_status":0 105 | * }},...... 106 | * ] 107 | * "total_count":"3", 108 | * } 109 | */ 110 | public function query($begin, $limit = 20) { 111 | return $this->doPost(self::API_LIST, array('begin' => $begin, 'limit' => $limit), array(), true); 112 | } 113 | 114 | /** 115 | * 修改门店服务信息 116 | * @param int $poiId 门店id 117 | * @param array $details 门店修改信息 118 | * @return array{ 119 | * "errcode":0, 120 | * "errmsg":"ok" 121 | * } 122 | */ 123 | public function update($poiId, $details) { 124 | return $this->doPost(self::API_UPDATE, array('poi_id' => $poiId, 'details' => $details)); 125 | } 126 | 127 | /** 128 | * 删除门店 129 | * @param int $poiId 门店id 130 | * @return array{ 131 | * "errcode":0, 132 | * "errmsg":"ok" 133 | * } 134 | */ 135 | public function delete($poiId) { 136 | return $this->doPost(self::API_DELETE, array('poi_id' => $poiId)); 137 | } 138 | 139 | /** 140 | * 门店类目标 141 | * @return string $categofy_list 142 | */ 143 | public function category() { 144 | return $this->doGet(self::API_CATEGORY); 145 | } 146 | 147 | } 148 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/MP/TemplateMessage.php: -------------------------------------------------------------------------------- 1 | doGet(self::API_LIST, $data); 32 | } 33 | 34 | /** 35 | * 通过OpenID来获取用户基本信息 36 | * @link http://mp.weixin.qq.com/wiki/17/c807ee0f10ce36226637cebf428a0f6d.html 37 | * @param string $openId 38 | * @return array 39 | */ 40 | public function getInfo($openId) { 41 | return $this->doGet(self::API_INFO, array('openid' => $openId)); 42 | } 43 | 44 | /** 45 | * 通过多个OpenID批量获取用户基本信息 46 | * @link http://mp.weixin.qq.com/wiki/17/c807ee0f10ce36226637cebf428a0f6d.html 47 | * @param array $openIds 48 | */ 49 | public function getAllInfo($openIds) { 50 | $data = array(); 51 | foreach ($openIds as $openid) { 52 | $data[] = array('openid' => $openid, 'lang' => 'zh-CN'); 53 | } 54 | 55 | return $this->doPost(self::API_INFOS, array('user_list' => $data)); 56 | } 57 | 58 | /** 59 | * 设置备注名 该接口暂时开放给微信认证的服务号 60 | * @param string $openId 61 | * @param string $remark 62 | * @return bool 63 | */ 64 | public function updateRemark($openId, $remark) { 65 | return $this->doPost(self::API_UPDATE_REMARK, array( 66 | 'openid' => $openId, 67 | 'remark' => $remark 68 | )); 69 | } 70 | } -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/MP/UserGroup.php: -------------------------------------------------------------------------------- 1 | array( 29 | 'name' => $name, 30 | ), 31 | ); 32 | 33 | return $this->doPost(self::API_CREATE, $data); 34 | } 35 | 36 | /** 37 | * 查询所有分组 38 | * @return array 39 | */ 40 | public function getAll() { 41 | return $this->doGet(self::API_LIST); 42 | } 43 | 44 | /** 45 | * 查询用户所在分组 46 | * @param string $openId 47 | * @return int group id 48 | */ 49 | public function getIdByOpenId($openId) { 50 | return $this->doPost(self::API_GETID, array('openid' => $openId)); 51 | } 52 | 53 | /** 54 | * 修改分组名 55 | * @param int $id 56 | * @param array $name 57 | * @return bool 58 | */ 59 | public function update($id, $name) { 60 | return $this->doPost(self::API_UPDATE, array( 61 | 'group' => array('id' => $id, 'name' => $name) 62 | )); 63 | } 64 | 65 | /** 66 | * 移动用户分组 67 | * @param int $toGroupId 分组id 68 | * @param string $openId 69 | * @return bool 70 | */ 71 | public function moveUser($toGroupId, $openId) { 72 | return $this->doPost(self::API_MOVE_USER, array( 73 | 'openid' => $openId, 74 | 'to_groupid' => $toGroupId 75 | )); 76 | } 77 | 78 | /** 79 | * 批量移动用户分组 80 | * @param int $toGroupId 81 | * @param array $openIds 82 | * @return bool 83 | */ 84 | public function moveUsers($toGroupId, $openIds) { 85 | return $this->doPost(self::API_MOVE_USERS, array( 86 | 'openid_list' => $openIds, 87 | 'to_groupid' => $toGroupId 88 | )); 89 | } 90 | 91 | /** 92 | * 删除分组 93 | * @param int $id 94 | * @return bool 95 | */ 96 | public function delete($id) { 97 | return $this->doPost(self::API_DELETE, array( 98 | 'group' => array('id' => $id) 99 | )); 100 | } 101 | } -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/MP/Wifi.php: -------------------------------------------------------------------------------- 1 | doPost(self::WIFI_OPEN,array('callback_url'=>$callback_url),array(),true); 33 | } 34 | 35 | /** 36 | * 获取WiFi门店列表 37 | * 微信连WiFi下的所有接口中的shop_id，必需先通过此接口获取。 38 | * @param int $pageindex 分页下标，默认从1开始 39 | * @param int $pagesize 每页的个数，默认10个，最大20个 40 | */ 41 | public function shopList($pageindex,$pagesize){ 42 | return $this->doPost(self::WIFI_SHOP_LIST,array('pageindex'=>$pageindex,'pagesize'=>$pagesize),array(),true); 43 | } 44 | 45 | /** 46 | * 查询门店的WiFi信息 47 | * @param int $shop_id 门店id 48 | */ 49 | public function shopDetails($shop_id){ 50 | return $this->doPost(self::WIFI_SHOP_DETAILS,array('shop_id'=>$shop_id),array(),true); 51 | } 52 | 53 | /** 54 | * 添加密码型设备 55 | * 本接口只支持添加密码型设备。 56 | * 多台设备必须使用相同的 ssid 和 密码 57 | * @param int $shop_id 门店id （必填） 58 | * @param int $ssid 设备id （必填） 59 | * @param string $password 设备密码 （必填） 60 | */ 61 | public function deviceAdd($shop_id,$ssid,$password){ 62 | return $this->doPost(self::WIFI_DEVICE_ADD,array('shop_id'=>$shop_id,'ssid'=>$ssid,'password'=>$password),array(),true); 63 | } 64 | 65 | /** 66 | * 查询多个门店或指定门店的设备信息 67 | * @param int $pageindex 分页下标，默认从1开始 68 | * @param int $pagesize 每页的个数，默认10个，最大20个 69 | * @param int $shop_id 门店id 70 | */ 71 | public function deviceList($pageindex,$pagesize,$shop_id){ 72 | return $this->doPost(self::WIFI_DEVICE_LIST,array('pageindex'=>$pageindex,'pagesize'=>$pagesize,'shop_id'=>$shop_id),array(),true); 73 | } 74 | 75 | /** 76 | * 删除设备 77 | * @param string $bssid 需要删除的无线网络设备无线mac地址，格式冒号分隔，字符长度17个，并且字母小写，例如：00:1f:7a:ad:5c:a8 78 | * @return 79 | */ 80 | public function deviceDelete($bssid){ 81 | return $this->doPost(self::WIFI_DEVICE_DELETE,array('bssid'=>$bssid),array(),true); 82 | } 83 | /** 84 | * 获取物料二维码 85 | * @param int $shop_id 门店id (必填） 86 | * @param int 3img_id 二维码样式编号 0-纯二维码 1-二维码物料 (必填） 87 | * @return url 二维码图片url 88 | */ 89 | public function qrcodeGet($shop_id,$img_id){ 90 | return $this->doPost(self::WIFI_QRCODE_GET,array('shop_id'=>$shop_id,'img_id'=>$img_id),array(),true); 91 | } 92 | 93 | /** 94 | * 获取公众号连网URL 95 | * @return connect_url 96 | */ 97 | public function connectUrl(){ 98 | return $this->doPost(self::WIFI_CONNECTURL_GET,array(),array(),true); 99 | } 100 | 101 | /** 102 | * 设置商家主页 103 | * @param int $shop_id 门店id (必填) 104 | * @param int $template_id 模板id 0-默认模板 1-自定义url (必填) 105 | * @param $struct 模板结构，当template_id为0时可以不填 106 | * @param $url 自定义链接，当template_id为1时必填 107 | */ 108 | public function setHomepage($shop_id,$template_id=0,$struct,$url){ 109 | if($template_id ==1){ 110 | 111 | } 112 | return $this->doPost(self::WIFI_HOMEPAGE_SET,array('shop_id'=>$shop_id,'template_id'=>$template_id),array(),true); 113 | } 114 | 115 | /** 116 | * 查询商家主页 117 | * @param int $shop_id 查询的门店的id (必填) 118 | * @return shop_id template_id url 119 | */ 120 | public function getHomepage($shop_id){ 121 | return $this->doPost(self::WIFI_HOMEPAGE_GET,array('shop_id'=>$shop_id),array(),true); 122 | } 123 | 124 | /** 125 | * 设置顶部常驻入口文案 126 | * @param int $shop_id 门店id 127 | * @param int $bar_type 顶部常驻入口上显示的文本内容：0--欢迎光临+公众号名称；1--欢迎光临+门店名称；2--已连接+公众号名称+WiFi；3--已连接+门店名称+Wi-Fi 128 | */ 129 | public function setText($shop_id,$bar_type=0){ 130 | return $this->doPost(self::WIFI_BAR_SET,array($shop_id,$bar_type),array(),true); 131 | } 132 | 133 | /** 134 | * 数据统计 135 | * @param time $begin_date 起始日期时间，格式yyyy-mm-dd，最长时间跨度为30天 136 | * @param time $end_date 结束日期时间戳，格式yyyy-mm-dd，最长时间跨度为30天 137 | * @param int $shop_id 按门店ID搜索，-1为总统计 138 | */ 139 | public function statistics($begin_date,$end_date,$shop_id){ 140 | return $this->doPost(self::WIFI_STATISTICS,array('begin_date'=>$begin_date,'end_date'=>$end_date,'shop_id'=>$shop_id),array(),true); 141 | } 142 | 143 | /** 144 | * 145 | */ 146 | } -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/API/SNS/OAuth2.php: -------------------------------------------------------------------------------- 1 | doGet(self::API_TOKEN, array( 26 | 'appid' => $appId, 27 | 'secret' => $appSecret, 28 | 'grant_type' => 'authorization_code', 29 | 'code' => $code 30 | )); 31 | } 32 | 33 | /** 34 | * 刷新access_token 35 | * @param string $appId 36 | * @param string $refreshToken 37 | * @return array 38 | */ 39 | public function refreshAccessToken($appId, $refreshToken) { 40 | return $this->doGet(self::API_REFRESH_TOKEN, array( 41 | 'appid' => $appId, 42 | 'grant_type' => 'refresh_token', 43 | 'refresh_token' => $refreshToken 44 | )); 45 | } 46 | 47 | /** 48 | * 拉取用户信息(需scope为 snsapi_userinfo) 49 | * @param string $accessToken 50 | * @param string $openId 51 | * @return array 52 | */ 53 | public function getUser($accessToken, $openId) { 54 | return $this->doGet(self::API_USER, array( 55 | 'access_token' => $accessToken, 56 | 'openid' => $openId, 57 | 'lang' => 'zh_CN' 58 | )); 59 | } 60 | } -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/Autoloader.php: -------------------------------------------------------------------------------- 1 | _dir = $dir; 24 | } 25 | 26 | /** 27 | * 向PHP注册SPL autoloader 28 | * @param string $dir 指定加载目录 29 | * @return void 30 | */ 31 | public static function register($dir = null) { 32 | ini_set('unserialize_callback_func', 'spl_autoload_call'); 33 | 34 | spl_autoload_register(array(new self($dir), 'autoload'), FALSE, TRUE); 35 | } 36 | 37 | /** 38 | * 系统自动注册 39 | * 40 | * @param string $class 类名 41 | * 42 | * @return boolean 正常加载返回true 43 | */ 44 | public function autoload($class) { 45 | if (0 !== strpos($class, self::PREFIX)) { 46 | return false; 47 | } 48 | 49 | if (file_exists($file = $this->_dir . '/' . str_replace('\\', '/', $class) . '.php')) { 50 | require_once $file; 51 | 52 | return true; 53 | } 54 | 55 | return false; 56 | } 57 | 58 | } 59 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/Base.php: -------------------------------------------------------------------------------- 1 | init($accessToken); 27 | } 28 | } 29 | 30 | /** 31 | * 配置参数 32 | * 33 | * @param string $accessToken 访问接口的$accessToken 34 | */ 35 | public function init($accessToken) { 36 | $this->accessToken = $accessToken; 37 | } 38 | 39 | /** 40 | * 接口请求方法，具体接口都调用此方法进行请求 41 | * @param strin $api 42 | * @param array $params 43 | * @return string 44 | */ 45 | public function doGet($api, array $params = array()) { 46 | $res = HTTPClient::get($this->apiPrefix . $api, array_merge( 47 | $params, 48 | array('access_token' => $this->accessToken) 49 | )); 50 | 51 | if (false === $res) { 52 | $this->setError(-10, HTTPClient::getErrorMsg()); 53 | return false; 54 | } 55 | 56 | return $res; 57 | } 58 | 59 | /** 60 | * 接口请求方法，具体接口都调用此方法进行请求 61 | * @param strin $api 62 | * @param array $data post的数据 63 | * @param array $params url中构造的参数 64 | * @param bool $dataJsonEncoded post发出数据的格式是否需要json编码 默认为false表示常规,true json 65 | * @return string 66 | */ 67 | public function doPost($api, array $data = array(), array $params = array(), $dataJsonEncoded = false) { 68 | $url = $this->apiPrefix . $api . '?' . http_build_query(array_merge( 69 | $params, 70 | array('access_token' => $this->accessToken) 71 | )); 72 | 73 | $res = HTTPClient::post($url, $data, $dataJsonEncoded); 74 | 75 | if (false === $res) { 76 | $this->setError(-10, HTTPClient::getErrorMsg()); 77 | return false; 78 | } 79 | 80 | return $res; 81 | } 82 | 83 | /** 84 | * 设置错误信息 85 | * 86 | * @param string $code 错误代码 87 | * @param string $msg 错误详细信息 88 | */ 89 | public function setError($code, $msg = '') { 90 | $this->errorCode = $code; 91 | $this->errorMsg = $msg; 92 | } 93 | 94 | /** 95 | * 获取错误代码 96 | * 97 | * @return string 错误代码 98 | */ 99 | public function getErrorCode() { 100 | return $this->errorCode; 101 | } 102 | 103 | /** 104 | * 获取错误信息 105 | * 106 | * @return string 错误信息 107 | */ 108 | public function getErrorMsg() { 109 | return $this->errorMsg; 110 | } 111 | 112 | } 113 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/Open/Base.php: -------------------------------------------------------------------------------- 1 | apiPrefix . '/' . self::API_AUTHORIZE 34 | . '?' . http_build_query(array( 35 | 'appid' => $appId, 36 | 'redirect_uri' => $redirectURI, 37 | 'scope' => $scopeInfo ? self::SCOPE_INFO : self::SCOPE_BASE, 38 | 'response_type' => 'code', 39 | 'state' => $state 40 | )); 41 | } 42 | } -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QY/OAuth2.php: -------------------------------------------------------------------------------- 1 | setError('参数错误!'); 24 | 25 | return false; 26 | } 27 | 28 | $params = array( 29 | 'corp_id' => $corpId, 30 | 'redirect_uri' => urlencode($redirectUri), 31 | 'state' => $state 32 | ); 33 | 34 | $url = self::URL . '?' . http_build_query($params); 35 | 36 | return $url; 37 | } 38 | 39 | } 40 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/AccessToken.php: -------------------------------------------------------------------------------- 1 | get($corpId, $corpSecret); 10 | * @package timecheer.weixin.qyapi 11 | */ 12 | class AccessToekn { 13 | 14 | const API_GET_TOKEN = '/gettoken'; 15 | 16 | protected $corpId = ''; 17 | protected $corpSecret = ''; 18 | 19 | protected $errorCode; 20 | protected $errorMsg; 21 | 22 | /** 23 | * 构造函数、配置企业号相关参数 24 | * @param string $corpId 企业号corp_id 25 | * @param string $corpSecret 企业号corp_secrect 26 | */ 27 | public function __construct($corpId = '', $corpSecret = '') { 28 | $this->init($corpId, $corpSecret); 29 | } 30 | 31 | /** 32 | * 配置企业号相关参数 33 | * 34 | * @param string $corpId 企业号corp_id 35 | * @param string $corpSecret 企业号corp_secrect 36 | */ 37 | public function init($corpId, $corpSecret) { 38 | $this->setCorpId($corpId); 39 | $this->setCorpSecret($corpSecret); 40 | } 41 | 42 | public function setCorpId($corpId) { 43 | if ($corpId) { 44 | $this->corpId = $corpId; 45 | } 46 | } 47 | 48 | public function setCorpSecret($corpSecret) { 49 | if ($corpSecret) { 50 | $this->corpSecret = $corpSecret; 51 | } 52 | } 53 | 54 | public function getCorpId() { 55 | return $this->corpId; 56 | } 57 | 58 | public function getCorpSecret() { 59 | return $this->corpSecret; 60 | } 61 | 62 | /** 63 | * 设置错误信息 64 | * 65 | * @param string $code 错误代码 66 | * @param string $msg 错误详细信息 67 | */ 68 | public function setError($code, $msg = null) { 69 | $this->errorCode = $code; 70 | $this->errorMsg = $msg; 71 | } 72 | 73 | /** 74 | * 获取错误代码 75 | * 76 | * @return string 错误代码 77 | */ 78 | public function getErrorCode() { 79 | return $this->errorCode; 80 | } 81 | 82 | /** 83 | * 获取错误信息 84 | * 85 | * @return string 错误信息 86 | */ 87 | public function getErrorMsg() { 88 | return $this->errorMsg; 89 | } 90 | 91 | /** 92 | * AccessToken需要用CorpID和Secret来换取，不同的Secret会返回不同的AccessToken。 93 | * 正常情况下AccessToken有效期为7200秒，有效期内重复获取返回相同结果； 94 | * 有效期内有接口交互（包括获取AccessToken的接口），会自动续期 95 | * @return string|boolean 96 | */ 97 | public function get($corpId = '', $corpSecret = '') { 98 | $this->init($corpId, $corpSecret); 99 | 100 | $res = $this->request(self::API_GET_TOKEN, array( 101 | 'corpid' => $this->corpId, 102 | 'corpsecret' => $this->corpSecrect, 103 | )); 104 | 105 | if(empty($res['access_token'])) { 106 | $this->setError(-11, '无效AccessToken!'); 107 | return false; 108 | } 109 | 110 | return $res['access_token']; 111 | } 112 | 113 | public function request($api, $params = array()) { 114 | $res = \TimeCheer\Weixin\Util\HTTPClient::get($api, $params); 115 | 116 | if (false === $res) { 117 | $this->setError(-10, '接口请求失败!'); 118 | return false; 119 | } 120 | 121 | return $res; 122 | } 123 | } -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Agent.php: -------------------------------------------------------------------------------- 1 | setError('agentid 错误!'); 27 | 28 | return false; 29 | } 30 | 31 | return $this->doGet(self::API_AGENT_GET, array('agentid' => $agentid)); 32 | } 33 | 34 | /** 35 | * 根据应用ID s设置应用信息 36 | * 37 | * @param int $agentid 应用id 38 | * @param array $data 想要设置的信息 39 | * 40 | * @return array 41 | */ 42 | public function set($agentid, $data) { 43 | if (!is_numeric($agentid)) { 44 | $this->setError('agentid 错误!'); 45 | 46 | return false; 47 | } 48 | 49 | return $this->doPost(self::API_AGENT_SET, $data, array('agentid' => $agentid)); 50 | } 51 | 52 | /** 53 | * 企业号应用的基本信息，包括头像、昵称、帐号类型、认证类型、可见范围等信息 54 | * 55 | * @return array 56 | */ 57 | public function getAppList() { 58 | 59 | return $this->doGet(self::API_AGENT_LIST); 60 | } 61 | 62 | } 63 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Base.php: -------------------------------------------------------------------------------- 1 | 8 | *
  • -40001: 签名验证错误
    • 9 | *
  • -40002: xml解析失败
    • 10 | *
  • -40003: sha加密生成签名失败
    • 11 | *
  • -40004: encodingAesKey 非法
    • 12 | *
  • -40005: corpid 校验错误
    • 13 | *
  • -40006: aes 加密失败
    • 14 | *
  • -40007: aes 解密失败
    • 15 | *
  • -40008: 解密后得到的buffer非法
    • 16 | *
  • -40009: base64加密失败
    • 17 | *
  • -40010: base64解密失败
    • 18 | *
  • -40011: 生成xml失败
    • 19 | * 20 | * @package timecheer.weixin.qyapi.crypt 21 | */ 22 | class ErrorCode { 23 | 24 | public static $OK = 0; 25 | public static $ValidateSignatureError = -40001; 26 | public static $ParseXmlError = -40002; 27 | public static $ComputeSignatureError = -40003; 28 | public static $IllegalAesKey = -40004; 29 | public static $ValidateCorpidError = -40005; 30 | public static $EncryptAESError = -40006; 31 | public static $DecryptAESError = -40007; 32 | public static $IllegalBuffer = -40008; 33 | public static $EncodeBase64Error = -40009; 34 | public static $DecodeBase64Error = -40010; 35 | public static $GenReturnXmlError = -40011; 36 | 37 | } 38 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Crypt/PKCS7Encoder.php: -------------------------------------------------------------------------------- 1 | self::$block_size) { 46 | $pad = 0; 47 | } 48 | return substr($text, 0, (strlen($text) - $pad)); 49 | } 50 | 51 | } 52 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Crypt/Prpcrypt.php: -------------------------------------------------------------------------------- 1 | key = base64_decode($k . "="); 17 | } 18 | 19 | /** 20 | * 对明文进行加密 21 | * @param string $text 需要加密的明文 22 | * @return string 加密后的密文 23 | */ 24 | public function encrypt($text, $corpid) { 25 | 26 | try { 27 | //获得16位随机字符串，填充到明文之前 28 | $random = $this->getRandomStr(); 29 | $text = $random . pack("N", strlen($text)) . $text . $corpid; 30 | // 网络字节序 31 | $size = mcrypt_get_block_size(MCRYPT_RIJNDAEL_128, MCRYPT_MODE_CBC); 32 | $module = mcrypt_module_open(MCRYPT_RIJNDAEL_128, '', MCRYPT_MODE_CBC, ''); 33 | $iv = substr($this->key, 0, 16); 34 | //使用自定义的填充方式对明文进行补位填充 35 | $pkc_encoder = new PKCS7Encoder; 36 | $text = $pkc_encoder->encode($text); 37 | mcrypt_generic_init($module, $this->key, $iv); 38 | //加密 39 | $encrypted = mcrypt_generic($module, $text); 40 | mcrypt_generic_deinit($module); 41 | mcrypt_module_close($module); 42 | 43 | //print(base64_encode($encrypted)); 44 | //使用BASE64对加密后的字符串进行编码 45 | return array(ErrorCode::$OK, base64_encode($encrypted)); 46 | } catch (Exception $e) { 47 | print $e; 48 | return array(ErrorCode::$EncryptAESError, null); 49 | } 50 | } 51 | 52 | /** 53 | * 对密文进行解密 54 | * @param string $encrypted 需要解密的密文 55 | * @return string 解密得到的明文 56 | */ 57 | public function decrypt($encrypted, $corpid) { 58 | 59 | try { 60 | //使用BASE64对需要解密的字符串进行解码 61 | $ciphertext_dec = base64_decode($encrypted); 62 | $module = mcrypt_module_open(MCRYPT_RIJNDAEL_128, '', MCRYPT_MODE_CBC, ''); 63 | $iv = substr($this->key, 0, 16); 64 | mcrypt_generic_init($module, $this->key, $iv); 65 | 66 | //解密 67 | $decrypted = mdecrypt_generic($module, $ciphertext_dec); 68 | mcrypt_generic_deinit($module); 69 | mcrypt_module_close($module); 70 | } catch (\Exception $e) { 71 | return array(ErrorCode::$DecryptAESError, null); 72 | } 73 | 74 | 75 | try { 76 | //去除补位字符 77 | $pkc_encoder = new PKCS7Encoder; 78 | $result = $pkc_encoder->decode($decrypted); 79 | //去除16位随机字符串,网络字节序和AppId 80 | if (strlen($result) < 16) 81 | return ""; 82 | $content = substr($result, 16, strlen($result)); 83 | $len_list = unpack("N", substr($content, 0, 4)); 84 | $xml_len = $len_list[1]; 85 | $xml_content = substr($content, 4, $xml_len); 86 | $from_corpid = substr($content, $xml_len + 4); 87 | } catch (\Exception $e) { 88 | print $e; 89 | return array(ErrorCode::$IllegalBuffer, null); 90 | } 91 | if ($from_corpid != $corpid) 92 | return array(ErrorCode::$ValidateCorpidError, null); 93 | return array(0, $xml_content); 94 | } 95 | 96 | /** 97 | * 随机生成16位字符串 98 | * @return string 生成的字符串 99 | */ 100 | function getRandomStr() { 101 | 102 | $str = ""; 103 | $str_pol = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789abcdefghijklmnopqrstuvwxyz"; 104 | $max = strlen($str_pol) - 1; 105 | for ($i = 0; $i < 16; $i++) { 106 | $str .= $str_pol[mt_rand(0, $max)]; 107 | } 108 | return $str; 109 | } 110 | 111 | } 112 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Crypt/SHA1.php: -------------------------------------------------------------------------------- 1 | m_sToken = $token; 30 | $this->m_sEncodingAesKey = $encodingAesKey; 31 | $this->m_sCorpid = $Corpid; 32 | } 33 | 34 | /** 35 | * 验证URL 36 | * @param sMsgSignature: 签名串，对应URL参数的msg_signature 37 | * @param sTimeStamp: 时间戳，对应URL参数的timestamp 38 | * @param sNonce: 随机串，对应URL参数的nonce 39 | * @param sEchoStr: 随机串，对应URL参数的echostr 40 | * @param sReplyEchoStr: 解密之后的echostr，当return返回0时有效 41 | * @return：成功0，失败返回对应的错误码 42 | */ 43 | 44 | public function VerifyURL($sMsgSignature, $sTimeStamp, $sNonce, $sEchoStr, &$sReplyEchoStr) { 45 | if (strlen($this->m_sEncodingAesKey) != 43) { 46 | return ErrorCode::$IllegalAesKey; 47 | } 48 | 49 | $pc = new Prpcrypt($this->m_sEncodingAesKey); 50 | //verify msg_signature 51 | $sha1 = new SHA1; 52 | $array = $sha1->getSHA1($this->m_sToken, $sTimeStamp, $sNonce, $sEchoStr); 53 | $ret = $array[0]; 54 | 55 | if ($ret != 0) { 56 | return $ret; 57 | } 58 | 59 | $signature = $array[1]; 60 | if ($signature != $sMsgSignature) { 61 | return ErrorCode::$ValidateSignatureError; 62 | } 63 | 64 | $result = $pc->decrypt($sEchoStr, $this->m_sCorpid); 65 | if ($result[0] != 0) { 66 | return $result[0]; 67 | } 68 | $sReplyEchoStr = $result[1]; 69 | 70 | return ErrorCode::$OK; 71 | } 72 | 73 | /** 74 | * 将公众平台回复用户的消息加密打包. 75 | *
      76 | *
    1. 对要发送的消息进行AES-CBC加密
      2. 77 | *
    2. 生成安全签名
      3. 78 | *
    3. 将消息密文和安全签名打包成xml格式
      4. 79 | *
    80 | * 81 | * @param $replyMsg string 公众平台待回复用户的消息，xml格式的字符串 82 | * @param $timeStamp string 时间戳，可以自己生成，也可以用URL参数的timestamp 83 | * @param $nonce string 随机串，可以自己生成，也可以用URL参数的nonce 84 | * @param &$encryptMsg string 加密后的可以直接回复用户的密文，包括msg_signature, timestamp, nonce, encrypt的xml格式的字符串, 85 | * 当return返回0时有效 86 | * 87 | * @return int 成功0，失败返回对应的错误码 88 | */ 89 | public function EncryptMsg($sReplyMsg, $sTimeStamp, $sNonce, &$sEncryptMsg) { 90 | $pc = new Prpcrypt($this->m_sEncodingAesKey); 91 | 92 | //加密 93 | $array = $pc->encrypt($sReplyMsg, $this->m_sCorpid); 94 | $ret = $array[0]; 95 | if ($ret != 0) { 96 | return $ret; 97 | } 98 | 99 | if ($sTimeStamp == null) { 100 | $sTimeStamp = time(); 101 | } 102 | $encrypt = $array[1]; 103 | 104 | //生成安全签名 105 | $sha1 = new SHA1; 106 | $array = $sha1->getSHA1($this->m_sToken, $sTimeStamp, $sNonce, $encrypt); 107 | $ret = $array[0]; 108 | if ($ret != 0) { 109 | return $ret; 110 | } 111 | $signature = $array[1]; 112 | 113 | //生成发送的xml 114 | $xmlparse = new XMLParse; 115 | $sEncryptMsg = $xmlparse->generate($encrypt, $signature, $sTimeStamp, $sNonce); 116 | return ErrorCode::$OK; 117 | } 118 | 119 | /** 120 | * 检验消息的真实性，并且获取解密后的明文. 121 | *
      122 | *
    1. 利用收到的密文生成安全签名，进行签名验证
      2. 123 | *
    2. 若验证通过，则提取xml中的加密消息
      3. 124 | *
    3. 对消息进行解密
      4. 125 | *
    126 | * 127 | * @param $msgSignature string 签名串，对应URL参数的msg_signature 128 | * @param $timestamp string 时间戳 对应URL参数的timestamp 129 | * @param $nonce string 随机串，对应URL参数的nonce 130 | * @param $postData string 密文，对应POST请求的数据 131 | * @param &$msg string 解密后的原文，当return返回0时有效 132 | * 133 | * @return int 成功0，失败返回对应的错误码 134 | */ 135 | public function DecryptMsg($sMsgSignature, $sTimeStamp = null, $sNonce, $sPostData, &$sMsg) { 136 | if (strlen($this->m_sEncodingAesKey) != 43) { 137 | return ErrorCode::$IllegalAesKey; 138 | } 139 | 140 | $pc = new Prpcrypt($this->m_sEncodingAesKey); 141 | 142 | //提取密文 143 | $xmlparse = new XMLParse; 144 | $array = $xmlparse->extract($sPostData); 145 | $ret = $array[0]; 146 | 147 | if ($ret != 0) { 148 | return $ret; 149 | } 150 | 151 | if ($sTimeStamp == null) { 152 | $sTimeStamp = time(); 153 | } 154 | 155 | $encrypt = $array[1]; 156 | $touser_name = $array[2]; 157 | 158 | //验证安全签名 159 | $sha1 = new SHA1; 160 | $array = $sha1->getSHA1($this->m_sToken, $sTimeStamp, $sNonce, $encrypt); 161 | $ret = $array[0]; 162 | 163 | if ($ret != 0) { 164 | return $ret; 165 | } 166 | 167 | $signature = $array[1]; 168 | if ($signature != $sMsgSignature) { 169 | return ErrorCode::$ValidateSignatureError; 170 | } 171 | 172 | $result = $pc->decrypt($encrypt, $this->m_sCorpid); 173 | if ($result[0] != 0) { 174 | return $result[0]; 175 | } 176 | $sMsg = $result[1]; 177 | 178 | return ErrorCode::$OK; 179 | } 180 | 181 | } 182 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Crypt/XMLParse.php: -------------------------------------------------------------------------------- 1 | loadXML($xmltext); 22 | $array_e = $xml->getElementsByTagName('Encrypt'); 23 | $array_a = $xml->getElementsByTagName('ToUserName'); 24 | $encrypt = $array_e->item(0)->nodeValue; 25 | $tousername = $array_a->item(0)->nodeValue; 26 | return array(0, $encrypt, $tousername); 27 | } catch (\Exception $e) { 28 | print $e . "\n"; 29 | return array(\ErrorCode::$ParseXmlError, null, null); 30 | } 31 | } 32 | 33 | /** 34 | * 生成xml消息 35 | * @param string $encrypt 加密后的消息密文 36 | * @param string $signature 安全签名 37 | * @param string $timestamp 时间戳 38 | * @param string $nonce 随机字符串 39 | */ 40 | public function generate($encrypt, $signature, $timestamp, $nonce) { 41 | $format = " 42 | 43 | 44 | %s 45 | 46 | "; 47 | return sprintf($format, $encrypt, $signature, $timestamp, $nonce); 48 | } 49 | 50 | } 51 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Department.php: -------------------------------------------------------------------------------- 1 | ｜ 20 | * @param int $parentId 父亲部门id。根部门id为1 必填 21 | * @param int $order 在父部门中的次序值。order值小的排序靠前。 非必填 22 | * @param int $id 部门id，整型。指定时必须大于1，不指定时则自动生成 。 非必填 23 | * 24 | * @return array 25 | */ 26 | public function create($name, $parentId = 1, $order = 0, $id = 0) { 27 | if (!$name || !$parentId) { 28 | $this->setError('name or parentid错误!'); 29 | 30 | return false; 31 | } 32 | 33 | $data = array( 34 | 'name' => $name, 35 | 'parentid' => $parentId 36 | ); 37 | if (!empty($order)) { 38 | $data['order'] = $order; 39 | } 40 | if (!empty($id)) { 41 | $data['id'] = $id; 42 | } 43 | 44 | return $this->doPost(self::API_CREATE, $data); 45 | } 46 | 47 | /** 48 | * 更新部门 49 | * 50 | * @param int $id 部门id 必填 51 | * @param int $name 部门名称 。 非必填 52 | * @param int $parentId 父亲部门id。根部门id为1 必填 53 | * @param int $order 在父部门中的次序值。order值小的排序靠前。 非必填 54 | */ 55 | public function update($id, $name = '', $parentId = null, $order = null) { 56 | if (!$id) { 57 | $this->setError('id错误!'); 58 | 59 | return false; 60 | } 61 | 62 | $data = array( 63 | 'id' => $id, 64 | 'name' => $name, 65 | 'parentid' => $parentId, 66 | 'order' => $order 67 | ); 68 | 69 | return $this->_post(self::API_UPDATE, $data); 70 | } 71 | 72 | /** 73 | * 删除部门 74 | * 75 | * @param int $id 部门id 必填 76 | */ 77 | public function delete($id) { 78 | if (!$id) { 79 | $this->setError('id错误!'); 80 | 81 | return false; 82 | } 83 | 84 | return $this->doGet(self::API_DELETE, array( 85 | 'id' => $id, 86 | )); 87 | } 88 | 89 | /** 90 | * 获取部门列表 91 | * 92 | * @param int $id 部门id，整型.获取制定部门下的 。 非必填 93 | * 94 | * @return array 95 | */ 96 | public function query($id = null) { 97 | $params = array(); 98 | if ($id) { 99 | $params = array('id' => $id); 100 | } 101 | 102 | return $this->doGet(self::API_LIST, $params); 103 | } 104 | 105 | } 106 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Material.php: -------------------------------------------------------------------------------- 1 | setError('文件路径不正确'); 34 | 35 | return false; 36 | } 37 | 38 | // 兼容php5.3-5.6 curl模块的上传操作 39 | if (version_compare(PHP_VERSION, '5.3.0') >= 0 && class_exists('\CURLFile')) { 40 | $data = array('media' => new \CURLFile(realpath($file))); 41 | } else { 42 | $data = array('media' => '@' . realpath($file)); 43 | } 44 | 45 | return $this->doPost(self::API_ADD_NORMAL, $data, array('agentid' => $agentId, 'type' => $type)); 46 | } 47 | 48 | /** 49 | * 上传图文消息素材 50 | * @param int $agentId 企业应用的id 可在应用的设置页面查看 51 | * @param array $articles 图文消息，一个图文消息支持1到10个图文,每条图文消息的结构为: 52 | * "title": "Title01", "thumb_media_id": "2-G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0", "author": "zs", "content_source_url": "", "content": "Content001", "digest": "airticle01", "show_cover_pic": "0" 53 | */ 54 | public function addMPNews($agentId, array $articles) { 55 | $data = array( 56 | 'agentid' => $agentId, 57 | 'mpnews' => array( 58 | 'articles' => $articles 59 | ) 60 | ); 61 | 62 | return $this->doPost(self::API_ADD_MPNEWS, $data); 63 | } 64 | 65 | /** 66 | * 修改永久图文素材 67 | * @param int $agentId 68 | * @param string $mediaId 69 | * @param array $articles 70 | * @return type 71 | */ 72 | public function updateMPNews($agentId, $mediaId, array $articles) { 73 | $data = array( 74 | 'agentid' => $agentId, 75 | 'media_id' => $mediaId, 76 | 'mpnews' => array( 77 | 'articles' => $articles 78 | ) 79 | ); 80 | 81 | return $this->doPost(self::API_UPDATE_MPNEWS, $data); 82 | } 83 | 84 | /** 85 | * 通过media_id获取上传的图文消息、图片、语音、文件、视频素材 86 | * @param int $agentId 87 | * @param string $mediaId 88 | * @return type 89 | */ 90 | public function get($agentId, $mediaId) { 91 | return $this->doGet(self::API_GET, array( 92 | 'agentid' => $agentId, 93 | 'media_id' => $mediaId 94 | )); 95 | } 96 | 97 | /** 98 | * 获取应用素材总数以及每种类型素材的数目 99 | * @param int $agentId 100 | * @return type 101 | */ 102 | public function getCount($agentId) { 103 | return $this->doGet(self::API_GET_COUNT, array( 104 | 'agentid' => $agentId 105 | )); 106 | } 107 | 108 | /** 109 | * 110 | * @param int $agentId 111 | * @param string $type 素材类型，可以为图文(mpnews)、图片（image）、音频（voice）、视频（video）、文件（file） 112 | * @param int $offset 从该类型素材的该偏移位置开始返回，0表示从第一个素材 返回 113 | * @param int $count 返回素材的数量，取值在1到50之间 114 | */ 115 | public function query($agentId, $type, $offset, $count) { 116 | return $this->doPost(self::API_GET_LIST, array( 117 | 'agentid' => $agentId, 118 | 'type' => $type, 119 | 'offset' => $offset, 120 | 'count' => $count 121 | )); 122 | } 123 | 124 | /** 125 | * 通过media_id删除上传的图文消息、图片、语音、文件、视频素材 126 | * @param int $agentId 127 | * @param string $mediaId 128 | * @return type 129 | */ 130 | public function delete($agentId, $mediaId) { 131 | return $this->doGet(self::API_DELETE, array('agentid' => $agentId, 'media_id' => $mediaId)); 132 | } 133 | } 134 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Media.php: -------------------------------------------------------------------------------- 1 | setError('参数缺失'); 37 | 38 | return false; 39 | } 40 | 41 | if (!file_exists($file)) { 42 | $this->setError('文件路径不正确'); 43 | 44 | return false; 45 | } 46 | 47 | // 兼容php5.3-5.6 curl模块的上传操作 48 | if (version_compare(PHP_VERSION, '5.3.0') >= 0 && class_exists('\CURLFile')) { 49 | $data = array('media' => new \CURLFile(realpath($file))); 50 | } else { 51 | $data = array('media' => '@' . realpath($file)); 52 | } 53 | 54 | return $this->doPost(self::API_MEDIA_UPLOAD, $data, array('type' => $type)); 55 | } 56 | 57 | /** 58 | * 根据mediaID获取媒体文件 59 | * 60 | * @param string $mediaId 由上传接口获取的媒体文件 61 | * 62 | * @return array 如果成功则返回 content是由base64编码过的文件内容 解码后为正常的文件内容. 63 | */ 64 | public function get($mediaId) { 65 | 66 | return $this->doGet(self::API_MEDIA_GET, array('media_id' => $mediaId)); 67 | } 68 | 69 | } 70 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Menu.php: -------------------------------------------------------------------------------- 1 | setError('参数错误'); 24 | 25 | return false; 26 | } 27 | 28 | $data = array( 29 | 'button' => $button 30 | ); 31 | 32 | return $this->doPost(self::API_MENU_CREATE, $data, array('agentid' => $agentId)); 33 | } 34 | 35 | /** 36 | * 删除应用菜单 37 | * 38 | * @param int $agentId 应用id 39 | */ 40 | public function delete($agentId) { 41 | if (empty($agentId)) { 42 | $this->setError('参数错误'); 43 | 44 | return false; 45 | } 46 | 47 | return $this->doGet(self::API_MENU_DELETE, array('agentid' => $agentId)); 48 | } 49 | 50 | /** 51 | * 获取应用菜单列表 52 | * 53 | * @param int $agentId 应用id 54 | * 55 | * @return array 56 | */ 57 | public function doGet($agentId) { 58 | if (empty($agentId)) { 59 | $this->setError('参数错误'); 60 | 61 | return false; 62 | } 63 | 64 | return $this->doGet(self::API_MENU_GET, array('agentid' => $agentId)); 65 | } 66 | 67 | } 68 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Message.php: -------------------------------------------------------------------------------- 1 | setToUser()->setNews()->send(); 8 | * @package timecheer.weixin.qyapi 9 | */ 10 | class Message extends Base { 11 | 12 | const API_MESSAGE_SEND = '/message/send'; 13 | 14 | private $_touserData = array(); 15 | private $_topartyData = array(); 16 | private $_totagData = array(); 17 | private $_messageData = array(); 18 | private $_safe = 0; 19 | private $_messageType = ''; 20 | 21 | /** 22 | * 设置需要接收消息的用户列表 23 | * 24 | * @param array/string $users 用户userid列表 array 或者 单个用户的userid string 25 | * 26 | * @return Weixin_QYAPI_Message 27 | */ 28 | public function setToUser($users) { 29 | $users = $this->toString($users); 30 | $this->_touserData = $users; 31 | 32 | return $this; 33 | } 34 | 35 | /** 36 | * 设置需要接收消息的部门列表 37 | * 38 | * @param array/string $partys 部门ID列表 array 或者 单个部门的ID string 39 | * 40 | * @return Weixin_QYAPI_Message 41 | */ 42 | public function setToParty($partys) { 43 | $partys = $this->toString($partys); 44 | $this->_topartyData = $partys; 45 | 46 | return $this; 47 | } 48 | 49 | /** 50 | * 设置需要接收消息的标签列表 51 | * 52 | * @param array/string $tags 标签ID列表 array 或者 单个标签的ID string 53 | * 54 | * @return Weixin_QYAPI_Message 55 | */ 56 | public function setToTag($tags) { 57 | $tags = $this->toString($tags); 58 | $this->_totagData = $tags; 59 | 60 | return $this; 61 | } 62 | 63 | /** 64 | * 设置安全消息 65 | * 66 | * @param bool $flag true : 安全消息 false : 非安全消息 67 | * 68 | * @return Weixin_QYAPI_Message 69 | */ 70 | public function setIsSafe($flag = true) { 71 | $this->_safe = $flag ? 1 : 0; 72 | 73 | return $this; 74 | } 75 | 76 | /** 77 | * 设置text消息 78 | * 79 | * @param string $content 文本消息内容 80 | * 81 | * @return Weixin_QYAPI_Message 82 | */ 83 | public function setText($content) { 84 | $data = array( 85 | 'content' => $content, 86 | ); 87 | 88 | $this->_messageType = 'text'; 89 | $this->_messageData = $data; 90 | 91 | return $this; 92 | } 93 | 94 | /** 95 | * 设置news消息 96 | * 97 | * @param 注意此方法参数特殊: 98 | * 传递方法 99 | * news($data, $data, $data....);每多传递一个实参, 则news消息多一条, 最多传递十个.或者第一个参数也可以是个多维数组 100 | * $data格式 array( 101 | * 'title' => title, 102 | * 'description'=> description, 103 | * 'url' => url, 104 | * 'picurl' => picurl. 105 | * ) 106 | * 107 | * @return Weixin_QYAPI_Message 108 | */ 109 | public function setNews() { 110 | $data = array(); 111 | 112 | $args = func_get_args(); 113 | $num = func_num_args(); 114 | if ($num > 10 || $num < 1) { 115 | $this->setError('news 参数错误!'); 116 | 117 | return false; 118 | } 119 | 120 | foreach ($args as $article) { 121 | 122 | if (count($article) != count($article, 1)) { 123 | foreach ($article as $art) { 124 | $data['articles'][] = $art; 125 | } 126 | } else { 127 | $data['articles'][] = $article; 128 | } 129 | } 130 | 131 | $this->_messageType = 'news'; 132 | $this->_messageData = $data; 133 | 134 | return $this; 135 | } 136 | 137 | /** 138 | * 设置image消息 139 | * 140 | * @param string $mediaId 由上传接口得到的媒体ID 141 | * 142 | * @return Weixin_QYAPI_Message 143 | */ 144 | public function setImage($mediaId) { 145 | $data = array( 146 | 'media_id' => $mediaId, 147 | ); 148 | 149 | $this->_messageType = 'image'; 150 | $this->_messageData = $data; 151 | 152 | return $this; 153 | } 154 | 155 | /** 156 | * 设置file消息 157 | * 158 | * @param string $mediaId 由上传接口得到的媒体ID 159 | * 160 | * @return Weixin_QYAPI_Message 161 | */ 162 | public function setFile($mediaId) { 163 | $data = array( 164 | 'media_id' => $mediaId, 165 | ); 166 | 167 | $this->_messageType = 'file'; 168 | $this->_messageData = $data; 169 | 170 | return $this; 171 | } 172 | 173 | /** 174 | * 设置voice消息 175 | * 176 | * @param string $mediaId 由上传接口得到的媒体ID 177 | * 178 | * @return Weixin_QYAPI_Message 179 | */ 180 | public function setVoice($mediaId) { 181 | $data = array( 182 | 'media_id' => $mediaId, 183 | ); 184 | 185 | $this->_messageType = 'voice'; 186 | $this->_messageData = $data; 187 | 188 | return $this; 189 | } 190 | 191 | /** 192 | * 设置video消息 193 | * 194 | * @param string $mediaId 由上传接口得到的媒体ID 195 | * @param string $title 视频标题 196 | * @param string $description 视频简介 197 | * 198 | * @return Weixin_QYAPI_Message 199 | */ 200 | public function setVideo($mediaId, $title = '', $description = '') { 201 | $data = array( 202 | 'media_id' => $mediaId, 203 | ); 204 | 205 | $title && $data['title'] = $title; 206 | $description && $data['description'] = $description; 207 | 208 | $this->_messageType = 'video'; 209 | $this->_messageData = $data; 210 | 211 | return $this; 212 | } 213 | 214 | /** 215 | * 发送消息 216 | * 217 | * @param int $agentId 应用ID 218 | * 219 | * @return 接口返回结果 220 | */ 221 | public function send($agentId) { 222 | if (!is_numeric($agentId)) { 223 | $this->setError('应用ID未设置!'); 224 | 225 | return false; 226 | } 227 | 228 | if (!$this->_touserData && !$this->_topartyData && !$this->_totagData) { 229 | $this->setError('接收消息的用户,部门和标签, 不能同时为空!'); 230 | 231 | return false; 232 | } 233 | 234 | $data = array(); 235 | $this->_touserData && $data['touser'] = $this->_touserData; 236 | $this->_topartyData && $data['toparty'] = $this->_topartyData; 237 | $this->_totagData && $data['totag'] = $this->_totagData; 238 | 239 | $types = array('image', 'file', 'text', 'news', 'voice', 'video', 'mpnews'); 240 | if (!$this->_messageType || !in_array($this->_messageType, $types)) { 241 | $this->setError('消息类型未设置或设置不正确!'); 242 | 243 | return false; 244 | } 245 | $data['msgtype'] = $this->_messageType; 246 | 247 | if (empty($this->_messageData)) { 248 | $this->setError('发送的数据不允许为空!'); 249 | 250 | return false; 251 | } 252 | 253 | $data[$this->_messageType] = $this->_messageData; 254 | $data['agentid'] = $agentId; 255 | $data['safe'] = $this->_safe; 256 | 257 | // 清空数据; 258 | $this->_touserData = array(); 259 | $this->_topartyData = array(); 260 | $this->_totagData = array(); 261 | $this->_messageData = array(); 262 | $this->_safe = 0; 263 | $this->_messageType = ''; 264 | 265 | return $this->request(self::API_MESSAGE_SEND, $data); 266 | } 267 | 268 | /** 269 | * 串行化 270 | * 271 | * @param array $arr 待转换的数据 272 | * 273 | * @return string 274 | */ 275 | public function toString($arr) { 276 | if (!is_array($arr)) { 277 | return $arr; 278 | } 279 | 280 | return implode('|', $arr); 281 | } 282 | 283 | } 284 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Service.php: -------------------------------------------------------------------------------- 1 | doPost(self::API_GET_PROVIDER_TOKEN, array( 22 | 'corpid' => $corpId, 23 | 'provider_secret' => $providerSecret 24 | )); 25 | } 26 | 27 | public function getLoginInfo($providerToken, $authorizationCode) { 28 | return $this->doPost(self::API_GET_LOGIN_INFO, array('auth_code' => $authorizationCode), array('provider_access_token' => $providerToken)); 29 | } 30 | } -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/Tag.php: -------------------------------------------------------------------------------- 1 | setError('tagname'); 28 | 29 | return false; 30 | } 31 | $data['tagname'] = $name; 32 | if ($id !== null) { 33 | $data['tagid'] = $id; 34 | } 35 | 36 | return $this->doPost(self::API_CREATE, $data); 37 | } 38 | 39 | /** 40 | * 更新标签名字 41 | * 42 | * @param string $name 标签名称，长度为1~64个字节，标签不可与其他标签重名。 必填 43 | * @param int $id 标签id 必填 44 | */ 45 | public function update($name, $id = null) { 46 | if (!$name || !$id) { 47 | $this->setError('tagname || tagid'); 48 | 49 | return false; 50 | } 51 | $data['tagname'] = $name; 52 | if ($id !== null) { 53 | $data['tagid'] = $id; 54 | } 55 | 56 | return $this->doPost(self::API_UPDATE, $data); 57 | } 58 | 59 | /** 60 | * 删除标签 61 | * 62 | * @param int $id 标签id 必填 63 | */ 64 | public function delete($id) { 65 | if (!$id) { 66 | $this->setError('tagid'); 67 | 68 | return false; 69 | } 70 | 71 | return $this->doGet(self::API_DELETE, array( 72 | 'tagid' => $id, 73 | )); 74 | } 75 | 76 | /** 77 | * 获取标签成员 78 | * 79 | * @param int $id 标签id 必填 80 | */ 81 | public function getTagUsers($id) { 82 | if (!$id) { 83 | $this->setError('tagid'); 84 | 85 | return false; 86 | } 87 | 88 | return $this->doGet(self::API_GET_TAG_USERS, array( 89 | 'tagid' => $id, 90 | )); 91 | } 92 | 93 | /** 94 | * 增加标签成员 95 | * 96 | * @param int $id 标签id 必填 97 | * @param array $users 企业成员ID列表，注意：userlist、partylist不能同时为空 98 | * @param array $depts 企业部门ID列表，注意：userlist、partylist不能同时为空 99 | */ 100 | public function addTagUsers($id, array $users, $depts = null) { 101 | if (!$id) { 102 | $this->setError('tagid'); 103 | 104 | return false; 105 | } 106 | 107 | if (!$users && !$depts) { 108 | $this->setError('users,$depts'); 109 | 110 | return false; 111 | } 112 | 113 | $data = array( 114 | 'tagid' => $id 115 | ); 116 | if (!empty($users)) { 117 | $data['userlist'] = $users; 118 | } 119 | 120 | if (!empty($depts)) { 121 | if (is_int($depts)) { 122 | $depts = array($depts); 123 | } 124 | $data['partylist'] = $depts; 125 | } 126 | 127 | return $this->doPost(self::API_ADD_TAG_USERS, $data); 128 | } 129 | 130 | /** 131 | * 删除标签成员 132 | * 133 | * @param int $id 标签id 必填 134 | * @param array $users 企业成员ID列表，注意：userlist、partylist不能同时为空 135 | * @param array $depts 企业部门ID列表，注意：userlist、partylist不能同时为空 136 | */ 137 | public function delTagUsers($id, array $users, $depts = '') { 138 | if (!$id) { 139 | $this->setError('tagid'); 140 | 141 | return false; 142 | } 143 | 144 | if (!$users && !$depts) { 145 | $this->setError('userlist,partylist至少填一项'); 146 | 147 | return false; 148 | } 149 | 150 | $data = array( 151 | 'tagid' => $id 152 | ); 153 | if (!empty($users)) { 154 | $data['userlist'] = $users; 155 | } 156 | 157 | if (!empty($depts)) { 158 | if (is_int($depts)) { 159 | $depts = array($depts); 160 | } 161 | $data['partylist'] = $depts; 162 | } 163 | 164 | return $this->doPost(self::API_DEL_TAG_USERS, $data); 165 | } 166 | 167 | /** 168 | * 获取标签列表 169 | */ 170 | public function query() { 171 | return $this->doGet(self::API_LIST); 172 | } 173 | 174 | } 175 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/QYAPI/User.php: -------------------------------------------------------------------------------- 1 | setError('userid和name必填!'); 34 | 35 | return false; 36 | } 37 | 38 | if (!empty($mobile) || empty($email) || empty($weixinId)) { 39 | $this->setError('weixinid, mobile, email三者至少填一个!'); 40 | 41 | return false; 42 | } 43 | 44 | if (is_int($department)) { 45 | $department = array($department); 46 | } 47 | 48 | $data = array( 49 | 'userid' => $uid, 50 | 'name' => $name 51 | ); 52 | if ($department) { 53 | $data['department'] = $department; 54 | } 55 | if ($mobile) { 56 | $data['mobile'] = $mobile; 57 | } 58 | if ($email) { 59 | $data['email'] = $email; 60 | } 61 | if ($weixinId) { 62 | $data['weixinid'] = $weixinId; 63 | } 64 | if ($position) { 65 | $data['position'] = $position; 66 | } 67 | if ($gender) { 68 | $data['gender'] = $gender; 69 | } 70 | if ($avatarMediaId) { 71 | $data['avatar_mediaid'] = $avatarMediaId; 72 | } 73 | 74 | if ($extend) { 75 | $data['extattr']['attrs'] = $extend; 76 | } 77 | 78 | return $this->doPost(self::API_CREATE, $data); 79 | } 80 | 81 | /** 82 | * 更新 值为null时不更新相应字段 83 | * @param string $uid 84 | * @param string $name 85 | * @param array $department 86 | * @param string $mobile 87 | * @param string $email 88 | * @param string $weixinId 89 | * @param string $position 90 | * @param int $gender 91 | * @param boolean $enable 92 | * @param string $avatarMediaId 93 | * @param array $extend 94 | * @return boolean 95 | */ 96 | public function update($uid, $name, $department = null, $mobile = null, $email = null, $weixinId = null, $position = null, $gender = null, $enable = null, $avatarMediaId = null, array $extend = null) { 97 | if (!$uid || !$name) { 98 | $this->setError('userid和name必填!'); 99 | 100 | return false; 101 | } 102 | 103 | if (!empty($mobile) || empty($email) || empty($weixinId)) { 104 | $this->setError('weixinid, mobile, email三者至少填一个!'); 105 | 106 | return false; 107 | } 108 | 109 | if (is_int($department)) { 110 | $department = array($department); 111 | } 112 | 113 | $data = array( 114 | 'userid' => $uid, 115 | 'name' => $name 116 | ); 117 | if ($department !== null) { 118 | $data['department'] = $department; 119 | } 120 | if ($mobile !== null) { 121 | $data['mobile'] = $mobile; 122 | } 123 | if ($email !== null) { 124 | $data['email'] = $email; 125 | } 126 | if ($weixinId !== null) { 127 | $data['weixinid'] = $weixinId; 128 | } 129 | if ($position !== null) { 130 | $data['position'] = $position; 131 | } 132 | if ($gender !== null) { 133 | $data['gender'] = $gender; 134 | } 135 | if ($enable !== null) { 136 | $data['enable'] = ($enable == 1) ? 1 : 0; 137 | } 138 | if ($avatarMediaId !== null) { 139 | $data['avatar_mediaid'] = $avatarMediaId; 140 | } 141 | 142 | if ($extend !== null) { 143 | $data['extattr']['attrs'] = $extend; 144 | } 145 | 146 | return $this->doPost(self::API_UPDATE, $data); 147 | } 148 | 149 | /** 150 | * 删除成员 151 | * 152 | * @param string $userId 用户的企业号唯一标识 必填 153 | */ 154 | public function delete($userId) { 155 | if (!$userId) { 156 | $this->setError('userid'); 157 | 158 | return false; 159 | } 160 | 161 | return $this->doGet(self::API_DELETE, array( 162 | 'userid' => $userId, 163 | )); 164 | } 165 | 166 | /** 167 | * 批量删除成员 168 | * 169 | * @param array $users 该数组key 为用户id组成的删除列表 必填 170 | */ 171 | public function batchDelete($users) { 172 | if (!$users) { 173 | $this->setError('userList'); 174 | 175 | return false; 176 | } 177 | 178 | return $this->doPost(self::API_BATCH_DELETE, array( 179 | 'useridlist' => $users 180 | )); 181 | } 182 | 183 | /** 184 | * 邀请指定ID用户关注 185 | * 186 | * @param string $userId 用户在微信端的userid. 187 | * 188 | * @return array 接口返回信息 189 | */ 190 | public function invite($userId) { 191 | $userId = trim($userId); 192 | if (false == $userId) { 193 | $this->setError('参数错误'); 194 | 195 | return false; 196 | } 197 | 198 | return $this->doPost(self::API_SEND_INVITE, array( 199 | 'userid' => $userId, 200 | )); 201 | } 202 | 203 | /** 204 | * 根据用户ID获取用户信息 205 | * 206 | * @param string $userId 用户在微信端的userid. 207 | * 208 | * @return array 用户信息 209 | */ 210 | public function get($userId) { 211 | $userId = trim($userId); 212 | if (false == $userId) { 213 | $this->setError('参数错误'); 214 | 215 | return false; 216 | } 217 | 218 | return $this->doGet(self::API_GET, array( 219 | 'userid' => $userId, 220 | )); 221 | } 222 | 223 | /** 224 | * 根据部门ID获取部门成员列表 225 | * 226 | * @param int $departmentId 协议换回的code 227 | * @param int $fetchChild 1/0：是否递归获取子部门下面的成员 228 | * @param int $status 0获取全部成员，1获取已关注成员列表，2获取禁用成员列表，4获取未关注成员列表。status可叠加 229 | * 230 | * @return array 用户列表 231 | */ 232 | public function querySimpleByDept($departmentId, $fetchChild = 1, $status = 0) { 233 | if (false == $departmentId) { 234 | $this->setError('参数错误'); 235 | 236 | return false; 237 | } 238 | 239 | return $this->doGet(self::API_LIST_SIMPLE, array( 240 | 'department_id' => $departmentId, 241 | 'fetch_child' => $fetchChild, 242 | 'status' => $status, 243 | )); 244 | } 245 | 246 | /** 247 | * 根据部门ID获取部门成员列表(详情) 248 | * 249 | * @param int $departmentId 协议换回的code 250 | * @param int $fetchChild 1/0：是否递归获取子部门下面的成员 251 | * @param int $status 0获取全部成员，1获取已关注成员列表，2获取禁用成员列表，4获取未关注成员列表。status可叠加 252 | * 253 | * @return array 用户列表 254 | */ 255 | public function queryByDept($departmentId, $fetchChild = 0, $status = 0) { 256 | if (false == $departmentId) { 257 | $this->setError('参数错误'); 258 | 259 | return false; 260 | } 261 | 262 | return $this->doGet(self::API_LIST, array( 263 | 'department_id' => $departmentId, 264 | 'fetch_child' => $fetchChild, 265 | 'status' => $status, 266 | )); 267 | } 268 | 269 | public function getOpenid($uid, $agentId = null) { 270 | return $this->doGet(self::API_GET_OPENID, array('userid' => $uid, 'agentid' => $agentId)); 271 | } 272 | 273 | public function getUserid($openid) { 274 | return $this->doGet(self::API_GET_USERID, array('openid' => $openid)); 275 | } 276 | 277 | } 278 | -------------------------------------------------------------------------------- /src/TimeCheer/Weixin/Util/HTTPClient.php: -------------------------------------------------------------------------------- 1 | 1 && isset($apiReturnData['errmsg'])) { 197 | unset($apiReturnData['errmsg']); 198 | } 199 | 200 | if (count($apiReturnData) == 1) { 201 | $apiReturnData = reset($apiReturnData); 202 | } 203 | 204 | return $apiReturnData; 205 | } 206 | 207 | /** 208 | * 解析头部信息 209 | * 210 | * @param array $raw_headers http header 211 | * 212 | * @return array 213 | */ 214 | public static function parseHeaders($raw_headers) { 215 | if (function_exists('http_parse_headers')) { 216 | return http_parse_headers($raw_headers); 217 | } 218 | 219 | $headers = array(); 220 | $key = ''; 221 | 222 | foreach (explode("\n", $raw_headers) as $i => $h) { 223 | $h = explode(':', $h, 2); 224 | 225 | if (isset($h[1])) { 226 | if (!isset($headers[$h[0]])) { 227 | $headers[$h[0]] = trim($h[1]); 228 | } elseif (is_array($headers[$h[0]])) { 229 | $headers[$h[0]] = array_merge($headers[$h[0]], array(trim($h[1]))); 230 | } else { 231 | $headers[$h[0]] = array_merge(array($headers[$h[0]]), array(trim($h[1]))); 232 | } 233 | 234 | $key = $h[0]; 235 | } else { 236 | if (substr($h[0], 0, 1) == "\t") { 237 | $headers[$key] .= "\r\n\t" . trim($h[0]); 238 | } elseif (!$key) { 239 | $headers[0] = trim($h[0]); 240 | } 241 | trim($h[0]); 242 | } 243 | } 244 | 245 | return $headers; 246 | } 247 | 248 | /** 249 | * 设置错误信息 250 | * 251 | * @param string $code 错误代码 252 | * @param string $msg 错误详细信息 253 | */ 254 | protected static function setError($code, $msg = '') { 255 | self::$errorCode = $code; 256 | self::$errorMsg = $msg; 257 | } 258 | 259 | /** 260 | * 获取错误代码 261 | * 262 | * @return string 错误代码 263 | */ 264 | public static function getErrorCode() { 265 | return self::$errorCode; 266 | } 267 | 268 | /** 269 | * 获取错误信息 270 | * @return string 错误信息 271 | */ 272 | public static function getErrorMsg() { 273 | return self::$errorMsg; 274 | } 275 | 276 | } 277 | --------------------------------------------------------------------------------