Merge pull request #106 from LinkedDestiny/1.2.x

add miniprogram urlscheme api

.gitignore

@@ -0,0 +1,3 @@
+.idea/
+vendor/
+composer.lock

src/MiniProgram/ApiUrl.php

@@ -387,6 +387,13 @@ class ApiUrl
      */
     const SUBSCRIBE_SEND = 'https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=ACCESS_TOKEN';
 
+    /**
+     * 获取小程序scheme码
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/url-scheme/urlscheme.generate.html
+     */
+    const URL_SCHEME_GENERATE = 'https://api.weixin.qq.com/wxa/generatescheme?access_token=ACCESS_TOKEN';
+
+
     /**
      * 生成访问链接
      * @param string $baseUrl 基础链接

src/MiniProgram/MiniProgram.php

@@ -20,6 +20,7 @@ class MiniProgram
     private $qrCode;
     private $templateMsg;
     private $subscribeMsg;
+    private $urlscheme;
 
     public function __construct(MiniProgramConfig $config = null, AccessTokenInterface $accessToken = null)
     {
@@ -131,4 +132,16 @@ public function subscribeMsg():SubscribeMsg
 
         return $this->subscribeMsg;
     }
+
+    /**
+     * @return UrlScheme
+     */
+    public function urlScheme():UrlScheme
+    {
+        if (!isset($this->urlscheme)) {
+            $this->urlscheme = new UrlScheme($this);
+        }
+
+        return $this->urlscheme;
+    }
 }

src/MiniProgram/UrlScheme.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+
+namespace EasySwoole\WeChat\MiniProgram;
+
+
+use EasySwoole\WeChat\Exception\MiniProgramError;
+use EasySwoole\WeChat\Exception\RequestError;
+use EasySwoole\WeChat\Utility\NetWork;
+
+class UrlScheme extends MinProgramBase
+{
+    /**
+     * 生成URL SCHEME
+     * @param string $path
+     * @param string $query
+     * @param bool $isExpire
+     * @param int $expireAt
+     * @return array
+     * @throws MiniProgramError
+     * @throws RequestError
+     */
+    public function generate(string $path, string $query, bool $isExpire = false, int $expireAt = 0)
+    {
+        $token = $this->getMiniProgram()->accessToken()->getToken();
+        $url = ApiUrl::generateURL(ApiUrl::URL_SCHEME_GENERATE, [
+            'ACCESS_TOKEN' => $token,
+        ]);
+
+        $responseArray = NetWork::postJsonForJson($url, [
+            'jump_wxa'     => [
+                'path'  => $path,
+                'query' => $query
+            ],
+            'is_expire'    => $isExpire,
+            'expire_time'  => $expireAt
+        ]);
+        $ex = MiniProgramError::hasException($responseArray);
+        if ($ex) {
+            throw $ex;
+        }
+
+        return $responseArray;
+    }
+}