+ *
+ * 当用户使用自己的缓存驱动时，直接实例化对象后可直接设置 AccessToekn
+ * - 多用于分布式项目时保持 AccessToken 统一
+ * - 使用此方法后就由用户来保证传入的 AccessToekn 为有效 AccessToekn
+ */
+ public function setAccessToken($access_token)
+ {
+ if (!is_string($access_token)) {
+ throw new InvalidArgumentException("Invalid AccessToken type, need string.");
+ }
+ $cache = $this->config->get('appid') . '_access_token';
+ Tools::setCache($cache, $this->access_token = $access_token);
+ }
+
+ /**
+ * 清理删除 AccessToken
* @return bool
*/
public function delAccessToken()
@@ -122,17 +159,22 @@ class BasicWeChat
* 以GET获取接口数据并转为数组
* @param string $url 接口地址
* @return array
+ * @throws InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
*/
protected function httpGetForJson($url)
{
try {
return Tools::json2arr(Tools::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']);
+ if (isset($this->currentMethod['method']) && empty($this->isTry)) {
+ if (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']);
+ }
}
+ throw new InvalidResponseException($e->getMessage(), $e->getCode());
}
}
@@ -142,6 +184,8 @@ class BasicWeChat
* @param array $data 请求数据
* @param bool $buildToJson
* @return array
+ * @throws InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
*/
protected function httpPostForJson($url, array $data, $buildToJson = true)
{
@@ -149,10 +193,10 @@ class BasicWeChat
return Tools::json2arr(Tools::post($url, $buildToJson ? Tools::arr2json($data) : $data));
} catch (InvalidResponseException $e) {
if (!$this->isTry && in_array($e->getCode(), ['40014', '40001', '41001', '42001'])) {
- $this->delAccessToken();
- $this->isTry = true;
+ [$this->delAccessToken(), $this->isTry = true];
return call_user_func_array([$this, $this->currentMethod['method']], $this->currentMethod['arguments']);
}
+ throw new InvalidResponseException($e->getMessage(), $e->getCode());
}
}
diff --git a/WeChat/Contracts/BasicWePay.php b/WeChat/Contracts/BasicWePay.php
new file mode 100644
index 0000000..55a7080
--- /dev/null
+++ b/WeChat/Contracts/BasicWePay.php
@@ -0,0 +1,203 @@
+config = new DataArray($options);
+ // 商户基础参数
+ $this->params = new DataArray([
+ 'appid' => $this->config->get('appid'),
+ 'mch_id' => $this->config->get('mch_id'),
+ 'nonce_str' => Tools::createNoncestr(),
+ ]);
+ // 商户参数支持
+ if ($this->config->get('sub_appid')) {
+ $this->params->set('sub_appid', $this->config->get('sub_appid'));
+ }
+ if ($this->config->get('sub_mch_id')) {
+ $this->params->set('sub_mch_id', $this->config->get('sub_mch_id'));
+ }
+ }
+
+ /**
+ * 静态创建对象
+ * @param array $config
+ * @return static
+ */
+ public static function instance(array $config)
+ {
+ $key = md5(get_called_class() . serialize($config));
+ if (isset(self::$cache[$key])) return self::$cache[$key];
+ return self::$cache[$key] = new static($config);
+ }
+
+ /**
+ * 获取微信支付通知
+ * @return array
+ * @throws InvalidResponseException
+ */
+ public function getNotify()
+ {
+ $data = Tools::xml2arr(file_get_contents('php://input'));
+ if (isset($data['sign']) && $this->getPaySign($data) === $data['sign']) {
+ return $data;
+ }
+ throw new InvalidResponseException('Invalid Notify.', '0');
+ }
+
+ /**
+ * 获取微信支付通知回复内容
+ * @return string
+ */
+ public function getNotifySuccessReply()
+ {
+ return Tools::arr2xml(['return_code' => 'SUCCESS', 'return_msg' => 'OK']);
+ }
+
+ /**
+ * 生成支付签名
+ * @param array $data 参与签名的数据
+ * @param string $signType 参与签名的类型
+ * @param string $buff 参与签名字符串前缀
+ * @return string
+ */
+ public function getPaySign(array $data, $signType = 'MD5', $buff = '')
+ {
+ ksort($data);
+ if (isset($data['sign'])) unset($data['sign']);
+ foreach ($data as $k => $v) $buff .= "{$k}={$v}&";
+ $buff .= ("key=" . $this->config->get('mch_key'));
+ if (strtoupper($signType) === 'MD5') {
+ return strtoupper(md5($buff));
+ }
+ return strtoupper(hash_hmac('SHA256', $buff, $this->config->get('mch_key')));
+ }
+
+ /**
+ * 转换短链接
+ * @param string $longUrl 需要转换的URL，签名用原串，传输需URLencode
+ * @return array
+ * @throws InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function shortUrl($longUrl)
+ {
+ $url = 'https://api.mch.weixin.qq.com/tools/shorturl';
+ return $this->callPostApi($url, ['long_url' => $longUrl]);
+ }
+
+
+ /**
+ * 数组直接转xml数据输出
+ * @param array $data
+ * @param bool $isReturn
+ * @return string
+ */
+ public function toXml(array $data, $isReturn = false)
+ {
+ $xml = Tools::arr2xml($data);
+ if ($isReturn) {
+ return $xml;
+ }
+ echo $xml;
+ }
+
+ /**
+ * 以Post请求接口
+ * @param string $url 请求
+ * @param array $data 接口参数
+ * @param bool $isCert 是否需要使用双向证书
+ * @param string $signType 数据签名类型 MD5|SHA256
+ * @param bool $needSignType 是否需要传签名类型参数
+ * @return array
+ * @throws InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ protected function callPostApi($url, array $data, $isCert = false, $signType = 'HMAC-SHA256', $needSignType = true)
+ {
+ $option = [];
+ if ($isCert) {
+ $option['ssl_p12'] = $this->config->get('ssl_p12');
+ $option['ssl_cer'] = $this->config->get('ssl_cer');
+ $option['ssl_key'] = $this->config->get('ssl_key');
+ if (is_string($option['ssl_p12']) && file_exists($option['ssl_p12'])) {
+ $content = file_get_contents($option['ssl_p12']);
+ if (openssl_pkcs12_read($content, $certs, $this->config->get('mch_id'))) {
+ $option['ssl_key'] = Tools::pushFile(md5($certs['pkey']) . '.pem', $certs['pkey']);
+ $option['ssl_cer'] = Tools::pushFile(md5($certs['cert']) . '.pem', $certs['cert']);
+ } else throw new InvalidArgumentException("P12 certificate does not match MCH_ID --- ssl_p12");
+ }
+ if (empty($option['ssl_cer']) || !file_exists($option['ssl_cer'])) {
+ throw new InvalidArgumentException("Missing Config -- ssl_cer", '0');
+ }
+ if (empty($option['ssl_key']) || !file_exists($option['ssl_key'])) {
+ throw new InvalidArgumentException("Missing Config -- ssl_key", '0');
+ }
+ }
+ $params = $this->params->merge($data);
+ $needSignType && ($params['sign_type'] = strtoupper($signType));
+ $params['sign'] = $this->getPaySign($params, $signType);
+ $result = Tools::xml2arr(Tools::post($url, Tools::arr2xml($params), $option));
+ if ($result['return_code'] !== 'SUCCESS') {
+ throw new InvalidResponseException($result['return_msg'], '0');
+ }
+ return $result;
+ }
+}
\ No newline at end of file
diff --git a/WeChat/Contracts/MyCurlFile.php b/WeChat/Contracts/MyCurlFile.php
new file mode 100644
index 0000000..e81e3da
--- /dev/null
+++ b/WeChat/Contracts/MyCurlFile.php
@@ -0,0 +1,63 @@
+ $v) $this->{$k} = $v;
+ } else {
+ $this->mimetype = $mimetype;
+ $this->postname = $postname;
+ $this->extension = pathinfo($filename, PATHINFO_EXTENSION);
+ if (empty($this->extension)) $this->extension = 'tmp';
+ if (empty($this->mimetype)) $this->mimetype = Tools::getExtMine($this->extension);
+ if (empty($this->postname)) $this->postname = pathinfo($filename, PATHINFO_BASENAME);
+ $this->content = base64_encode(file_get_contents($filename));
+ $this->tempname = md5($this->content) . ".{$this->extension}";
+ }
+ }
+
+ /**
+ * 获取文件信息
+ * @return \CURLFile|string
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function get()
+ {
+ $this->filename = Tools::pushFile($this->tempname, base64_decode($this->content));
+ if (class_exists('CURLFile')) {
+ return new \CURLFile($this->filename, $this->mimetype, $this->postname);
+ }
+ return "@{$this->tempname};filename={$this->postname};type={$this->mimetype}";
+ }
+
+ /**
+ * 类销毁处理
+ */
+ public function __destruct()
+ {
+ // Tools::delCache($this->tempname);
+ }
+
+}
\ No newline at end of file
diff --git a/WeChat/Contracts/Tools.php b/WeChat/Contracts/Tools.php
index 0bc5949..60a435d 100644
--- a/WeChat/Contracts/Tools.php
+++ b/WeChat/Contracts/Tools.php
@@ -31,6 +31,22 @@ class Tools
*/
public static $cache_path = null;
+ /**
+ * 缓存写入操作
+ * @var array
+ */
+ public static $cache_callable = [
+ 'set' => null, // 写入缓存
+ 'get' => null, // 获取缓存
+ 'del' => null, // 删除缓存
+ 'put' => null, // 写入文件
+ ];
+
+ /**
+ * 网络缓存
+ * @var array
+ */
+ private static $cache_curl = [];
/**
* 产生随机字符串
@@ -49,8 +65,8 @@ class Tools
/**
- * 根据文件后缀获取文件MINE
- * @param array $ext 文件后缀
+ * 根据文件后缀获取文件类型
+ * @param string|array $ext 文件后缀
* @param array $mine 文件后缀MINE信息
* @return string
* @throws LocalCacheException
@@ -65,7 +81,7 @@ class Tools
}
/**
- * 获取所有文件扩展的mine
+ * 获取所有文件扩展的类型
* @return array
* @throws LocalCacheException
*/
@@ -75,11 +91,7 @@ class Tools
if (empty($mines)) {
$content = file_get_contents('http://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types');
preg_match_all('#^([^\s]{2,}?)\s+(.+?)$#ism', $content, $matches, PREG_SET_ORDER);
- foreach ($matches as $match) {
- foreach (explode(" ", $match[2]) as $ext) {
- $mines[$ext] = $match[1];
- }
- }
+ foreach ($matches as $match) foreach (explode(" ", $match[2]) as $ext) $mines[$ext] = $match[1];
self::setCache('all_ext_mine', $mines);
}
return $mines;
@@ -95,12 +107,15 @@ class Tools
*/
public static function createCurlFile($filename, $mimetype = null, $postname = null)
{
- is_null($postname) && $postname = basename($filename);
- is_null($mimetype) && $mimetype = self::getExtMine(pathinfo($filename, 4));
- if (function_exists('curl_file_create')) {
- return curl_file_create($filename, $mimetype, $postname);
+ if (is_string($filename) && file_exists($filename)) {
+ if (is_null($postname)) $postname = basename($filename);
+ if (is_null($mimetype)) $mimetype = self::getExtMine(pathinfo($filename, 4));
+ if (function_exists('curl_file_create')) {
+ return curl_file_create($filename, $mimetype, $postname);
+ }
+ return "@{$filename};filename={$postname};type={$mimetype}";
}
- return "@{$filename};filename={$postname};type={$mimetype}";
+ return $filename;
}
/**
@@ -143,7 +158,10 @@ class Tools
*/
public static function xml2arr($xml)
{
- return json_decode(self::arr2json(simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA)), true);
+ $entity = libxml_disable_entity_loader(true);
+ $data = (array)simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA);
+ libxml_disable_entity_loader($entity);
+ return json_decode(json_encode($data), true);
}
/**
@@ -153,9 +171,70 @@ class Tools
*/
public static function arr2json($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 = json_encode(self::buildEnEmojiData($data), JSON_UNESCAPED_UNICODE);
+ return $json === '[]' ? '{}' : $json;
+ }
+
+ /**
+ * 数组对象Emoji编译处理
+ * @param array $data
+ * @return array
+ */
+ public static function buildEnEmojiData(array $data)
+ {
+ foreach ($data as $key => $value) {
+ if (is_array($value)) {
+ $data[$key] = self::buildEnEmojiData($value);
+ } elseif (is_string($value)) {
+ $data[$key] = self::emojiEncode($value);
+ } else {
+ $data[$key] = $value;
+ }
+ }
+ return $data;
+ }
+
+ /**
+ * 数组对象Emoji反解析处理
+ * @param array $data
+ * @return array
+ */
+ public static function buildDeEmojiData(array $data)
+ {
+ foreach ($data as $key => $value) {
+ if (is_array($value)) {
+ $data[$key] = self::buildDeEmojiData($value);
+ } elseif (is_string($value)) {
+ $data[$key] = self::emojiDecode($value);
+ } else {
+ $data[$key] = $value;
+ }
+ }
+ return $data;
+ }
+
+ /**
+ * Emoji原形转换为String
+ * @param string $content
+ * @return string
+ */
+ public static function emojiEncode($content)
+ {
+ return json_decode(preg_replace_callback("/(\\\u[ed][0-9a-f]{3})/i", function ($string) {
+ return addslashes($string[0]);
+ }, json_encode($content)));
+ }
+
+ /**
+ * Emoji字符串转换为原形
+ * @param string $content
+ * @return string
+ */
+ public static function emojiDecode($content)
+ {
+ return json_decode(preg_replace_callback('/\\\\\\\\/i', function () {
+ return '\\';
+ }, json_encode($content)));
}
/**
@@ -181,7 +260,8 @@ class Tools
* @param string $url 访问URL
* @param array $query GET数
* @param array $options
- * @return bool|string
+ * @return boolean|string
+ * @throws LocalCacheException
*/
public static function get($url, $query = [], $options = [])
{
@@ -194,7 +274,8 @@ class Tools
* @param string $url 访问URL
* @param array $data POST数据
* @param array $options
- * @return bool|string
+ * @return boolean|string
+ * @throws LocalCacheException
*/
public static function post($url, $data = [], $options = [])
{
@@ -207,9 +288,10 @@ class Tools
* @param string $method 请求方法
* @param string $url 请求方法
* @param array $options 请求参数[headers,data,ssl_cer,ssl_key]
- * @return bool|string
+ * @return boolean|string
+ * @throws LocalCacheException
*/
- protected static function doRequest($method, $url, $options = [])
+ public static function doRequest($method, $url, $options = [])
{
$curl = curl_init();
// GET参数设置
@@ -223,34 +305,76 @@ class Tools
// POST数据设置
if (strtolower($method) === 'post') {
curl_setopt($curl, CURLOPT_POST, true);
- curl_setopt($curl, CURLOPT_POSTFIELDS, $options['data']);
+ curl_setopt($curl, CURLOPT_POSTFIELDS, self::_buildHttpData($options['data']));
}
// 证书文件设置
- 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. --- [ssl_cer]");
- }
- }
+ 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. --- [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. --- [ssl_key]");
- }
- }
+ 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. --- [ssl_key]");
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_TIMEOUT, 60);
curl_setopt($curl, CURLOPT_HEADER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
- list($content, $status) = [curl_exec($curl), curl_getinfo($curl), curl_close($curl)];
- return (intval($status["http_code"]) === 200) ? $content : false;
+ list($content) = [curl_exec($curl), curl_close($curl)];
+ // 清理 CURL 缓存文件
+ if (!empty(self::$cache_curl)) foreach (self::$cache_curl as $key => $file) {
+ Tools::delCache($file);
+ unset(self::$cache_curl[$key]);
+ }
+ return $content;
+ }
+
+ /**
+ * POST数据过滤处理
+ * @param array $data 需要处理的数据
+ * @param boolean $build 是否编译数据
+ * @return array|string
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ private static function _buildHttpData($data, $build = true)
+ {
+ if (!is_array($data)) return $data;
+ foreach ($data as $key => $value) if (is_object($value) && $value instanceof \CURLFile) {
+ $build = false;
+ } elseif (is_object($value) && isset($value->datatype) && $value->datatype === 'MY_CURL_FILE') {
+ $build = false;
+ $mycurl = new MyCurlFile((array)$value);
+ $data[$key] = $mycurl->get();
+ array_push(self::$cache_curl, $mycurl->tempname);
+ } elseif (is_string($value) && class_exists('CURLFile', false) && stripos($value, '@') === 0) {
+ if (($filename = realpath(trim($value, '@'))) && file_exists($filename)) {
+ $build = false;
+ $data[$key] = self::createCurlFile($filename);
+ }
+ }
+ return $build ? http_build_query($data) : $data;
+ }
+
+ /**
+ * 写入文件
+ * @param string $name 文件名称
+ * @param string $content 文件内容
+ * @return string
+ * @throws LocalCacheException
+ */
+ public static function pushFile($name, $content)
+ {
+ if (is_callable(self::$cache_callable['put'])) {
+ return call_user_func_array(self::$cache_callable['put'], func_get_args());
+ }
+ $file = self::_getCacheName($name);
+ if (!file_put_contents($file, $content)) {
+ throw new LocalCacheException('local file write error.', '0');
+ }
+ return $file;
}
/**
@@ -258,15 +382,20 @@ class Tools
* @param string $name 缓存名称
* @param string $value 缓存内容
* @param int $expired 缓存时间(0表示永久缓存)
+ * @return string
* @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)) {
+ if (is_callable(self::$cache_callable['set'])) {
+ return call_user_func_array(self::$cache_callable['set'], func_get_args());
+ }
+ $file = self::_getCacheName($name);
+ $data = ['name' => $name, 'value' => $value, 'expired' => time() + intval($expired)];
+ if (!file_put_contents($file, serialize($data))) {
throw new LocalCacheException('local cache error.', '0');
}
+ return $file;
}
/**
@@ -276,8 +405,11 @@ class Tools
*/
public static function getCache($name)
{
- $cache_file = self::getCacheName($name);
- if (file_exists($cache_file) && ($content = file_get_contents($cache_file))) {
+ if (is_callable(self::$cache_callable['get'])) {
+ return call_user_func_array(self::$cache_callable['get'], func_get_args());
+ }
+ $file = self::_getCacheName($name);
+ if (file_exists($file) && ($content = file_get_contents($file))) {
$data = unserialize($content);
if (isset($data['expired']) && (intval($data['expired']) === 0 || intval($data['expired']) >= time())) {
return $data['value'];
@@ -290,12 +422,15 @@ class Tools
/**
* 移除缓存文件
* @param string $name 缓存名称
- * @return bool
+ * @return boolean
*/
public static function delCache($name)
{
- $cache_file = self::getCacheName($name);
- return file_exists($cache_file) ? unlink($cache_file) : true;
+ if (is_callable(self::$cache_callable['del'])) {
+ return call_user_func_array(self::$cache_callable['del'], func_get_args());
+ }
+ $file = self::_getCacheName($name);
+ return file_exists($file) ? unlink($file) : true;
}
/**
@@ -303,10 +438,10 @@ class Tools
* @param string $name
* @return string
*/
- private static function getCacheName($name)
+ private static function _getCacheName($name)
{
if (empty(self::$cache_path)) {
- self::$cache_path = dirname(__DIR__) . DIRECTORY_SEPARATOR . 'Cache' . DIRECTORY_SEPARATOR;
+ self::$cache_path = dirname(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);
diff --git a/WeChat/Custom.php b/WeChat/Custom.php
index bdd2887..6d03091 100644
--- a/WeChat/Custom.php
+++ b/WeChat/Custom.php
@@ -28,14 +28,13 @@ class Custom extends BasicWeChat
* 添加客服帐号
* @param string $kf_account 客服账号
* @param string $nickname 客服昵称
- * @param string $password 账号密码
* @return array
* @throws Exceptions\InvalidResponseException
* @throws Exceptions\LocalCacheException
*/
- public function addAccount($kf_account, $nickname, $password)
+ public function addAccount($kf_account, $nickname)
{
- $data = ['kf_account' => $kf_account, 'nickname' => $nickname, 'password' => $password];
+ $data = ['kf_account' => $kf_account, 'nickname' => $nickname];
$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);
@@ -45,14 +44,13 @@ class Custom extends BasicWeChat
* 修改客服帐号
* @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)
+ public function updateAccount($kf_account, $nickname)
{
- $data = ['kf_account' => $kf_account, 'nickname' => $nickname, 'password' => $password];
+ $data = ['kf_account' => $kf_account, 'nickname' => $nickname];
$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);
@@ -61,15 +59,13 @@ class Custom extends BasicWeChat
/**
* 删除客服帐号
* @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)
+ public function deleteAccount($kf_account)
{
- $data = ['kf_account' => $kf_account, 'nickname' => $nickname, 'password' => $password];
+ $data = ['kf_account' => $kf_account];
$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);
@@ -83,7 +79,7 @@ class Custom extends BasicWeChat
* @throws Exceptions\InvalidResponseException
* @throws Exceptions\LocalCacheException
*/
- public function inviteworker($kf_account, $invite_wx)
+ public function inviteWorker($kf_account, $invite_wx)
{
$url = 'https://api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKEN';
$this->registerApi($url, __FUNCTION__, func_get_args());
diff --git a/Test/config.php b/WeChat/Exceptions/InvalidInstanceException.php
similarity index 57%
rename from Test/config.php
rename to WeChat/Exceptions/InvalidInstanceException.php
index 9825b59..e4c6816 100644
--- a/Test/config.php
+++ b/WeChat/Exceptions/InvalidInstanceException.php
@@ -12,17 +12,29 @@
// | github开源项目：https://github.com/zoujingli/WeChatDeveloper
// +----------------------------------------------------------------------
-return [
- 'token' => 'test',
- 'appid' => 'wx60a43dd8161666d4',
- 'appsecret' => '71308e96a204296c57d7cd4b21b883e8',
- 'encodingaeskey' => 'BJIUzE0gqlWy0GxfPp4J1oPTBmOrNDIGPNav1YFH5Z5',
- // 配置商户支付参数
- 'mch_id' => "1332187001",
- 'mch_key' => '11bd3d66d85f322a1e803cb587d18c3f',
- // 配置商户支付双向证书目录
- 'ssl_key' => '',
- 'ssl_cer' => '',
- // 配置缓存目录，需要拥有写权限
- 'cache_path' => '',
-];
\ No newline at end of file
+namespace WeChat\Exceptions;
+
+/**
+ * 加载类异常
+ * Class InvalidInstanceException
+ * @package WeChat\Exceptions
+ */
+class InvalidInstanceException extends \Exception
+{
+ /**
+ * @var array
+ */
+ public $raw = [];
+
+ /**
+ * InvalidResponseException constructor.
+ * @param string $message
+ * @param integer $code
+ * @param array $raw
+ */
+ public function __construct($message, $code = 0, $raw = [])
+ {
+ parent::__construct($message, intval($code));
+ $this->raw = $raw;
+ }
+}
\ No newline at end of file
diff --git a/WeChat/Limit.php b/WeChat/Limit.php
index ebd56d3..6ccc6f4 100644
--- a/WeChat/Limit.php
+++ b/WeChat/Limit.php
@@ -14,7 +14,6 @@
namespace WeChat;
-
use WeChat\Contracts\BasicWeChat;
/**
@@ -38,5 +37,32 @@ class Limit extends BasicWeChat
return $this->callPostApi($url, ['appid' => $this->config->get('appid')]);
}
+ /**
+ * 网络检测
+ * @param string $action 执行的检测动作
+ * @param string $operator 指定平台从某个运营商进行检测
+ * @return array
+ * @throws Exceptions\InvalidResponseException
+ * @throws Exceptions\LocalCacheException
+ */
+ public function ping($action = 'all', $operator = 'DEFAULT')
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/callback/check?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['action' => $action, 'check_operator' => $operator]);
+ }
+
+ /**
+ * 获取微信服务器IP地址
+ * @return array
+ * @throws Exceptions\InvalidResponseException
+ * @throws Exceptions\LocalCacheException
+ */
+ public function getCallbackIp()
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/getcallbackip?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->httpGetForJson($url);
+ }
}
\ No newline at end of file
diff --git a/WeChat/Media.php b/WeChat/Media.php
index 7dd8511..8c7ca02 100644
--- a/WeChat/Media.php
+++ b/WeChat/Media.php
@@ -46,15 +46,24 @@ class Media extends BasicWeChat
/**
* 获取临时素材
* @param string $media_id
- * @return bool|string
+ * @param string $outType 返回处理函数
+ * @return array|string
* @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
- public function get($media_id)
+ public function get($media_id, $outType = null)
{
$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 Tools::get($url);
+ $result = Tools::get($url);
+ if (is_array($json = json_decode($result, true))) {
+ if (!$this->isTry && isset($json['errcode']) && in_array($json['errcode'], ['40014', '40001', '41001', '42001'])) {
+ [$this->delAccessToken(), $this->isTry = true];
+ return call_user_func_array([$this, $this->currentMethod['method']], $this->currentMethod['arguments']);
+ }
+ return Tools::json2arr($result);
+ }
+ return is_null($outType) ? $result : $outType($result);
}
/**
@@ -124,15 +133,24 @@ class Media extends BasicWeChat
/**
* 获取永久素材
* @param string $media_id
- * @return array
+ * @param null|string $outType 输出类型
+ * @return array|string
* @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
- public function getMaterial($media_id)
+ public function getMaterial($media_id, $outType = null)
{
$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]);
+ $result = Tools::post($url, ['media_id' => $media_id]);
+ if (is_array($json = json_decode($result, true))) {
+ if (!$this->isTry && isset($json['errcode']) && in_array($json['errcode'], ['40014', '40001', '41001', '42001'])) {
+ [$this->delAccessToken(), $this->isTry = true];
+ return call_user_func_array([$this, $this->currentMethod['method']], $this->currentMethod['arguments']);
+ }
+ return Tools::json2arr($result);
+ }
+ return is_null($outType) ? $result : $outType($result);
}
/**
diff --git a/WeChat/Menu.php b/WeChat/Menu.php
index 8e8fe4e..c006a8e 100644
--- a/WeChat/Menu.php
+++ b/WeChat/Menu.php
@@ -59,9 +59,6 @@ class Menu extends BasicWeChat
*/
public function create(array $data)
{
- try {
- } catch (\Exception $e) {
- }
$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);
diff --git a/WeChat/Oauth.php b/WeChat/Oauth.php
index 6ee8fc8..a8be272 100644
--- a/WeChat/Oauth.php
+++ b/WeChat/Oauth.php
@@ -41,6 +41,8 @@ class Oauth extends BasicWeChat
/**
* 通过 code 获取 AccessToken 和 openid
* @return bool|array
+ * @throws Exceptions\InvalidResponseException
+ * @throws Exceptions\LocalCacheException
*/
public function getOauthAccessToken()
{
@@ -55,6 +57,8 @@ class Oauth extends BasicWeChat
* 刷新AccessToken并续期
* @param string $refresh_token
* @return bool|array
+ * @throws Exceptions\InvalidResponseException
+ * @throws Exceptions\LocalCacheException
*/
public function getOauthRefreshToken($refresh_token)
{
@@ -68,6 +72,8 @@ class Oauth extends BasicWeChat
* @param string $access_token 网页授权接口调用凭证,注意：此access_token与基础支持的access_token不同
* @param string $openid 用户的唯一标识
* @return array
+ * @throws Exceptions\InvalidResponseException
+ * @throws Exceptions\LocalCacheException
*/
public function checkOauthAccessToken($access_token, $openid)
{
@@ -81,6 +87,8 @@ class Oauth extends BasicWeChat
* @param string $openid 用户的唯一标识
* @param string $lang 返回国家地区语言版本，zh_CN 简体，zh_TW 繁体，en 英语
* @return array
+ * @throws Exceptions\InvalidResponseException
+ * @throws Exceptions\LocalCacheException
*/
public function getUserInfo($access_token, $openid, $lang = 'zh_CN')
{
diff --git a/WeChat/Pay.php b/WeChat/Pay.php
index 260e8be..dcc87ce 100644
--- a/WeChat/Pay.php
+++ b/WeChat/Pay.php
@@ -14,262 +14,219 @@
namespace WeChat;
-use WeChat\Contracts\DataArray;
-use WeChat\Contracts\Tools;
-use WeChat\Exceptions\InvalidArgumentException;
+use WeChat\Contracts\BasicWePay;
use WeChat\Exceptions\InvalidResponseException;
+use WePay\Bill;
+use WePay\Order;
+use WePay\Refund;
+use WePay\Transfers;
+use WePay\TransfersBank;
/**
* 微信支付商户
* Class Pay
* @package WeChat\Contracts
*/
-class Pay
+class Pay extends BasicWePay
{
- /**
- * 商户配置
- * @var DataArray
- */
- protected $config;
-
- /**
- * 当前请求数据
- * @var DataArray
- */
- protected $params;
-
-
- /**
- * WeChat constructor.
- * @param array $options
- */
- public function __construct(array $options)
- {
- if (empty($options['appid'])) {
- throw new InvalidArgumentException("Missing Config -- [appid]");
- }
- if (empty($options['mch_id'])) {
- throw new InvalidArgumentException("Missing Config -- [mch_id]");
- }
- if (empty($options['mch_key'])) {
- throw new InvalidArgumentException("Missing Config -- [mch_key]");
- }
- if (!empty($options['cache_path'])) {
- Tools::$cache_path = $options['cache_path'];
- }
- $this->config = new DataArray($options);
- $this->params = new DataArray([
- 'appid' => $this->config->get('appid'),
- 'mch_id' => $this->config->get('mch_id'),
- 'nonce_str' => Tools::createNoncestr(),
- ]);
- }
-
/**
* 统一下单
* @param array $options
* @return array
+ * @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
public function createOrder(array $options)
{
- $url = 'https://api.mch.weixin.qq.com/pay/unifiedorder';
- return $this->callPostApi($url, $options);
+ return Order::instance($this->config->get())->create($options);
+ }
+
+ /**
+ * 刷卡支付
+ * @param array $options
+ * @return array
+ * @throws Exceptions\LocalCacheException
+ * @throws InvalidResponseException
+ */
+ public function createMicropay($options)
+ {
+ return Order::instance($this->config->get())->micropay($options);
+ }
+
+ /**
+ * 创建JsApi及H5支付参数
+ * @param string $prepay_id 统一下单预支付码
+ * @return array
+ */
+ public function createParamsForJsApi($prepay_id)
+ {
+ return Order::instance($this->config->get())->jsapiParams($prepay_id);
+ }
+
+ /**
+ * 获取APP支付参数
+ * @param string $prepay_id 统一下单预支付码
+ * @return array
+ */
+ public function createParamsForApp($prepay_id)
+ {
+ return Order::instance($this->config->get())->appParams($prepay_id);
+ }
+
+ /**
+ * 获取支付规则二维码
+ * @param string $product_id 商户定义的商品id 或者订单号
+ * @return string
+ */
+ public function createParamsForRuleQrc($product_id)
+ {
+ return Order::instance($this->config->get())->qrcParams($product_id);
}
/**
* 查询订单
* @param array $options
* @return array
+ * @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
public function queryOrder(array $options)
{
- $url = 'https://api.mch.weixin.qq.com/pay/orderquery';
- return $this->callPostApi($url, $options);
+ return Order::instance($this->config->get())->query($options);
}
/**
* 关闭订单
* @param string $out_trade_no 商户订单号
* @return array
+ * @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
public function closeOrder($out_trade_no)
{
- $url = 'https://api.mch.weixin.qq.com/pay/closeorder';
- return $this->callPostApi($url, ['out_trade_no' => $out_trade_no]);
+ return Order::instance($this->config->get())->close($out_trade_no);
}
/**
* 申请退款
* @param array $options
* @return array
+ * @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
public function createRefund(array $options)
{
- $url = 'https://api.mch.weixin.qq.com/secapi/pay/refund';
- return $this->callPostApi($url, $options, true);
+ return Refund::instance($this->config->get())->create($options);
}
/**
* 查询退款
* @param array $options
* @return array
+ * @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
public function queryRefund(array $options)
{
- $url = 'https://api.mch.weixin.qq.com/pay/refundquery';
- return $this->callPostApi($url, $options);
+ return Refund::instance($this->config->get())->query($options);
}
/**
* 交易保障
* @param array $options
* @return array
+ * @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
public function report(array $options)
{
- $url = 'https://api.mch.weixin.qq.com/payitil/report';
- return $this->callPostApi($url, $options);
+ return Order::instance($this->config->get())->report($options);
}
/**
* 授权码查询openid
* @param string $authCode 扫码支付授权码，设备读取用户微信中的条码或者二维码信息
* @return array
+ * @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
public function queryAuthCode($authCode)
{
- $url = 'https://api.mch.weixin.qq.com/tools/authcodetoopenid';
- return $this->callPostApi($url, ['auth_code' => $authCode]);
- }
-
- /**
- * 转换短链接
- * @param string $longUrl 需要转换的URL，签名用原串，传输需URLencode
- * @return array
- * @throws InvalidResponseException
- */
- public function shortUrl($longUrl)
- {
- $url = 'https://api.mch.weixin.qq.com/tools/shorturl';
- return $this->callPostApi($url, ['long_url' => $longUrl]);
+ return Order::instance($this->config->get())->queryAuthCode($authCode);
}
/**
* 下载对账单
- * @param array $options
- * @return array
+ * @param array $options 静音参数
+ * @param null|string $outType 输出类型
+ * @return bool|string
+ * @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
- public function billDownload(array $options)
+ public function billDownload(array $options, $outType = null)
{
- $url = 'https://api.mch.weixin.qq.com/pay/downloadbill';
- return $this->callPostApi($url, $options);
+ return Bill::instance($this->config->get())->download($options, $outType);
}
-
/**
* 拉取订单评价数据
* @param array $options
* @return array
+ * @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
public function billCommtent(array $options)
{
- $url = 'https://api.mch.weixin.qq.com/billcommentsp/batchquerycomment';
- return $this->callPostApi($url, $options, true);
+ return Bill::instance($this->config->get())->comment($options);
}
/**
* 企业付款到零钱
* @param array $options
* @return array
+ * @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
public function createTransfers(array $options)
{
- $url = 'https://api.mch.weixin.qq.com/mmpaymkttransfers/promotion/transfers';
- return $this->callPostApi($url, $options, true);
+ return Transfers::instance($this->config->get())->create($options);
}
/**
* 查询企业付款到零钱
* @param string $partner_trade_no 商户调用企业付款API时使用的商户订单号
* @return array
+ * @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
public function queryTransfers($partner_trade_no)
{
- $url = 'https://api.mch.weixin.qq.com/mmpaymkttransfers/gettransferinfo';
- return $this->callPostApi($url, ['partner_trade_no' => $partner_trade_no], true);
+ return Transfers::instance($this->config->get())->query($partner_trade_no);
}
/**
- * 获取微信支付通知
+ * 企业付款到银行卡
+ * @param array $options
* @return array
+ * @throws Exceptions\LocalCacheException
+ * @throws Exceptions\InvalidDecryptException
+ * @throws Exceptions\InvalidResponseException
+ */
+ public function createTransfersBank(array $options)
+ {
+ return TransfersBank::instance($this->config->get())->create($options);
+ }
+
+ /**
+ * 商户企业付款到银行卡操作进行结果查询
+ * @param string $partner_trade_no 商户订单号，需保持唯一
+ * @return array
+ * @throws Exceptions\LocalCacheException
* @throws InvalidResponseException
*/
- public function getNotify()
+ public function queryTransFresBank($partner_trade_no)
{
- $data = Tools::xml2arr(file_get_contents('php://input'));
- if (!empty($data['sign'])) {
- if ($this->getPaySign($data) === $data['sign']) {
- return $data;
- }
- }
- throw new InvalidResponseException('Invalid Notify.', '0');
- }
-
- /**
- * 生成支付签名
- * @param array $data
- * @return string
- */
- public function getPaySign(array $data)
- {
- unset($data['sign']);
- ksort($data);
- list($key, $str) = [$this->config->get('mch_key'), ''];
- foreach ($data as $k => $v) {
- $str .= "{$k}={$v}&";
- }
- return strtoupper(hash_hmac('SHA256', "{$str}key={$key}", $key));
- }
-
- /**
- * 以Post请求接口
- * @param string $url 请求
- * @param array $data 接口参数
- * @param bool $isCert 是否需要使用双向证书
- * @return array
- * @throws InvalidResponseException
- */
- public function callPostApi($url, array $data, $isCert = false)
- {
- $option = [];
- if ($isCert) {
- foreach (['ssl_cer', 'ssl_key'] as $key) {
- if (empty($options[$key])) {
- throw new InvalidArgumentException("Missing Config -- [{$key}]", '0');
- }
- }
- $option['ssl_cer'] = $this->config->get('ssl_cer');
- $option['ssl_key'] = $this->config->get('ssl_key');
- }
- $params = $this->params->merge($data);
- $params['sign_type'] = 'HMAC-SHA256';
- $params['sign'] = $this->getPaySign($params);
- $result = Tools::xml2arr(Tools::post($url, Tools::arr2xml($params), $option));
- if ($result['return_code'] !== 'SUCCESS') {
- throw new InvalidResponseException($result['return_msg'], '0');
- }
- return $result;
+ return TransfersBank::instance($this->config->get())->query($partner_trade_no);
}
}
\ No newline at end of file
diff --git a/WeChat/Product.php b/WeChat/Product.php
index b1add21..74eb3ee 100644
--- a/WeChat/Product.php
+++ b/WeChat/Product.php
@@ -14,7 +14,6 @@
namespace WeChat;
-
use WeChat\Contracts\BasicWeChat;
/**
diff --git a/WeChat/Script.php b/WeChat/Script.php
index a8a664d..145e519 100644
--- a/WeChat/Script.php
+++ b/WeChat/Script.php
@@ -14,8 +14,8 @@
namespace WeChat;
-use WeChat\Contracts\Tools;
use WeChat\Contracts\BasicWeChat;
+use WeChat\Contracts\Tools;
use WeChat\Exceptions\InvalidResponseException;
/**
@@ -87,15 +87,11 @@ class Script extends BasicWeChat
"timestamp" => $data['timestamp'],
"signature" => $this->getSignature($data, 'sha1'),
'jsApiList' => [
- 'onWXDeviceBluetoothStateChange', 'onWXDeviceStateChange',
- 'openProductSpecificView', 'addCard', 'chooseCard', 'openCard',
- 'translateVoice', 'getNetworkType', 'openLocation', 'getLocation',
- 'onMenuShareTimeline', 'onMenuShareAppMessage', 'onMenuShareQQ', 'onMenuShareWeibo', 'onMenuShareQZone',
- 'chooseImage', 'previewImage', 'uploadImage', 'downloadImage', 'closeWindow', 'scanQRCode', 'chooseWXPay',
- 'hideOptionMenu', 'showOptionMenu', 'hideMenuItems', 'showMenuItems', 'hideAllNonBaseMenuItem', 'showAllNonBaseMenuItem',
- 'startScanWXDevice', 'stopScanWXDevice', 'onWXDeviceBindStateChange', 'onScanWXDeviceResult', 'onReceiveDataFromWXDevice',
+ 'updateAppMessageShareData', 'updateTimelineShareData', 'onMenuShareTimeline', 'onMenuShareAppMessage', 'onMenuShareQQ', 'onMenuShareWeibo', 'onMenuShareQZone',
'startRecord', 'stopRecord', 'onVoiceRecordEnd', 'playVoice', 'pauseVoice', 'stopVoice', 'onVoicePlayEnd', 'uploadVoice', 'downloadVoice',
- 'openWXDeviceLib', 'closeWXDeviceLib', 'getWXDeviceInfos', 'sendDataToWXDevice', 'disconnectWXDevice', 'getWXDeviceTicket', 'connectWXDevice',
+ 'chooseImage', 'previewImage', 'uploadImage', 'downloadImage', 'translateVoice', 'getNetworkType', 'openLocation', 'getLocation',
+ 'hideOptionMenu', 'showOptionMenu', 'hideMenuItems', 'showMenuItems', 'hideAllNonBaseMenuItem', 'showAllNonBaseMenuItem',
+ 'closeWindow', 'scanQRCode', 'chooseWXPay', 'openProductSpecificView', 'addCard', 'chooseCard', 'openCard',
],
];
}
@@ -104,18 +100,14 @@ class Script extends BasicWeChat
* 数据生成签名
* @param array $data 签名数组
* @param string $method 签名方法
+ * @param array $params 签名参数
* @return bool|string 签名值
*/
- protected function getSignature($data, $method = "sha1")
+ protected function getSignature($data, $method = "sha1", $params = [])
{
- if (!function_exists($method)) {
- return false;
- }
ksort($data);
- $params = [];
- foreach ($data as $key => $value) {
- $params[] = "{$key}={$value}";
- }
+ if (!function_exists($method)) return false;
+ foreach ($data as $k => $v) array_push($params, "{$k}={$v}");
return $method(join('&', $params));
}
}
\ No newline at end of file
diff --git a/WeChat/Tags.php b/WeChat/Tags.php
index db26acf..a13c79f 100644
--- a/WeChat/Tags.php
+++ b/WeChat/Tags.php
@@ -90,7 +90,7 @@ class Tags extends BasicWeChat
{
$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]);
+ return $this->httpPostForJson($url, ['openid_list' => $openids, 'tagid' => $tagId]);
}
/**
@@ -105,7 +105,7 @@ class Tags extends BasicWeChat
{
$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]);
+ return $this->httpPostForJson($url, ['openid_list' => $openids, 'tagid' => $tagId]);
}
/**
diff --git a/WeChat/User.php b/WeChat/User.php
index 742cd6f..2156cf7 100644
--- a/WeChat/User.php
+++ b/WeChat/User.php
@@ -49,7 +49,7 @@ class User extends BasicWeChat
*/
public function getUserInfo($openid, $lang = 'zh_CN')
{
- $url = "https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid={$openid}&lang=zh_CN";
+ $url = "https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid={$openid}&lang={$lang}";
$this->registerApi($url, __FUNCTION__, func_get_args());
return $this->httpGetForJson($url);
}
@@ -87,6 +87,21 @@ class User extends BasicWeChat
return $this->httpGetForJson($url);
}
+ /**
+ * 获取标签下粉丝列表
+ * @param integer $tagid 标签ID
+ * @param string $next_openid 第一个拉取的OPENID
+ * @return array
+ * @throws Exceptions\InvalidResponseException
+ * @throws Exceptions\LocalCacheException
+ */
+ public function getUserListByTag($tagid, $next_openid = '')
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/user/tag/get?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->httpPostForJson($url, ['tagid' => $tagid, 'next_openid' => $next_openid]);
+ }
+
/**
* 获取公众号的黑名单列表
* @param string $begin_openid
diff --git a/WeChat/Wifi.php b/WeChat/Wifi.php
index ecc45a4..ff22aff 100644
--- a/WeChat/Wifi.php
+++ b/WeChat/Wifi.php
@@ -14,7 +14,6 @@
namespace WeChat;
-
use WeChat\Contracts\BasicWeChat;
/**
diff --git a/WeMini/Crypt.php b/WeMini/Crypt.php
new file mode 100644
index 0000000..38fe360
--- /dev/null
+++ b/WeMini/Crypt.php
@@ -0,0 +1,105 @@
+config->get('appid'), $sessionKey);
+ $errCode = $pc->decryptData($encryptedData, $iv, $data);
+ if ($errCode == 0) {
+ return json_decode($data, true);
+ }
+ return false;
+ }
+
+ /**
+ * 登录凭证校验
+ * @param string $code 登录时获取的 code
+ * @return array
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function session($code)
+ {
+ $appid = $this->config->get('appid');
+ $secret = $this->config->get('appsecret');
+ $url = "https://api.weixin.qq.com/sns/jscode2session?appid={$appid}&secret={$secret}&js_code={$code}&grant_type=authorization_code";
+ return json_decode(Tools::get($url), true);
+ }
+
+ /**
+ * 换取用户信息
+ * @param string $code 用户登录凭证（有效期五分钟）
+ * @param string $iv 加密算法的初始向量
+ * @param string $encryptedData 加密数据( encryptedData )
+ * @return array
+ * @throws InvalidDecryptException
+ * @throws InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function userInfo($code, $iv, $encryptedData)
+ {
+ $result = $this->session($code);
+ if (empty($result['session_key'])) {
+ throw new InvalidResponseException('Code 换取 SessionKey 失败', 403);
+ }
+ $userinfo = $this->decode($iv, $result['session_key'], $encryptedData);
+ if (empty($userinfo)) {
+ throw new InvalidDecryptException('用户信息解析失败', 403);
+ }
+ return array_merge($result, $userinfo);
+ }
+
+ /**
+ * 用户支付完成后，获取该用户的 UnionId
+ * @param string $openid 支付用户唯一标识
+ * @param null|string $transaction_id 微信支付订单号
+ * @param null|string $mch_id 微信支付分配的商户号，和商户订单号配合使用
+ * @param null|string $out_trade_no 微信支付商户订单号，和商户号配合使用
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getPaidUnionId($openid, $transaction_id = null, $mch_id = null, $out_trade_no = null)
+ {
+ $url = "https://api.weixin.qq.com/wxa/getpaidunionid?access_token=ACCESS_TOKEN&openid={$openid}";
+ if (is_null($mch_id)) $url .= "&mch_id={$mch_id}";
+ if (is_null($out_trade_no)) $url .= "&out_trade_no={$out_trade_no}";
+ if (is_null($transaction_id)) $url .= "&transaction_id={$transaction_id}";
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callGetApi($url);
+ }
+}
\ No newline at end of file
diff --git a/WeMini/Delivery.php b/WeMini/Delivery.php
new file mode 100644
index 0000000..6d6d6af
--- /dev/null
+++ b/WeMini/Delivery.php
@@ -0,0 +1,181 @@
+registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 下配送单接口
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function addOrder($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/local/business/order/add?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 可以对待接单状态的订单增加小费
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function addTip($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/local/business/order/addtips?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 取消配送单接口
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function cancelOrder($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/local/business/order/cancel?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 获取已支持的配送公司列表接口
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getAllImmeDelivery($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/local/business/delivery/getall?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 拉取已绑定账号
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getBindAccount($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/local/business/shop/get?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 拉取配送单信息
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getOrder($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/local/business/order/get?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 模拟配送公司更新配送单状态
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function mockUpdateOrder($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/local/business/test_update_order?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 预下配送单接口
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function preAddOrder($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/local/business/order/pre_add?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 预取消配送单接口
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function preCancelOrder($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/local/business/order/precancel?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 重新下单
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function reOrder($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/local/business/order/readd?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+}
\ No newline at end of file
diff --git a/WeMini/Image.php b/WeMini/Image.php
new file mode 100644
index 0000000..16db575
--- /dev/null
+++ b/WeMini/Image.php
@@ -0,0 +1,72 @@
+registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['img_url' => $img_url, 'img' => $img], true);
+ }
+
+ /**
+ * 本接口提供基于小程序的条码/二维码识别的API
+ * @param string $img_url 要检测的图片 url，传这个则不用传 img 参数。
+ * @param string $img form-data 中媒体文件标识，有filename、filelength、content-type等信息，传这个则不用穿 img_url
+ * @return array
+ * @throws InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function scanQRCode($img_url, $img)
+ {
+ $url = "https://api.weixin.qq.com/cv/img/qrcode?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN";
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['img_url' => $img_url, 'img' => $img], true);
+ }
+
+ /**
+ * 本接口提供基于小程序的图片高清化能力
+ * @param string $img_url 要检测的图片 url，传这个则不用传 img 参数
+ * @param string $img form-data 中媒体文件标识，有filename、filelength、content-type等信息，传这个则不用穿 img_url
+ * @return array
+ * @throws InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function superresolution($img_url, $img)
+ {
+ $url = "https://api.weixin.qq.com/cv/img/qrcode?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN";
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['img_url' => $img_url, 'img' => $img], true);
+ }
+}
\ No newline at end of file
diff --git a/WeMini/Logistics.php b/WeMini/Logistics.php
new file mode 100644
index 0000000..dc048bb
--- /dev/null
+++ b/WeMini/Logistics.php
@@ -0,0 +1,206 @@
+registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 取消运单
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function cancelOrder($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/business/order/cancel?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 获取支持的快递公司列表
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getAllDelivery()
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/business/delivery/getall?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callGetApi($url);
+ }
+
+ /**
+ * 获取运单数据
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getOrder($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/business/order/get?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 查询运单轨迹
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getPath($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/business/path/get?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 获取打印员。若需要使用微信打单 PC 软件，才需要调用
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getPrinter()
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/business/printer/getall?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callGetApi($url);
+ }
+
+ /**
+ * 获取电子面单余额。仅在使用加盟类快递公司时，才可以调用
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getQuota($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/business/path/get?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 模拟快递公司更新订单状态, 该接口只能用户测试
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function testUpdateOrder($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/business/test_update_order?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 配置面单打印员，若需要使用微信打单 PC 软件，才需要调用
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function updatePrinter($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/business/printer/update?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 获取面单联系人信息
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getContact($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/delivery/contact/get?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 预览面单模板。用于调试面单模板使用
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function previewTemplate($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/delivery/template/preview?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 更新商户审核结果
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function updateBusiness($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/delivery/service/business/update?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 更新运单轨迹
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function updatePath($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/express/delivery/path/update?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+}
\ No newline at end of file
diff --git a/WeMini/Message.php b/WeMini/Message.php
new file mode 100644
index 0000000..fdb06a4
--- /dev/null
+++ b/WeMini/Message.php
@@ -0,0 +1,67 @@
+registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 动态消息，修改被分享的动态消息
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function setUpdatableMsg($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/message/wxopen/updatablemsg/send?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 下发小程序和公众号统一的服务消息
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function uniformSend($data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/message/wxopen/template/uniform_send?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+}
\ No newline at end of file
diff --git a/WeMini/Ocr.php b/WeMini/Ocr.php
new file mode 100644
index 0000000..22b5048
--- /dev/null
+++ b/WeMini/Ocr.php
@@ -0,0 +1,110 @@
+registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 本接口提供基于小程序的营业执照 OCR 识别
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function businessLicense($data)
+ {
+ $url = 'https://api.weixin.qq.com/cv/ocr/bizlicense?access_token=ACCESS_TOCKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 本接口提供基于小程序的驾驶证 OCR 识别
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function driverLicense($data)
+ {
+ $url = 'https://api.weixin.qq.com/cv/ocr/drivinglicense?access_token=ACCESS_TOCKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 本接口提供基于小程序的身份证 OCR 识别
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function idcard($data)
+ {
+ $url = 'https://api.weixin.qq.com/cv/ocr/idcard?access_token=ACCESS_TOCKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 本接口提供基于小程序的通用印刷体 OCR 识别
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function printedText($data)
+ {
+ $url = 'https://api.weixin.qq.com/cv/ocr/comm?access_token=ACCESS_TOCKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 本接口提供基于小程序的行驶证 OCR 识别
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function vehicleLicense($data)
+ {
+ $url = 'https://api.weixin.qq.com/cv/ocr/driving?access_token=ACCESS_TOCKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+}
\ No newline at end of file
diff --git a/WeMini/Plugs.php b/WeMini/Plugs.php
new file mode 100644
index 0000000..6110e89
--- /dev/null
+++ b/WeMini/Plugs.php
@@ -0,0 +1,112 @@
+registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['action' => 'apply', 'plugin_appid' => $plugin_appid], true);
+ }
+
+ /**
+ * 2.查询已添加的插件
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getList()
+ {
+ $url = 'https://api.weixin.qq.com/wxa/plugin?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['action' => 'list'], true);
+ }
+
+ /**
+ * 3.删除已添加的插件
+ * @param string $plugin_appid 插件appid
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function unbind($plugin_appid)
+ {
+ $url = 'https://api.weixin.qq.com/wxa/plugin?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['action' => 'unbind', 'plugin_appid' => $plugin_appid], true);
+ }
+
+ /**
+ * 获取当前所有插件使用方
+ * 修改插件使用申请的状态
+ * @param array $data
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function devplugin($data)
+ {
+ $url = 'https://api.weixin.qq.com/wxa/devplugin?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 4.获取当前所有插件使用方（供插件开发者调用）
+ * @param integer $page 拉取第page页的数据
+ * @param integer $num 表示每页num条记录
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function devApplyList($page = 1, $num = 10)
+ {
+ $url = 'https://api.weixin.qq.com/wxa/plugin?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ $data = ['action' => 'dev_apply_list', 'page' => $page, 'num' => $num];
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 5.修改插件使用申请的状态（供插件开发者调用）
+ * @param string $action dev_agree：同意申请；dev_refuse：拒绝申请；dev_delete：删除已拒绝的申请者
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function devAgree($action = 'dev_agree')
+ {
+ $url = 'https://api.weixin.qq.com/wxa/plugin?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['action' => $action], true);
+ }
+
+}
\ No newline at end of file
diff --git a/WeMini/Poi.php b/WeMini/Poi.php
new file mode 100644
index 0000000..c81ef5d
--- /dev/null
+++ b/WeMini/Poi.php
@@ -0,0 +1,91 @@
+registerApi($url, __FUNCTION__, func_get_args());
+ $data = [
+ 'related_name' => $related_name, 'related_credential' => $related_credential,
+ 'related_address' => $related_address, 'related_proof_material' => $related_proof_material,
+ ];
+ return $this->callPostApi($url, $data, true);
+ }
+
+ /**
+ * 查看地点列表
+ * @param integer $page 起始页id（从1开始计数）
+ * @param integer $page_rows 每页展示个数（最多1000个）
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getNearByPoiList($page = 1, $page_rows = 1000)
+ {
+ $url = "https://api.weixin.qq.com/wxa/getnearbypoilist?page={$page}&page_rows={$page_rows}&access_token=ACCESS_TOKEN";
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callGetApi($url);
+ }
+
+ /**
+ * 删除地点
+ * @param string $poi_id 附近地点ID
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function delNearByPoiList($poi_id)
+ {
+ $url = "https://api.weixin.qq.com/wxa/delnearbypoi?access_token=ACCESS_TOKEN";
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['poi_id' => $poi_id], true);
+ }
+
+ /**
+ * 展示/取消展示附近小程序
+ * @param string $poi_id 附近地点ID
+ * @param string $status 0：取消展示；1：展示
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function setNearByPoiShowStatus($poi_id, $status)
+ {
+ $url = "https://api.weixin.qq.com/wxa/setnearbypoishowstatus?access_token=ACCESS_TOKEN";
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['poi_id' => $poi_id, 'status' => $status], true);
+ }
+
+}
\ No newline at end of file
diff --git a/WeMini/Qrcode.php b/WeMini/Qrcode.php
new file mode 100644
index 0000000..4c238b3
--- /dev/null
+++ b/WeMini/Qrcode.php
@@ -0,0 +1,112 @@
+ "0", "g" => "0", "b" => "0"], $is_hyaline = true, $outType = null)
+ {
+ $url = 'https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ $data = ['path' => $path, 'width' => $width, 'auto_color' => $auto_color, 'line_color' => $line_color, 'is_hyaline' => $is_hyaline];
+ $result = Tools::post($url, Tools::arr2json($data));
+ if (is_array($json = json_decode($result, true))) {
+ if (!$this->isTry && isset($json['errcode']) && in_array($json['errcode'], ['40014', '40001', '41001', '42001'])) {
+ [$this->delAccessToken(), $this->isTry = true];
+ return call_user_func_array([$this, $this->currentMethod['method']], $this->currentMethod['arguments']);
+ }
+ return Tools::json2arr($result);
+ }
+ return is_null($outType) ? $result : $outType($result);
+ }
+
+ /**
+ * 获取小程序码（永久有效）
+ * 接口B：适用于需要的码数量极多的业务场景
+ * @param string $scene 最大32个可见字符，只支持数字
+ * @param string $page 必须是已经发布的小程序存在的页面
+ * @param integer $width 二维码的宽度
+ * @param bool $auto_color 自动配置线条颜色，如果颜色依然是黑色，则说明不建议配置主色调
+ * @param array $line_color auto_color 为 false 时生效
+ * @param boolean $is_hyaline 是否需要透明底色
+ * @param null|string $outType 输出类型
+ * @return array|string
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function createMiniScene($scene, $page, $width = 430, $auto_color = false, $line_color = ["r" => "0", "g" => "0", "b" => "0"], $is_hyaline = true, $outType = null)
+ {
+ $url = 'https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN';
+ $data = ['scene' => $scene, 'width' => $width, 'auto_color' => $auto_color, 'page' => $page, 'line_color' => $line_color, 'is_hyaline' => $is_hyaline];
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ $result = Tools::post($url, Tools::arr2json($data));
+ if (is_array($json = json_decode($result, true))) {
+ if (!$this->isTry && isset($json['errcode']) && in_array($json['errcode'], ['40014', '40001', '41001', '42001'])) {
+ [$this->delAccessToken(), $this->isTry = true];
+ return call_user_func_array([$this, $this->currentMethod['method']], $this->currentMethod['arguments']);
+ }
+ return Tools::json2arr($result);
+ }
+ return is_null($outType) ? $result : $outType($result);
+ }
+
+ /**
+ * 获取小程序二维码（永久有效）
+ * 接口C：适用于需要的码数量较少的业务场景
+ * @param string $path 不能为空，最大长度 128 字节
+ * @param integer $width 二维码的宽度
+ * @param null|string $outType 输出类型
+ * @return array|string
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function createDefault($path, $width = 430, $outType = null)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/wxaapp/createwxaqrcode?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ $result = Tools::post($url, Tools::arr2json(['path' => $path, 'width' => $width]));
+ if (is_array($json = json_decode($result, true))) {
+ if (!$this->isTry && isset($json['errcode']) && in_array($json['errcode'], ['40014', '40001', '41001', '42001'])) {
+ [$this->delAccessToken(), $this->isTry = true];
+ return call_user_func_array([$this, $this->currentMethod['method']], $this->currentMethod['arguments']);
+ }
+ return Tools::json2arr($result);
+ }
+ return is_null($outType) ? $result : $outType($result);
+ }
+
+}
\ No newline at end of file
diff --git a/WeMini/Security.php b/WeMini/Security.php
new file mode 100644
index 0000000..5b1901f
--- /dev/null
+++ b/WeMini/Security.php
@@ -0,0 +1,70 @@
+registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['media' => $media], true);
+ }
+
+ /**
+ * 异步校验图片/音频是否含有违法违规内容
+ * @param string $media_url
+ * @param string $media_type
+ * @return array
+ * @throws InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function mediaCheckAsync($media_url, $media_type)
+ {
+ $url = 'https://api.weixin.qq.com/wxa/media_check_async?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['media_url' => $media_url, 'media_type' => $media_type], true);
+ }
+
+ /**
+ * 检查一段文本是否含有违法违规内容
+ * @param string $content
+ * @return array
+ * @throws InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function msgSecCheck($content)
+ {
+ $url = 'https://api.weixin.qq.com/wxa/msg_sec_check?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['content' => $content], true);
+ }
+}
\ No newline at end of file
diff --git a/WeMini/Soter.php b/WeMini/Soter.php
new file mode 100644
index 0000000..7890568
--- /dev/null
+++ b/WeMini/Soter.php
@@ -0,0 +1,40 @@
+registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+}
\ No newline at end of file
diff --git a/WeMini/Template.php b/WeMini/Template.php
new file mode 100644
index 0000000..516d407
--- /dev/null
+++ b/WeMini/Template.php
@@ -0,0 +1,110 @@
+registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['offset' => '0', 'count' => '20'], true);
+ }
+
+ /**
+ * 获取模板库某个模板标题下关键词库
+ * @param string $template_id 模板标题id，可通过接口获取，也可登录小程序后台查看获取
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getTemplateLibrary($template_id)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/wxopen/template/library/get?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['id' => $template_id], true);
+ }
+
+ /**
+ * 组合模板并添加至帐号下的个人模板库
+ * @param string $template_id 模板标题id，可通过接口获取，也可登录小程序后台查看获取
+ * @param array $keyword_id_list 开发者自行组合好的模板关键词列表，关键词顺序可以自由搭配（例如[3,5,4]或[4,5,3]），最多支持10个关键词组合
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function addTemplate($template_id, array $keyword_id_list)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/wxopen/template/add?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['id' => $template_id, 'keyword_id_list' => $keyword_id_list], true);
+ }
+
+ /**
+ * 获取帐号下已存在的模板列表
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getTemplateList()
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/wxopen/template/list?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['offset' => '0', 'count' => '20'], true);
+ }
+
+ /**
+ * 删除模板消息
+ * @param string $template_id 要删除的模板id
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function delTemplate($template_id)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/wxopen/template/del?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['template_id' => $template_id], true);
+ }
+
+ /**
+ * 发送模板消息
+ * @param array $data 发送的消息对象数组
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function send(array $data)
+ {
+ $url = 'https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, $data, true);
+ }
+
+}
\ No newline at end of file
diff --git a/WeMini/Total.php b/WeMini/Total.php
new file mode 100644
index 0000000..9d55a6b
--- /dev/null
+++ b/WeMini/Total.php
@@ -0,0 +1,176 @@
+registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['begin_date' => $begin_date, 'end_date' => $end_date], true);
+ }
+
+ /**
+ * 访问分析
+ * @param string $begin_date 开始日期
+ * @param string $end_date 结束日期，限定查询1天数据，end_date允许设置的最大值为昨日
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getWeanalysisAppidDailyVisittrend($begin_date, $end_date)
+ {
+ $url = 'https://api.weixin.qq.com/datacube/getweanalysisappiddailyvisittrend?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['begin_date' => $begin_date, 'end_date' => $end_date], true);
+ }
+
+ /**
+ * 周趋势
+ * @param string $begin_date 开始日期，为周一日期
+ * @param string $end_date 结束日期，为周日日期，限定查询一周数据
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getWeanalysisAppidWeeklyVisittrend($begin_date, $end_date)
+ {
+ $url = 'https://api.weixin.qq.com/datacube/getweanalysisappidweeklyvisittrend?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['begin_date' => $begin_date, 'end_date' => $end_date], true);
+ }
+
+ /**
+ * 月趋势
+ * @param string $begin_date 开始日期，为自然月第一天
+ * @param string $end_date 结束日期，为自然月最后一天，限定查询一个月数据
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getWeanalysisAppidMonthlyVisittrend($begin_date, $end_date)
+ {
+ $url = 'https://api.weixin.qq.com/datacube/getweanalysisappidmonthlyvisittrend?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['begin_date' => $begin_date, 'end_date' => $end_date], true);
+ }
+
+ /**
+ * 访问分布
+ * @param string $begin_date 开始日期
+ * @param string $end_date 结束日期，限定查询1天数据，end_date允许设置的最大值为昨日
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getWeanalysisAppidVisitdistribution($begin_date, $end_date)
+ {
+ $url = 'https://api.weixin.qq.com/datacube/getweanalysisappidvisitdistribution?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['begin_date' => $begin_date, 'end_date' => $end_date], true);
+ }
+
+ /**
+ * 日留存
+ * @param string $begin_date 开始日期
+ * @param string $end_date 结束日期，限定查询1天数据，end_date允许设置的最大值为昨日
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getWeanalysisAppidDailyRetaininfo($begin_date, $end_date)
+ {
+ $url = 'https://api.weixin.qq.com/datacube/getweanalysisappiddailyretaininfo?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['begin_date' => $begin_date, 'end_date' => $end_date], true);
+ }
+
+ /**
+ * 周留存
+ * @param string $begin_date 开始日期，为周一日期
+ * @param string $end_date 结束日期，为周日日期，限定查询一周数据
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getWeanalysisAppidWeeklyRetaininfo($begin_date, $end_date)
+ {
+ $url = 'https://api.weixin.qq.com/datacube/getweanalysisappidweeklyretaininfo?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['begin_date' => $begin_date, 'end_date' => $end_date], true);
+ }
+
+ /**
+ * 月留存
+ * @param string $begin_date 开始日期，为自然月第一天
+ * @param string $end_date 结束日期，为自然月最后一天，限定查询一个月数据
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getWeanalysisAppidMonthlyRetaininfo($begin_date, $end_date)
+ {
+ $url = 'https://api.weixin.qq.com/datacube/getweanalysisappidmonthlyretaininfo?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['begin_date' => $begin_date, 'end_date' => $end_date], true);
+ }
+
+ /**
+ * 访问页面
+ * @param string $begin_date 开始日期
+ * @param string $end_date 结束日期，限定查询1天数据，end_date允许设置的最大值为昨日
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getWeanalysisAppidVisitPage($begin_date, $end_date)
+ {
+ $url = 'https://api.weixin.qq.com/datacube/getweanalysisappidvisitpage?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['begin_date' => $begin_date, 'end_date' => $end_date], true);
+ }
+
+ /**
+ * 用户画像
+ * @param string $begin_date 开始日期
+ * @param string $end_date 结束日期，开始日期与结束日期相差的天数限定为0/6/29，分别表示查询最近1/7/30天数据，end_date允许设置的最大值为昨日
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function getWeanalysisAppidUserportrait($begin_date, $end_date)
+ {
+ $url = 'https://api.weixin.qq.com/datacube/getweanalysisappiduserportrait?access_token=ACCESS_TOKEN';
+ $this->registerApi($url, __FUNCTION__, func_get_args());
+ return $this->callPostApi($url, ['begin_date' => $begin_date, 'end_date' => $end_date], true);
+ }
+
+}
\ No newline at end of file
diff --git a/WeMini/crypt/errorCode.php b/WeMini/crypt/errorCode.php
new file mode 100644
index 0000000..a4f8e72
--- /dev/null
+++ b/WeMini/crypt/errorCode.php
@@ -0,0 +1,20 @@
+
+ * -41001: encodingAesKey 非法
+ * -41003: aes 解密失败
+ * -41004: 解密后得到的buffer非法
+ * -41005: base64加密失败
+ * -41016: base64解密失败
+ *
+ */
+class ErrorCode
+{
+ public static $OK = 0;
+ public static $IllegalAesKey = -41001;
+ public static $IllegalIv = -41002;
+ public static $IllegalBuffer = -41003;
+ public static $DecodeBase64Error = -41004;
+}
\ No newline at end of file
diff --git a/WeMini/crypt/wxBizDataCrypt.php b/WeMini/crypt/wxBizDataCrypt.php
new file mode 100644
index 0000000..d969638
--- /dev/null
+++ b/WeMini/crypt/wxBizDataCrypt.php
@@ -0,0 +1,57 @@
+appid = $appid;
+ $this->sessionKey = $sessionKey;
+ include_once __DIR__ . DIRECTORY_SEPARATOR . "errorCode.php";
+ }
+
+ /**
+ * 检验数据的真实性，并且获取解密后的明文.
+ * @param $encryptedData string 加密的用户数据
+ * @param $iv string 与用户数据一同返回的初始向量
+ * @param $data string 解密后的原文
+ *
+ * @return int 成功0，失败返回对应的错误码
+ */
+ public function decryptData($encryptedData, $iv, &$data)
+ {
+ if (strlen($this->sessionKey) != 24) {
+ return \ErrorCode::$IllegalAesKey;
+ }
+ $aesKey = base64_decode($this->sessionKey);
+ if (strlen($iv) != 24) {
+ return \ErrorCode::$IllegalIv;
+ }
+ $aesIV = base64_decode($iv);
+ $aesCipher = base64_decode($encryptedData);
+ $result = openssl_decrypt($aesCipher, "AES-128-CBC", $aesKey, 1, $aesIV);
+ $dataObj = json_decode($result);
+ if ($dataObj == null) {
+ return \ErrorCode::$IllegalBuffer;
+ }
+ if ($dataObj->watermark->appid != $this->appid) {
+ return \ErrorCode::$IllegalBuffer;
+ }
+ $data = $result;
+ return \ErrorCode::$OK;
+ }
+
+}
+
diff --git a/WePay/Bill.php b/WePay/Bill.php
new file mode 100644
index 0000000..4c853c7
--- /dev/null
+++ b/WePay/Bill.php
@@ -0,0 +1,63 @@
+params->set('sign_type', 'MD5');
+ $params = $this->params->merge($options);
+ $params['sign'] = $this->getPaySign($params, 'MD5');
+ $result = Tools::post('https://api.mch.weixin.qq.com/pay/downloadbill', Tools::arr2xml($params));
+ if (($jsonData = Tools::xml2arr($result))) {
+ if ($jsonData['return_code'] !== 'SUCCESS') {
+ throw new InvalidResponseException($jsonData['return_msg'], '0');
+ }
+ }
+ return is_null($outType) ? $result : $outType($result);
+ }
+
+
+ /**
+ * 拉取订单评价数据
+ * @param array $options
+ * @return array
+ * @throws InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function comment(array $options)
+ {
+ $url = 'https://api.mch.weixin.qq.com/billcommentsp/batchquerycomment';
+ return $this->callPostApi($url, $options, true);
+ }
+}
\ No newline at end of file
diff --git a/WePay/Coupon.php b/WePay/Coupon.php
new file mode 100644
index 0000000..92ca5c0
--- /dev/null
+++ b/WePay/Coupon.php
@@ -0,0 +1,65 @@
+callPostApi($url, $options, true);
+ }
+
+ /**
+ * 查询代金券批次
+ * @param array $options
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function queryStock(array $options)
+ {
+ $url = "https://api.mch.weixin.qq.com/mmpaymkttransfers/query_coupon_stock";
+ return $this->callPostApi($url, $options, false);
+ }
+
+ /**
+ * 查询代金券信息
+ * @param array $options
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function queryInfo(array $options)
+ {
+ $url = "https://api.mch.weixin.qq.com/mmpaymkttransfers/query_coupon_stock";
+ return $this->callPostApi($url, $options, false);
+ }
+
+}
\ No newline at end of file
diff --git a/WePay/Order.php b/WePay/Order.php
new file mode 100644
index 0000000..1d93288
--- /dev/null
+++ b/WePay/Order.php
@@ -0,0 +1,173 @@
+callPostApi($url, $options, false, 'MD5');
+ }
+
+ /**
+ * 刷卡支付
+ * @param array $options
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function micropay(array $options)
+ {
+ $url = 'https://api.mch.weixin.qq.com/pay/micropay';
+ return $this->callPostApi($url, $options, false, 'MD5');
+ }
+
+ /**
+ * 查询订单
+ * @param array $options
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function query(array $options)
+ {
+ $url = 'https://api.mch.weixin.qq.com/pay/orderquery';
+ return $this->callPostApi($url, $options);
+ }
+
+ /**
+ * 关闭订单
+ * @param string $outTradeNo 商户订单号
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function close($outTradeNo)
+ {
+ $url = 'https://api.mch.weixin.qq.com/pay/closeorder';
+ return $this->callPostApi($url, ['out_trade_no' => $outTradeNo]);
+ }
+
+ /**
+ * 创建JsApi及H5支付参数
+ * @param string $prepayId 统一下单预支付码
+ * @return array
+ */
+ public function jsapiParams($prepayId)
+ {
+ $option = [];
+ $option["appId"] = $this->config->get('appid');
+ $option["timeStamp"] = (string)time();
+ $option["nonceStr"] = Tools::createNoncestr();
+ $option["package"] = "prepay_id={$prepayId}";
+ $option["signType"] = "MD5";
+ $option["paySign"] = $this->getPaySign($option, 'MD5');
+ $option['timestamp'] = $option['timeStamp'];
+ return $option;
+ }
+
+ /**
+ * 获取支付规则二维码
+ * @param string $productId 商户定义的商品id或者订单号
+ * @return string
+ */
+ public function qrcParams($productId)
+ {
+ $data = [
+ 'appid' => $this->config->get('appid'),
+ 'mch_id' => $this->config->get('mch_id'),
+ 'time_stamp' => (string)time(),
+ 'nonce_str' => Tools::createNoncestr(),
+ 'product_id' => (string)$productId,
+ ];
+ $data['sign'] = $this->getPaySign($data, 'MD5');
+ return "weixin://wxpay/bizpayurl?" . http_build_query($data);
+ }
+
+ /**
+ * 获取微信App支付秘需参数
+ * @param string $prepayId 统一下单预支付码
+ * @return array
+ */
+ public function appParams($prepayId)
+ {
+ $data = [
+ 'appid' => $this->config->get('appid'),
+ 'partnerid' => $this->config->get('mch_id'),
+ 'prepayid' => (string)$prepayId,
+ 'package' => 'Sign=WXPay',
+ 'timestamp' => (string)time(),
+ 'noncestr' => Tools::createNoncestr(),
+ ];
+ $data['sign'] = $this->getPaySign($data, 'MD5');
+ return $data;
+ }
+
+ /**
+ * 刷卡支付 撤销订单
+ * @param array $options
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function reverse(array $options)
+ {
+ $url = 'https://api.mch.weixin.qq.com/secapi/pay/reverse';
+ return $this->callPostApi($url, $options, true);
+ }
+
+ /**
+ * 刷卡支付 授权码查询openid
+ * @param string $authCode 扫码支付授权码，设备读取用户微信中的条码或者二维码信息
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function queryAuthCode($authCode)
+ {
+ $url = 'https://api.mch.weixin.qq.com/tools/authcodetoopenid';
+ return $this->callPostApi($url, ['auth_code' => $authCode]);
+ }
+
+ /**
+ * 刷卡支付 交易保障
+ * @param array $options
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function report(array $options)
+ {
+ $url = 'https://api.mch.weixin.qq.com/payitil/report';
+ return $this->callPostApi($url, $options);
+ }
+}
\ No newline at end of file
diff --git a/WePay/Redpack.php b/WePay/Redpack.php
new file mode 100644
index 0000000..bf97ad8
--- /dev/null
+++ b/WePay/Redpack.php
@@ -0,0 +1,72 @@
+params->offsetUnset('appid');
+ $this->params->set('wxappid', $this->config->get('appid'));
+ $url = "https://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack";
+ return $this->callPostApi($url, $options, true, 'MD5', false);
+ }
+
+ /**
+ * 发放裂变红包
+ * @param array $options
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function groups(array $options)
+ {
+ $this->params->offsetUnset('appid');
+ $this->params->set('wxappid', $this->config->get('appid'));
+ $url = "https://api.mch.weixin.qq.com/mmpaymkttransfers/sendgroupredpack";
+ return $this->callPostApi($url, $options, true, 'MD5', false);
+ }
+
+ /**
+ * 查询红包记录
+ * @param string $mchBillno 商户发放红包的商户订单号
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function query($mchBillno)
+ {
+ $this->params->offsetUnset('wxappid');
+ $this->params->set('appid', $this->config->get('appid'));
+ $url = "https://api.mch.weixin.qq.com/mmpaymkttransfers/gethbinfo";
+ return $this->callPostApi($url, ['mch_billno' => $mchBillno, 'bill_type' => 'MCHT'], true, 'MD5', false);
+ }
+
+}
\ No newline at end of file
diff --git a/WePay/Refund.php b/WePay/Refund.php
new file mode 100644
index 0000000..8e3c199
--- /dev/null
+++ b/WePay/Refund.php
@@ -0,0 +1,78 @@
+callPostApi($url, $options, true);
+ }
+
+ /**
+ * 查询退款
+ * @param array $options
+ * @return array
+ * @throws InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function query(array $options)
+ {
+ $url = 'https://api.mch.weixin.qq.com/pay/refundquery';
+ return $this->callPostApi($url, $options);
+ }
+
+ /**
+ * 获取退款通知
+ * @return array
+ * @throws InvalidResponseException
+ */
+ public function getNotify()
+ {
+ $data = Tools::xml2arr(file_get_contents("php://input"));
+ if (!isset($data['return_code']) || $data['return_code'] !== 'SUCCESS') {
+ throw new InvalidResponseException('获取退款通知XML失败！');
+ }
+ if (!class_exists('Prpcrypt', false)) {
+ include dirname(__DIR__) . '/WeChat/Contracts/Prpcrypt.php';
+ }
+ $pc = new \Prpcrypt(md5($this->config->get('mch_key')));
+ $array = $pc->decrypt(base64_decode($data['req_info']));
+ if (intval($array[0]) > 0) {
+ throw new InvalidResponseException($array[1], $array[0]);
+ }
+ $data['decode'] = $array[1];
+ return $data;
+ }
+
+}
\ No newline at end of file
diff --git a/WePay/Transfers.php b/WePay/Transfers.php
new file mode 100644
index 0000000..89ff1d8
--- /dev/null
+++ b/WePay/Transfers.php
@@ -0,0 +1,61 @@
+params->offsetUnset('appid');
+ $this->params->offsetUnset('mch_id');
+ $this->params->set('mchid', $this->config->get('mch_id'));
+ $this->params->set('mch_appid', $this->config->get('appid'));
+ $url = 'https://api.mch.weixin.qq.com/mmpaymkttransfers/promotion/transfers';
+ return $this->callPostApi($url, $options, true, 'MD5', false);
+ }
+
+ /**
+ * 查询企业付款到零钱
+ * @param string $partnerTradeNo 商户调用企业付款API时使用的商户订单号
+ * @return array
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function query($partnerTradeNo)
+ {
+ $this->params->offsetUnset('mchid');
+ $this->params->offsetUnset('mch_appid');
+ $this->params->set('appid', $this->config->get('appid'));
+ $this->params->set('mch_id', $this->config->get('mch_id'));
+ $url = 'https://api.mch.weixin.qq.com/mmpaymkttransfers/gettransferinfo';
+ return $this->callPostApi($url, ['partner_trade_no' => $partnerTradeNo], true, 'MD5', false);
+ }
+
+}
\ No newline at end of file
diff --git a/WePay/TransfersBank.php b/WePay/TransfersBank.php
new file mode 100644
index 0000000..0509d01
--- /dev/null
+++ b/WePay/TransfersBank.php
@@ -0,0 +1,125 @@
+params->offsetUnset('appid');
+ return $this->callPostApi('https://api.mch.weixin.qq.com/mmpaysptrans/pay_bank', [
+ 'amount' => $options['amount'],
+ 'bank_code' => $options['bank_code'],
+ 'partner_trade_no' => $options['partner_trade_no'],
+ 'enc_bank_no' => $this->rsaEncode($options['enc_bank_no']),
+ 'enc_true_name' => $this->rsaEncode($options['enc_true_name']),
+ 'desc' => isset($options['desc']) ? $options['desc'] : '',
+ ], true, 'MD5', false);
+ }
+
+ /**
+ * 商户企业付款到银行卡操作进行结果查询
+ * @param string $partnerTradeNo 商户订单号，需保持唯一
+ * @return array
+ * @throws InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ public function query($partnerTradeNo)
+ {
+ $this->params->offsetUnset('appid');
+ $url = 'https://api.mch.weixin.qq.com/mmpaysptrans/query_bank';
+ return $this->callPostApi($url, ['partner_trade_no' => $partnerTradeNo], true, 'MD5', false);
+ }
+
+ /**
+ * RSA加密处理
+ * @param string $string
+ * @param string $encrypted
+ * @return string
+ * @throws \WeChat\Exceptions\InvalidDecryptException
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ private function rsaEncode($string, $encrypted = '')
+ {
+ $search = ['-----BEGIN RSA PUBLIC KEY-----', '-----END RSA PUBLIC KEY-----', "\n", "\r"];
+ $pkc1 = str_replace($search, '', $this->getRsaContent());
+ $publicKey = '-----BEGIN PUBLIC KEY-----' . PHP_EOL .
+ wordwrap('MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A' . $pkc1, 64, PHP_EOL, true) . PHP_EOL .
+ '-----END PUBLIC KEY-----';
+ if (!openssl_public_encrypt("{$string}", $encrypted, $publicKey, OPENSSL_PKCS1_OAEP_PADDING)) {
+ throw new InvalidDecryptException('Rsa Encrypt Error.');
+ }
+ return base64_encode($encrypted);
+ }
+
+ /**
+ * 获取签名文件内容
+ * @return string
+ * @throws \WeChat\Exceptions\InvalidResponseException
+ * @throws \WeChat\Exceptions\LocalCacheException
+ */
+ private function getRsaContent()
+ {
+ $cacheKey = "pub_ras_key_" . $this->config->get('mch_id');
+ if (($pub_key = Tools::getCache($cacheKey))) {
+ return $pub_key;
+ }
+ $data = $this->callPostApi('https://fraud.mch.weixin.qq.com/risk/getpublickey', [], true, 'MD5');
+ if (!isset($data['return_code']) || $data['return_code'] !== 'SUCCESS' || $data['result_code'] !== 'SUCCESS') {
+ $error = 'ResultError:' . $data['return_msg'];
+ $error .= isset($data['err_code_des']) ? ' - ' . $data['err_code_des'] : '';
+ throw new InvalidResponseException($error, 20000, $data);
+ }
+ Tools::setCache($cacheKey, $data['pub_key'], 600);
+ return $data['pub_key'];
+ }
+
+}
\ No newline at end of file
diff --git a/_test/alipay-app.php b/_test/alipay-app.php
new file mode 100644
index 0000000..0070eb3
--- /dev/null
+++ b/_test/alipay-app.php
@@ -0,0 +1,39 @@
+apply([
+ 'out_trade_no' => time(), // 商户订单号
+ 'total_amount' => '1', // 支付金额
+ 'subject' => 'test subject', // 支付订单描述
+ ]);
+ echo '';
+ var_export($result);
+} catch (\Exception $e) {
+ echo $e->getMessage();
+}
+
+
diff --git a/_test/alipay-bill.php b/_test/alipay-bill.php
new file mode 100644
index 0000000..af5c493
--- /dev/null
+++ b/_test/alipay-bill.php
@@ -0,0 +1,36 @@
+apply([
+ 'bill_date' => '2018-10-03', // 账单时间(日账单yyyy-MM-dd,月账单 yyyy-MM)
+ 'bill_type' => 'signcustomer', // 账单类型(trade指商户基于支付宝交易收单的业务账单,signcustomer是指基于商户支付宝余额收入及支出等资金变动的帐务账单)
+ ]);
+ echo '';
+ var_export($result);
+} catch (Exception $e) {
+ echo $e->getMessage();
+}
\ No newline at end of file
diff --git a/_test/alipay-notify.php b/_test/alipay-notify.php
new file mode 100644
index 0000000..0d59116
--- /dev/null
+++ b/_test/alipay-notify.php
@@ -0,0 +1,39 @@
+notify();
+ if (in_array($data['trade_status'], ['TRADE_SUCCESS', 'TRADE_FINISHED'])) {
+ // @todo 更新订单状态，支付完成
+ file_put_contents('notify.txt', "收到来自支付宝的异步通知\r\n", FILE_APPEND);
+ file_put_contents('notify.txt', '订单号：' . $data['out_trade_no'] . "\r\n", FILE_APPEND);
+ file_put_contents('notify.txt', '订单金额：' . $data['total_amount'] . "\r\n\r\n", FILE_APPEND);
+ } else {
+ file_put_contents('notify.txt', "收到异步通知\r\n", FILE_APPEND);
+ }
+} catch (\Exception $e) {
+ // 异常处理
+ echo $e->getMessage();
+}
diff --git a/_test/alipay-pos.php b/_test/alipay-pos.php
new file mode 100644
index 0000000..e55c4e2
--- /dev/null
+++ b/_test/alipay-pos.php
@@ -0,0 +1,41 @@
+apply([
+ 'out_trade_no' => '4312412343', // 订单号
+ 'total_amount' => '13', // 订单金额，单位：元
+ 'subject' => '订单商品标题', // 订单商品标题
+ 'auth_code' => '123456', // 授权码
+ ]);
+
+ echo '';
+ var_export($result);
+} catch (Exception $e) {
+ echo $e->getMessage();
+}
+
+
diff --git a/_test/alipay-refund.php b/_test/alipay-refund.php
new file mode 100644
index 0000000..487ca7b
--- /dev/null
+++ b/_test/alipay-refund.php
@@ -0,0 +1,39 @@
+refund($out_trade_no, $refund_fee);
+
+ echo '';
+ var_export($result);
+} catch (Exception $e) {
+ echo $e->getMessage();
+}
\ No newline at end of file
diff --git a/_test/alipay-scan.php b/_test/alipay-scan.php
new file mode 100644
index 0000000..2bc8806
--- /dev/null
+++ b/_test/alipay-scan.php
@@ -0,0 +1,40 @@
+apply([
+ 'out_trade_no' => '14321412', // 订单号
+ 'total_amount' => '13', // 订单金额，单位：元
+ 'subject' => '订单商品标题', // 订单商品标题
+ ]);
+
+ echo '';
+ var_export($result);
+} catch (Exception $e) {
+ echo $e->getMessage();
+}
+
+
diff --git a/_test/alipay-transfer.php b/_test/alipay-transfer.php
new file mode 100644
index 0000000..4eaf6fb
--- /dev/null
+++ b/_test/alipay-transfer.php
@@ -0,0 +1,43 @@
+apply([
+ 'out_biz_no' => time(), // 订单号
+ 'payee_type' => 'ALIPAY_LOGONID', // 收款方账户类型(ALIPAY_LOGONID | ALIPAY_USERID)
+ 'payee_account' => 'demo@sandbox.com', // 收款方账户
+ 'amount' => '10', // 转账金额
+ 'payer_show_name' => '未寒', // 付款方姓名
+ 'payee_real_name' => '张三', // 收款方真实姓名
+ 'remark' => '张三', // 转账备注
+ ]);
+
+ echo '';
+ var_export($result);
+} catch (Exception $e) {
+ echo $e->getMessage();
+}
+
diff --git a/_test/alipay-wap.php b/_test/alipay-wap.php
new file mode 100644
index 0000000..ac04021
--- /dev/null
+++ b/_test/alipay-wap.php
@@ -0,0 +1,42 @@
+apply([
+ 'out_trade_no' => time(), // 商户订单号
+ 'total_amount' => '1', // 支付金额
+ 'subject' => '支付订单描述', // 支付订单描述
+ ]);
+
+ echo $result;
+} catch (Exception $e) {
+ echo $e->getMessage();
+}
+
+
diff --git a/_test/alipay-web.php b/_test/alipay-web.php
new file mode 100644
index 0000000..46f0efc
--- /dev/null
+++ b/_test/alipay-web.php
@@ -0,0 +1,43 @@
+apply([
+ 'out_trade_no' => time(), // 商户订单号
+ 'total_amount' => '1', // 支付金额
+ 'subject' => '支付订单描述', // 支付订单描述
+ ]);
+
+ echo $result;
+} catch (Exception $e) {
+ echo $e->getMessage();
+}
+
+
diff --git a/_test/alipay.php b/_test/alipay.php
new file mode 100644
index 0000000..25a7379
--- /dev/null
+++ b/_test/alipay.php
@@ -0,0 +1,30 @@
+ true,
+ // 签名类型（RSA|RSA2）
+ 'sign_type' => "RSA2",
+ // 应用ID
+ 'appid' => '2016090900468879',
+ // 支付宝公钥(1行填写，特别注意，这里是支付宝公钥，不是应用公钥，最好从开发者中心的网页上去复制)
+ 'public_key' => 'MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtU71NY53UDGY7JNvLYAhsNa+taTF6KthIHJmGgdio9bkqeJGhHk6ttkTKkLqFgwIfgAkHpdKiOv1uZw6gVGZ7TCu5LfHTqKrCd6Uz+N7hxhY+4IwicLgprcV1flXQLmbkJYzFMZqkXGkSgOsR2yXh4LyQZczgk9N456uuzGtRy7MoB4zQy34PLUkkxR6W1B2ftNbLRGXv6tc7p/cmDcrY6K1bSxnGmfRxFSb8lRfhe0V0UM6pKq2SGGSeovrKHN0OLp+Nn5wcULVnFgATXGCENshRlp96piPEBFwneXs19n+sX1jx60FTR7/rME3sW3AHug0fhZ9mSqW4x401WjdnwIDAQAB',
+ // 支付宝私钥(1行填写)
+ 'private_key' => 'MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC3pbN7esinxgjE8uxXAsccgGNKIq+PR1LteNTFOy0fsete43ObQCrzd9DO0zaUeBUzpIOnxrKxez7QoZROZMYrinttFZ/V5rbObEM9E5AR5Tv/Fr4IBywoS8ZtN16Xb+fZmibfU91yq9O2RYSvscncU2qEYmmaTenM0QlUO80ZKqPsM5JkgCNdcYZTUeHclWeyER3dSImNtlSKiSBSSTHthb11fkudjzdiUXua0NKVWyYuAOoDMcpXbD6NJmYqEA/iZ/AxtQt08pv0Mow581GPB0Uop5+qA2hCV85DpagE94a067sKcRui0rtkJzHem9k7xVL+2RoFm1fv3RnUkMwhAgMBAAECggEAAetkddzxrfc+7jgPylUIGb8pyoOUTC4Vqs/BgZI9xYAJksNT2QKRsFvHPfItNt4Ocqy8h4tnIL3GCU43C564B4p6AcjhE85GiN/O0BudPOKlfuQQ9mqExqMMHuYeQfz0cmzPDTSGMwWiv9v4KBH2pyvkCCAzNF6uG+rvawb4/NNVuiI7C8Ku/wYsamtbgjMZVOFFdScYgIw1BgA99RUU/fWBLMnTQkoyowSRb9eSmEUHjt/WQt+/QgKAT2WmuX4RhaGy0qcQLbNaJNKXdJ+PVhQrSiasINNtqYMa8GsQuuKsk3X8TCg9K6/lowivt5ruhyWcP2sx93zY/LGzIHgHcQKBgQDoZlcs9RWxTdGDdtH8kk0J/r+QtMijNzWI0a+t+ZsWOyd3rw+uM/8O4JTNP4Y98TvvxhJXewITbfiuOIbW1mxh8bnO/fcz7+RXZKgPDeoTeNo717tZFZGBEyUdH9M9Inqvht7+hjVDIMCYBDomYebdk3Xqo4mDBjLRdVNGrhGmVQKBgQDKS/MgTMK8Ktfnu1KzwCbn/FfHTOrp1a1t1wWPv9AW0rJPYeaP6lOkgIoO/1odG9qDDhdB6njqM+mKY5Yr3N94PHamHbwJUCmbkqEunCWpGzgcQZ1Q254xk9D7UKq/XUqW2WDqDq80GQeNial+fBc46yelQzokwdA+JdIFKoyinQKBgQCBems9V/rTAtkk1nFdt6EGXZEbLS3PiXXhGXo4gqV+OEzf6H/i/YMwJb2hsK+5GQrcps0XQihA7PctEb9GOMa/tu5fva0ZmaDtc94SLR1p5d4okyQFGPgtIp594HpPSEN0Qb9BrUJFeRz0VP6U3dzDPGHo7V4yyqRLgIN6EIcy1QKBgAqdh6mHPaTAHspDMyjJiYEc5cJIj/8rPkmIQft0FkhMUB0IRyAALNlyAUyeK61hW8sKvz+vPR8VEEk5xpSQp41YpuU6pDZc5YILZLfca8F+8yfQbZ/jll6Foi694efezl4yE/rUQG9cbOAJfEJt4o4TEOaEK5XoMbRBKc8pl22lAoGARTq0qOr9SStihRAy9a+8wi2WEwL4QHcmOjH7iAuJxy5b5TRDSjlk6h+0dnTItiFlTXdfpO8KhWA8EoSJVBZ1kcACQDFgMIA+VM+yXydtzMotOn21W4stfZ4I6dHFiujMsnKpNYVpQh3oCrJf4SeXiQDdiSCodqb1HlKkEc6naHQ=',
+ // 支付成功通知地址
+ 'notify_url' => '',
+ // 网页支付回跳地址
+ 'return_url' => '',
+];
\ No newline at end of file
diff --git a/_test/config.php b/_test/config.php
new file mode 100644
index 0000000..e6f8075
--- /dev/null
+++ b/_test/config.php
@@ -0,0 +1,45 @@
+ function ($name, $value, $expired = 360) {
+// var_dump(func_get_args());
+// },
+// 'get' => function ($name) {
+// var_dump(func_get_args());
+// },
+// 'del' => function ($name) {
+// var_dump(func_get_args());
+// },
+// 'put' => function ($name) {
+// var_dump(func_get_args());
+// },
+//];
+
+return [
+ 'token' => 'test',
+ 'appid' => 'wx60a43dd8161666d4',
+ 'appsecret' => 'b4e28746f1bd73b5c6684f5e01883c36',
+ 'encodingaeskey' => 'BJIUzE0gqlWy0GxfPp4J1oPTBmOrNDIGPNav1YFH5Z5',
+ // 配置商户支付参数
+ 'mch_id' => "1332187001",
+ 'mch_key' => 'A82DC5BD1F3359081049C568D8502BC5',
+ // 配置商户支付双向证书目录 （p12 | key,cert 二选一，两者都配置时p12优先）
+ 'ssl_p12' => __DIR__ . DIRECTORY_SEPARATOR . 'cert' . DIRECTORY_SEPARATOR . '1332187001_20181030_cert.p12',
+ // 'ssl_key' => __DIR__ . DIRECTORY_SEPARATOR . 'cert' . DIRECTORY_SEPARATOR . '1332187001_20181030_key.pem',
+ // 'ssl_cer' => __DIR__ . DIRECTORY_SEPARATOR . 'cert' . DIRECTORY_SEPARATOR . '1332187001_20181030_cert.pem',
+ // 配置缓存目录，需要拥有写权限
+ 'cache_path' => '',
+];
\ No newline at end of file
diff --git a/_test/mini-login.php b/_test/mini-login.php
new file mode 100644
index 0000000..c6f56ba
--- /dev/null
+++ b/_test/mini-login.php
@@ -0,0 +1,24 @@
+ 'wx6bb7b70258da09c6',
+ 'appsecret' => '78b7b8d65bd67b078babf951d4342b42',
+];
+
+// 解码数据
+$iv = 'ltM/wT7hsAl0TijEBI4v/g==';
+$code = '013LyiTR0TwjC92QjJRR0mEsTR0LyiT3';
+$decode = 'eIoVtIC2YzLCnrwiIs1IBbXMvC0vyL8bo1IhD38fUQIRbk3lgTWa0Hdw/Ty7NTs3iu7YlqqZBti+cxd6dCfeXBUQwTO2QpbHg0WTeDAdrihsHRHm4dCWdfTx8rzDloGbNOIsKdRElIhUH5YFdiTr5AYiufUDb34cwJ4GNWLAUq4bR0dmFeVEi+3nfwe2MAjGYDl4aq719VLsHodOggK6lXZvM5wjoDyuZsK2dPqJr3/Ji30Z0mdyFq32R4uR3rtJH/h+Rj0+/QmE9QYG7Y6Z48hgPE8cpnhRQNwH49jnC/zKZ9wtDkQ/J8J3Ed2i58zcuY01v8IV+pZ8oBUKXfO5ha+APOxtBSTzyHraU/2RGo8UWtOF6h64OQZhd/UQQy362eyc/qoq8sF9JnEFRP0mRmTDJ+u9oyDhxswCu6x8V73ERWaJeEGSCyjiGpep7/DxZ6eSSBq36OB0BWBkJqsq9Q==';
+$sessionKey = 'OetNxl86B/yMpbwG6wtMEw==';
+
+// $mini = \We::WeMiniCrypt($config);
+// $mini = new WeMini\Crypt($config);
+$mini = \WeMini\Crypt::instance($config);
+
+echo '';
+//print_r($mini->session($code));
+print_r($mini->decode($iv, $sessionKey, $decode));
+//print_r($mini->userInfo($code, $iv, $decode));
\ No newline at end of file
diff --git a/_test/mini-qrc.php b/_test/mini-qrc.php
new file mode 100644
index 0000000..84ca9d6
--- /dev/null
+++ b/_test/mini-qrc.php
@@ -0,0 +1,25 @@
+ 'wx6bb7b70258da09c6',
+ 'appsecret' => '78b7b8d65bd67b078babf951d4342b42',
+];
+
+//We::config($config);
+
+// $mini = We::WeMiniQrcode($config);
+// $mini = new WeMini\Qrcode($config);
+$mini = \WeMini\Qrcode::instance($config);
+
+//echo '';
+try {
+ header('Content-type:image/jpeg'); //输出的类型
+// echo $mini->createDefault('pages/index?query=1');
+// echo $mini->createMiniScene('432432', 'pages/index/index');
+ echo $mini->createMiniPath('pages/index?query=1');
+} catch (Exception $e) {
+ var_dump($e->getMessage());
+}
diff --git a/Test/pay-download-bill.php b/_test/pay-download-bill.php
similarity index 90%
rename from Test/pay-download-bill.php
rename to _test/pay-download-bill.php
index c0181fb..ffac45b 100644
--- a/Test/pay-download-bill.php
+++ b/_test/pay-download-bill.php
@@ -21,7 +21,9 @@ try {
$config = include "./config.php";
// 3. 创建接口实例
- $wechat = new \WeChat\Pay($config);
+ // $wechat = new \WeChat\Pay($config);
+ // $wechat = \We::WeChatPay($config);
+ $wechat = \WeChat\Pay::instance($config);
// 4. 组装参数，可以参考官方商户文档
$options = [
diff --git a/Test/pay-order-close.php b/_test/pay-order-close.php
similarity index 90%
rename from Test/pay-order-close.php
rename to _test/pay-order-close.php
index 3a31ddc..eeead4a 100644
--- a/Test/pay-order-close.php
+++ b/_test/pay-order-close.php
@@ -21,7 +21,9 @@ try {
$config = include "./config.php";
// 3. 创建接口实例
- $wechat = new \WeChat\Pay($config);
+ // $wechat = new \WeChat\Pay($config);
+ // $wechat = \We::WeChatPay($config);
+ $wechat = \WeChat\Pay::instance($config);
// 4. 组装参数，可以参考官方商户文档
$options = '1217752501201407033233368018';
diff --git a/Test/pay-order-create.php b/_test/pay-order-create.php
similarity index 79%
rename from Test/pay-order-create.php
rename to _test/pay-order-create.php
index 9d4b5e7..e9c9f20 100644
--- a/Test/pay-order-create.php
+++ b/_test/pay-order-create.php
@@ -21,7 +21,9 @@ try {
$config = include "./config.php";
// 3. 创建接口实例
- $wechat = new \WeChat\Pay($config);
+ // $wechat = new \WeChat\Pay($config);
+ // $wechat = \We::WeChatPay($config);
+ $wechat = \WeChat\Pay::instance($config);
// 4. 组装参数，可以参考官方商户文档
$options = [
@@ -33,10 +35,18 @@ try {
'notify_url' => 'http://a.com/text.html',
'spbill_create_ip' => '127.0.0.1',
];
+ // 生成预支付码
$result = $wechat->createOrder($options);
+ // 创建JSAPI参数签名
+ $options = $wechat->createParamsForJsApi($result['prepay_id']);
+ echo '';
+ echo "\n--- 创建预支付码 ---\n";
var_export($result);
+ echo "\n\n--- JSAPI 及 H5 参数 ---\n";
+ var_export($options);
+
} catch (Exception $e) {
// 出错啦，处理下吧
diff --git a/_test/pay-order-notify.php b/_test/pay-order-notify.php
new file mode 100644
index 0000000..7484aac
--- /dev/null
+++ b/_test/pay-order-notify.php
@@ -0,0 +1,44 @@
+getNotify();
+ if ($data['return_code'] === 'SUCCESS' && $data['result_code'] === 'SUCCESS') {
+ // @todo 去更新下原订单的支付状态
+ $order_no = $data['out_trade_no'];
+
+ // 返回接收成功的回复
+ ob_clean();
+ echo $wechat->getNotifySuccessReply();
+ }
+
+} catch (Exception $e) {
+
+ // 出错啦，处理下吧
+ echo $e->getMessage() . PHP_EOL;
+
+}
diff --git a/Test/pay-order-query.php b/_test/pay-order-query.php
similarity index 90%
rename from Test/pay-order-query.php
rename to _test/pay-order-query.php
index d993488..b7edf34 100644
--- a/Test/pay-order-query.php
+++ b/_test/pay-order-query.php
@@ -21,7 +21,9 @@ try {
$config = include "./config.php";
// 3. 创建接口实例
- $wechat = new \WeChat\Pay($config);
+ // $wechat = new \WeChat\Pay($config);
+ // $wechat = \We::WeChatPay($config);
+ $wechat = \WeChat\Pay::instance($config);
// 4. 组装参数，可以参考官方商户文档
$options = [
diff --git a/_test/pay-redpack-create.php b/_test/pay-redpack-create.php
new file mode 100644
index 0000000..c45dade
--- /dev/null
+++ b/_test/pay-redpack-create.php
@@ -0,0 +1,53 @@
+ time(),
+ 're_openid' => 'o38gps3vNdCqaggFfrBRCRikwlWY',
+ 'send_name' => '商户名称😍',
+ 'act_name' => '活动名称',
+ 'total_amount' => '100',
+ 'total_num' => '1',
+ 'wishing' => '感谢您参加猜灯谜活动，祝您元宵节快乐！',
+ 'remark' => '猜越多得越多，快来抢！',
+ 'client_ip' => '127.0.0.1',
+ ];
+ // 发送红包记录
+ $result = $wechat->create($options);
+ echo '';
+ var_export($result);
+ // 查询红包记录
+ $result = $wechat->query($options['mch_billno']);
+ var_export($result);
+
+} catch (Exception $e) {
+
+ // 出错啦，处理下吧
+ echo $e->getMessage() . PHP_EOL;
+
+}
\ No newline at end of file
diff --git a/Test/pay-refund-create.php b/_test/pay-refund-create.php
similarity index 91%
rename from Test/pay-refund-create.php
rename to _test/pay-refund-create.php
index 02b554b..8e3df01 100644
--- a/Test/pay-refund-create.php
+++ b/_test/pay-refund-create.php
@@ -21,7 +21,9 @@ try {
$config = include "./config.php";
// 3. 创建接口实例
- $wechat = new \WeChat\Pay($config);
+ // $wechat = new \WeChat\Pay($config);
+ // $wechat = \We::WeChatPay($config);
+ $wechat = \WeChat\Pay::instance($config);
// 4. 组装参数，可以参考官方商户文档
$options = [
diff --git a/Test/pay-refund-query.php b/_test/pay-refund-query.php
similarity index 91%
rename from Test/pay-refund-query.php
rename to _test/pay-refund-query.php
index a812ac4..fa63acc 100644
--- a/Test/pay-refund-query.php
+++ b/_test/pay-refund-query.php
@@ -21,7 +21,9 @@ try {
$config = include "./config.php";
// 3. 创建接口实例
- $wechat = new \WeChat\Pay($config);
+ // $wechat = new \WeChat\Pay($config);
+ // $wechat = \We::WeChatPay($config);
+ $wechat = \WeChat\Pay::instance($config);
// 4. 组装参数，可以参考官方商户文档
$options = [
diff --git a/_test/pay-transfers-create.php b/_test/pay-transfers-create.php
new file mode 100644
index 0000000..659d888
--- /dev/null
+++ b/_test/pay-transfers-create.php
@@ -0,0 +1,48 @@
+ time(),
+ 'openid' => 'o38gps3vNdCqaggFfrBRCRikwlWY',
+ 'check_name' => 'NO_CHECK',
+ 'amount' => '100',
+ 'desc' => '企业付款操作说明信息',
+ 'spbill_create_ip' => '127.0.0.1',
+ ];
+ $result = $wechat->createTransfers($options);
+ echo '';
+ var_export($result);
+ $result = $wechat->queryTransfers($options['partner_trade_no']);
+ var_export($result);
+
+} catch (Exception $e) {
+
+ // 出错啦，处理下吧
+ echo $e->getMessage() . PHP_EOL;
+
+}
\ No newline at end of file
diff --git a/_test/pay-transfersbank-create.php b/_test/pay-transfersbank-create.php
new file mode 100644
index 0000000..ca3979e
--- /dev/null
+++ b/_test/pay-transfersbank-create.php
@@ -0,0 +1,46 @@
+ time(),
+ 'enc_bank_no' => '6212263602037318102',
+ 'enc_true_name' => '邹景立',
+ 'bank_code' => '1002',
+ 'amount' => '100',
+ 'desc' => '打款测试',
+ ];
+ echo '';
+ $result = $wechat->createTransfersBank($options);
+ var_export($result);
+
+} catch (Exception $e) {
+
+ // 出错啦，处理下吧
+ echo $e->getMessage() . PHP_EOL;
+
+}
\ No newline at end of file
diff --git a/Test/wechat-jssdk-sign.php b/_test/wechat-jssdk-sign.php
similarity index 88%
rename from Test/wechat-jssdk-sign.php
rename to _test/wechat-jssdk-sign.php
index 8986cf2..6a3b698 100644
--- a/Test/wechat-jssdk-sign.php
+++ b/_test/wechat-jssdk-sign.php
@@ -21,7 +21,9 @@ try {
$config = include "./config.php";
// 3. 创建接口实例
- $wechat = new \WeChat\Script($config);
+ // $wechat = \We::WeChatScript($config);
+ // $wechat = new \WeChat\Script($config);
+ $wechat = \WeChat\Script::instance($config);
// 4. 获取JSSDK网址签名配置
$result = $wechat->getJsSign('http://a.com/test.php');
diff --git a/Test/wechat-menu-get.php b/_test/wechat-menu-get.php
similarity index 89%
rename from Test/wechat-menu-get.php
rename to _test/wechat-menu-get.php
index 31f18b0..5447aad 100644
--- a/Test/wechat-menu-get.php
+++ b/_test/wechat-menu-get.php
@@ -21,11 +21,13 @@ try {
$config = include "./config.php";
// 3. 创建接口实例
- $menu = new \WeChat\Menu($config);
+ // $menu = \We::WeChatMenu($config);
+ // $menu = new \WeChat\Menu($config);
+ $menu = \WeChat\Menu::instance($config);
// 4. 获取菜单数据
$result = $menu->get();
-
+
var_export($result);
} catch (Exception $e) {
diff --git a/Test/wechat-qrcode-create.php b/_test/wechat-qrcode-create.php
similarity index 89%
rename from Test/wechat-qrcode-create.php
rename to _test/wechat-qrcode-create.php
index e7daa79..256e30a 100644
--- a/Test/wechat-qrcode-create.php
+++ b/_test/wechat-qrcode-create.php
@@ -21,7 +21,9 @@ try {
$config = include "./config.php";
// 3. 创建接口实例
- $wechat = new \WeChat\Qrcode($config);
+ // $wechat = \We::WeChatQrcode($config);
+ // $wechat = new \WeChat\Qrcode($config);
+ $wechat = \WeChat\Qrcode::instance($config);
// 4. 获取用户列表
$result = $wechat->create('场景内容');
diff --git a/Test/wechat-user-get.php b/_test/wechat-user-get.php
similarity index 89%
rename from Test/wechat-user-get.php
rename to _test/wechat-user-get.php
index 5517afa..d42cb56 100644
--- a/Test/wechat-user-get.php
+++ b/_test/wechat-user-get.php
@@ -21,11 +21,14 @@ try {
$config = include "./config.php";
// 3. 创建接口实例
- $wechat = new \WeChat\User($config);
+ // $wechat = \We::WeChatUser($config);
+ // $wechat = new \WeChat\User($config);
+ $wechat = \WeChat\User::instance($config);
// 4. 获取用户列表
$result = $wechat->getUserList();
+ echo '';
var_export($result);
// 5. 批量获取用户资料
diff --git a/composer.json b/composer.json
index c06a697..d8ee7c1 100644
--- a/composer.json
+++ b/composer.json
@@ -12,18 +12,31 @@
}
],
"keywords": [
+ "WePay",
+ "AliPay",
+ "WeMini",
"WeChat",
"WeChatPay",
"WeChatDeveloper"
],
"require": {
"php": ">=5.4",
+ "ext-json": "*",
"ext-curl": "*",
- "ext-openssl": "*"
+ "ext-libxml": "*",
+ "ext-openssl": "*",
+ "ext-mbstring": "*",
+ "ext-simplexml": "*"
},
"autoload": {
+ "classmap": [
+ "We.php"
+ ],
"psr-4": {
- "WeChat\\": "WeChat"
+ "WePay\\": "WePay",
+ "WeMini\\": "WeMini",
+ "WeChat\\": "WeChat",
+ "AliPay\\": "AliPay"
}
}
}
\ No newline at end of file
diff --git a/include.php b/include.php
index b8f402c..e88c70e 100644
--- a/include.php
+++ b/include.php
@@ -12,10 +12,16 @@
// | github开源项目：https://github.com/zoujingli/WeChatDeveloper
// +----------------------------------------------------------------------
-// 动态注册SDK自动加载
spl_autoload_register(function ($classname) {
- $filename = __DIR__ . DIRECTORY_SEPARATOR . str_replace('\\', DIRECTORY_SEPARATOR, $classname) . '.php';
- if (stripos($classname, 'WeChat') === 0 && file_exists($filename)) {
- include $filename;
+ $pathname = __DIR__ . DIRECTORY_SEPARATOR;
+ $filename = str_replace('\\', DIRECTORY_SEPARATOR, $classname) . '.php';
+ if (file_exists($pathname . $filename)) {
+ foreach (['WeChat', 'WeMini', 'AliPay', 'WePay', 'We'] as $prefix) {
+ if (stripos($classname, $prefix) === 0) {
+ include $pathname . $filename;
+ return true;
+ }
+ }
}
+ return false;
});
\ No newline at end of file
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..529d1f4
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,267 @@
+[](https://packagist.org/packages/zoujingli/wechat-developer)
+[](https://packagist.org/packages/zoujingli/wechat-developer)
+[](https://packagist.org/packages/zoujingli/wechat-developer)
+[](https://packagist.org/packages/zoujingli/wechat-developer)
+
+WeChatDeveloper for PHP
+----
+* WeChatDeveloper 是基于 [wechat-php-sdk](https://github.com/zoujingli/wechat-php-sdk) 重构，优化并完善；
+* 运行最底要求 PHP 版本 5.4 , 建议在 PHP7 上运行以获取最佳性能；
+* WeChatDeveloper 针对 access_token 失效增加了自动刷新机制；
+* 微信的部分接口需要缓存数据在本地，因此对目录需要有写权限；
+* 我们鼓励大家使用 composer 来管理您的第三方库，方便后期更新操作；
+* WeChatDeveloper 已历经数个线上项目考验，欢迎 fork 或 star 此项目。
+
+功能描述
+----
+* 微信小程序，服务端接口支持
+* 微信认证服务号，服务端接口支持
+* 微信支付（账单、卡券、红包、退款、转账、App支付、JSAPI支付、Web支付、扫码支付等）
+* 支付宝支付（账单、转账、App支付、刷卡支付、扫码支付、Web支付、Wap支付等）
+
+技术帮助
+----
+PHP开发技术交流（QQ群 513350915）
+
+[](http://shang.qq.com/wpa/qunwpa?idkey=ae25cf789dafbef62e50a980ffc31242f150bc61a61164458216dd98c411832a)
+
+WeChatDeveloper 是基于官方接口封装，在做微信开发前，必需先阅读微信官方文档。
+* 微信官方文档：https://mp.weixin.qq.com/wiki
+* 商户支付文档：https://pay.weixin.qq.com/wiki/doc/api/index.html
+
+针对 WeChatDeveloper 也有一准备了帮助资料可供参考。
+* ThinkAdmin：https://github.com/zoujingli/ThinkAdmin
+* WeChatDeveloper：https://www.kancloud.cn/zoujingli/wechat-developer
+
+
+代码仓库
+----
+WeChatDeveloper 为开源项目，允许把它用于任何地方，不受任何约束，欢迎 fork 项目。
+* Gitee 托管地址：https://gitee.com/zoujingli/WeChatDeveloper
+* GitHub 托管地址：https://github.com/zoujingli/WeChatDeveloper
+
+文件说明
+----
+
+|文件名|类名|描述|类型|加载 ①|
+|---|---|---|---|---|
+| App.php | AliPay\App | 支付宝App支付 | 支付宝支付 | \We::AliPayApp() |
+| Bill.php | AliPay\Bill | 支付宝账单下载 | 支付宝支付 | \We::AliPayBill() |
+| Pos.php | AliPay\Pos | 支付宝刷卡支付 | 支付宝支付 | \We::AliPayPos() |
+| Scan.php | AliPay\Scan | 支付宝扫码支付 | 支付宝支付 | \We::AliPayScan() |
+| Transfer.php | AliPay\Transfer | 支付宝转账 | 支付宝支付 | \We::AliPayTransfer() |
+| Wap.php | AliPay\Wap | 支付宝Wap支付 | 支付宝支付 | \We::AliPayWap() |
+| Web.php | AliPay\Web | 支付宝Web支付 | 支付宝支付 | \We::AliPayWeb() |
+| Card.php | WeChat\Card | 微信卡券接口支持 | 认证服务号 | \We::WeChatCard() |
+| Custom.php | WeChat\Custom | 微信客服消息接口支持 | 认证服务号 | \We::WeChatCustom() |
+| Media.php | WeChat\Media | 微信媒体素材接口支持 | 认证服务号 | \We::WeChatMedia() |
+| Oauth.php | WeChat\Oauth | 微信网页授权消息类接口 | 认证服务号 | \We::WeChatOauth() |
+| Pay.php | WeChat\Pay | 微信支付类接口 | 认证服务号 | \We::WeChatPay() |
+| Product.php | WeChat\Product | 微信商店类接口 | 认证服务号 | \We::WeChatProduct() |
+| Qrcode.php | WeChat\Qrcode | 微信二维码接口支持 | 认证服务号 | \We::WeChatQrcode() |
+| Receive.php | WeChat\Receive | 微信推送事件消息处理支持 | 认证服务号 | \We::WeChatReceive() |
+| Scan.php | WeChat\Scan | 微信扫一扫接口支持 | 认证服务号 | \We::WeChatScan() |
+| Script.php | WeChat\Script | 微信前端JSSDK支持 | 认证服务号 | \We::WeChatScript() |
+| Shake.php | WeChat\Shake | 微信蓝牙设备揺一揺接口 | 认证服务号 | \We::WeChatShake() |
+| Tags.php | WeChat\Tags | 微信粉丝标签接口支持 | 认证服务号 | \We::WeChatTags() |
+| Template.php | WeChat\Template | 微信模板消息接口支持 | 认证服务号 | \We::WeChatTemplate() |
+| User.php | WeChat\User | 微信粉丝管理接口支持 | 认证服务号 | \We::WeChatCard() |
+| Wifi.php | WeChat\Wifi | 微信门店WIFI管理支持 | 认证服务号 | \We::WeChatWifi() |
+| Bill.php | WePay\Bill | 微信商户账单及评论 | 微信支付 | \We::WePayBill() |
+| Coupon.php | WePay\Coupon | 微信商户代金券 | 微信支付 | \We::WePayCoupon() |
+| Order.php | WePay\Order | 微信商户订单 | 微信支付 | \We::WePayOrder() |
+| Redpack.php | WePay\Redpack | 微信红包支持 | 微信支付 | \We::WePayRedpack() |
+| Refund.php | WePay\Refund | 微信商户退款 | 微信支付 | \We::WePayRefund() |
+| Transfers.php | WePay\Transfers | 微信商户打款到零钱 | 微信支付 | \We::WePayTransfers() |
+| TransfersBank.php | WePay\TransfersBank | 微信商户打款到银行卡 | 微信支付 | \We::WePayTransfersBank() |
+| Crypt.php | WeMini\Crypt | 微信小程序数据加密处理 | 微信小程序 | \We::WeMiniCrypt() |
+| Plugs.php | WeMini\Plugs | 微信小程序插件管理 | 微信小程序 | \We::WeMiniPlugs() |
+| Poi.php | WeMini\Poi | 微信小程序地址管理 | 微信小程序 | \We::WeMiniPoi() |
+| Qrcode.php | WeMini\Qrcode | 微信小程序二维码管理 | 微信小程序 | \We::WeMiniCrypt() |
+| Template.php | WeMini\Template | 微信小程序模板消息支持 | 微信小程序 | \We::WeMiniTemplate() |
+| Total.php | WeMini\Total | 微信小程序数据接口 | 微信小程序 | \We::WeMiniTotal() |
+
+
+安装使用
+----
+1.1 通过 Composer 来管理安装
+```shell
+# 首次安装 线上版本（稳定）
+composer require zoujingli/wechat-developer
+
+# 首次安装 开发版本（开发）
+composer require zoujingli/wechat-developer dev-master
+
+# 更新 WeChatDeveloper
+composer update zoujingli/wechat-developer
+```
+
+1.2 如果不使用 Composer， 可以下载 WeChatDeveloper 并解压到项目中
+```php
+# 在项目中加载初始化文件
+include "您的目录/WeChatDeveloper/include.php";
+```
+
+2.1 接口实例所需参数
+```php
+$config = [
+ 'token' => 'test',
+ 'appid' => 'wx60a43dd8161666d4',
+ 'appsecret' => '71308e96a204296c57d7cd4b21b883e8',
+ 'encodingaeskey' => 'BJIUzE0gqlWy0GxfPp4J1oPTBmOrNDIGPNav1YFH5Z5',
+ // 配置商户支付参数（可选，在使用支付功能时需要）
+ 'mch_id' => "1235704602",
+ 'mch_key' => 'IKI4kpHjU94ji3oqre5zYaQMwLHuZPmj',
+ // 配置商户支付双向证书目录（可选，在使用退款|打款|红包时需要）
+ 'ssl_key' => '',
+ 'ssl_cer' => '',
+ // 缓存目录配置（可选，需拥有读写权限）
+ 'cache_path' => '',
+];
+```
+
+3.1 实例指定接口
+```php
+try {
+
+ // 实例对应的接口对象
+ $user = new \WeChat\User($config);
+
+ // 调用接口对象方法
+ $list = $user->getUserList();
+
+ // 处理返回的结果
+ echo '';
+ var_export($list);
+
+} catch (Exception $e) {
+
+ // 出错啦，处理下吧
+ echo $e->getMessage() . PHP_EOL;
+
+}
+```
+
+微信支付
+---
+```php
+ // 创建接口实例
+ $wechat = new \WeChat\Pay($config);
+
+ // 组装参数，可以参考官方商户文档
+ $options = [
+ 'body' => '测试商品',
+ 'out_trade_no' => time(),
+ 'total_fee' => '1',
+ 'openid' => 'o38gpszoJoC9oJYz3UHHf6bEp0Lo',
+ 'trade_type' => 'JSAPI',
+ 'notify_url' => 'http://a.com/text.html',
+ 'spbill_create_ip' => '127.0.0.1',
+ ];
+
+try {
+
+ // 生成预支付码
+ $result = $wechat->createOrder($options);
+
+ // 创建JSAPI参数签名
+ $options = $wechat->createParamsForJsApi($result['prepay_id']);
+
+ // @todo 把 $options 传到前端用js发起支付就可以了
+
+} catch (Exception $e) {
+
+ // 出错啦，处理下吧
+ echo $e->getMessage() . PHP_EOL;
+
+}
+```
+* 更多功能请阅读测试代码或SDK封装源码
+
+支付宝支付
+----
+* 支付参数配置（可用沙箱模式）
+```php
+$config = [
+ // 沙箱模式
+ 'debug' => true,
+ // 应用ID
+ 'appid' => '2016090900468879',
+ // 支付宝公钥(1行填写)
+ 'public_key' => 'MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtU71NY53UDGY7JNvLYAhsNa+taTF6KthIHJmGgdio9bkqeJGhHk6ttkTKkLqFgwIfgAkHpdKiOv1uZw6gVGZ7TCu5LfHTqKrCd6Uz+N7hxhY+4IwicLgprcV1flXQLmbkJYzFMZqkXGkSgOsR2yXh4LyQZczgk9N456uuzGtRy7MoB4zQy34PLUkkxR6W1B2ftNbLRGXv6tc7p/cmDcrY6K1bSxnGmfRxFSb8lRfhe0V0UM6pKq2SGGSeovrKHN0OLp+Nn5wcULVnFgATXGCENshRlp96piPEBFwneXs19n+sX1jx60FTR7/rME3sW3AHug0fhZ9mSqW4x401WjdnwIDAQAB',
+ // 支付宝私钥(1行填写)
+ 'private_key' => 'MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC3pbN7esinxgjE8uxXAsccgGNKIq+PR1LteNTFOy0fsete43ObQCrzd9DO0zaUeBUzpIOnxrKxez7QoZROZMYrinttFZ/V5rbObEM9E5AR5Tv/Fr4IBywoS8ZtN16Xb+fZmibfU91yq9O2RYSvscncU2qEYmmaTenM0QlUO80ZKqPsM5JkgCNdcYZTUeHclWeyER3dSImNtlSKiSBSSTHthb11fkudjzdiUXua0NKVWyYuAOoDMcpXbD6NJmYqEA/iZ/AxtQt08pv0Mow581GPB0Uop5+qA2hCV85DpagE94a067sKcRui0rtkJzHem9k7xVL+2RoFm1fv3RnUkMwhAgMBAAECggEAAetkddzxrfc+7jgPylUIGb8pyoOUTC4Vqs/BgZI9xYAJksNT2QKRsFvHPfItNt4Ocqy8h4tnIL3GCU43C564B4p6AcjhE85GiN/O0BudPOKlfuQQ9mqExqMMHuYeQfz0cmzPDTSGMwWiv9v4KBH2pyvkCCAzNF6uG+rvawb4/NNVuiI7C8Ku/wYsamtbgjMZVOFFdScYgIw1BgA99RUU/fWBLMnTQkoyowSRb9eSmEUHjt/WQt+/QgKAT2WmuX4RhaGy0qcQLbNaJNKXdJ+PVhQrSiasINNtqYMa8GsQuuKsk3X8TCg9K6/lowivt5ruhyWcP2sx93zY/LGzIHgHcQKBgQDoZlcs9RWxTdGDdtH8kk0J/r+QtMijNzWI0a+t+ZsWOyd3rw+uM/8O4JTNP4Y98TvvxhJXewITbfiuOIbW1mxh8bnO/fcz7+RXZKgPDeoTeNo717tZFZGBEyUdH9M9Inqvht7+hjVDIMCYBDomYebdk3Xqo4mDBjLRdVNGrhGmVQKBgQDKS/MgTMK8Ktfnu1KzwCbn/FfHTOrp1a1t1wWPv9AW0rJPYeaP6lOkgIoO/1odG9qDDhdB6njqM+mKY5Yr3N94PHamHbwJUCmbkqEunCWpGzgcQZ1Q254xk9D7UKq/XUqW2WDqDq80GQeNial+fBc46yelQzokwdA+JdIFKoyinQKBgQCBems9V/rTAtkk1nFdt6EGXZEbLS3PiXXhGXo4gqV+OEzf6H/i/YMwJb2hsK+5GQrcps0XQihA7PctEb9GOMa/tu5fva0ZmaDtc94SLR1p5d4okyQFGPgtIp594HpPSEN0Qb9BrUJFeRz0VP6U3dzDPGHo7V4yyqRLgIN6EIcy1QKBgAqdh6mHPaTAHspDMyjJiYEc5cJIj/8rPkmIQft0FkhMUB0IRyAALNlyAUyeK61hW8sKvz+vPR8VEEk5xpSQp41YpuU6pDZc5YILZLfca8F+8yfQbZ/jll6Foi694efezl4yE/rUQG9cbOAJfEJt4o4TEOaEK5XoMbRBKc8pl22lAoGARTq0qOr9SStihRAy9a+8wi2WEwL4QHcmOjH7iAuJxy5b5TRDSjlk6h+0dnTItiFlTXdfpO8KhWA8EoSJVBZ1kcACQDFgMIA+VM+yXydtzMotOn21W4stfZ4I6dHFiujMsnKpNYVpQh3oCrJf4SeXiQDdiSCodqb1HlKkEc6naHQ=',
+ // 支付成功通知地址
+ 'notify_url' => '', // 可以应用的时候配置哦
+ // 网页支付回跳地址
+ 'return_url' => '', // 可以应用的时候配置哦
+];
+```
+* 支付宝发起PC网站支付
+```php
+// 参考公共参数 https://docs.open.alipay.com/203/107090/
+$config['notify_url'] = 'http://pay.thinkadmin.top/test/alipay-notify.php';
+$config['return_url'] = 'http://pay.thinkadmin.top/test/alipay-success.php';
+
+try {
+
+ // 实例支付对象
+ $pay = We::AliPayWeb($config);
+ // $pay = new \AliPay\Web($config);
+
+ // 参考链接：https://docs.open.alipay.com/api_1/alipay.trade.page.pay
+ $result = $pay->apply([
+ 'out_trade_no' => time(), // 商户订单号
+ 'total_amount' => '1', // 支付金额
+ 'subject' => '支付订单描述', // 支付订单描述
+ ]);
+
+ echo $result; // 直接输出HTML（提交表单跳转)
+
+} catch (Exception $e) {
+
+ // 异常处理
+ echo $e->getMessage();
+
+}
+```
+* 支付宝发起手机网站支付
+```php
+// 参考公共参数 https://docs.open.alipay.com/203/107090/
+$config['notify_url'] = 'http://pay.thinkadmin.top/test/alipay-notify.php';
+$config['return_url'] = 'http://pay.thinkadmin.top/test/alipay-success.php';
+
+try {
+
+ // 实例支付对象
+ $pay = We::AliPayWap($config);
+ // $pay = new \AliPay\Wap($config);
+
+ // 参考链接：https://docs.open.alipay.com/api_1/alipay.trade.wap.pay
+ $result = $pay->apply([
+ 'out_trade_no' => time(), // 商户订单号
+ 'total_amount' => '1', // 支付金额
+ 'subject' => '支付订单描述', // 支付订单描述
+ ]);
+
+ echo $result; // 直接输出HTML（提交表单跳转)
+
+} catch (Exception $e) {
+
+ // 异常处理
+ echo $e->getMessage();
+
+}
+```
+* 更多功能请阅读测试代码或SDK封装源码
+
+开源协议
+----
+* WeChatDeveloper 基于`MIT`协议发布，任何人可以用在任何地方，不受约束
+* WeChatDeveloper 部分代码来自互联网，若有异议，可以联系作者进行删除
+
+赞助支持
+----
+
+
+