如何使用
在安装完本开发包之后，需要引入本开发包。若是通过composer安装的，则只需引入你的项目目录下的vender目录（composer包存放的目录）下的autoload.php即可。若是通过直接拷贝项目的方式，则需在项目中引入MiniProgram.php文件。
实例化操作及其它准备
添加命名空间。如下：
use hillpy\MiniProgramSDK\MiniProgram;实例化MiniProgram。实例化时需要传入小程序的appId和appSecret，以及accessToken三个参数。其中accessToken为小程序全局唯一后台接口调用凭据，若不传此参数，则将会调用微信接口来获取accessToken数据。若传入此参数且不为空，则不会通过微信接口来获取accessToken数据。故请自行缓存accessToken。示例代码如下：
// 设置变量。 $appId = '小程序APPID'; $appSecret = '小程序APPSECRET'; $accessToken = ''; // 从redis获取accessToken。 $redis = new Redis(); $redis->connect('127.0.0.1', 6379); $accessToken = $redis->get('miniprogram_access_token_appid_' . $appId); // 实例化MiniProgram。 $miniProgram = new MiniProgram($appId, $appSecret, $accessToken);缓存accessToken。此参数为小程序全局唯一后台接口调用凭据，需要自行缓存，以便多次使用。在实例化之后进行缓存，示例代码如下：
// 若缓存中不存在accessToken，从新实例化对象中获取并写入redis。 if (!$accessToken) { isset($miniProgram->accessTokenData['access_token']) && $accessToken = $miniProgram->accessTokenData['access_token']; if ($accessToken) { // 获取的expires_in为秒时间戳，减去30秒（过期时间适当提前避免accessToken实际已失效）。 if (isset($miniProgram->accessTokenData['expires_in'])) { $cacheTime = $miniProgram->accessTokenData['expires_in'] - 30; } else { $cacheTime = 0; } $redis->setex('miniprogram_access_token_appid_' . $appId, $cacheTime, $accessToken); } }
解密用户信息
小程序端可传入sessionCacheKey参数（通过wx.checkSession()来判断是否传入sessionCacheKey参数。wx.checkSession返回的登录态若未过期，则需传入此参数，否则无需传入此参数）。
若存在sessionCacheKey，则将从缓存中获取sessionKey，并加入解密请求参数。否则解密请求参数无需sessionKey，内部将会调用接口获取。
执行解密操作，若不存在sessionCacheKey，则随机生成sessionCacheKey，并缓存sessionKey。以上步骤示例代码如下：
// 客户端请求参数。
$paramArr['code'] = isset($_POST['code']) ? $_POST['code'] : '';
$paramArr['rawData'] = isset($_POST['rawData']) ? $_POST['rawData'] : '';
$paramArr['signature'] = isset($_POST['signature']) ? $_POST['signature'] : '';
$paramArr['encryptedData'] = isset($_POST['encryptedData']) ? $_POST['encryptedData'] : '';
$paramArr['iv'] = isset($_POST['iv']) ? $_POST['iv'] : '';
$sessionCacheKey = isset($_POST['sessionCacheKey']) ? $_POST['sessionCacheKey'] : '';
// sessionCacheKey为sessionKey缓存名的一部分。若存在，则从缓存获取。否则，从接口请求。
$sessionCacheKey && $paramArr['sessionKey'] = $redis->get('miniprogram_session_key_appid_' . $appId . '_key_' . $sessionCacheKey);
$res = $miniProgram->decryptData($paramArr);
if ($res['code'] == 100) {
if (!$sessionCacheKey) {
// 将sessionKey写入缓存，过期时间尽量长一些，此处缓存30天。
$sessionCacheKey = '随机生成字符串';
$redis->setex('miniprogram_session_key_appid_' . $appId . '_key_' . $sessionCacheKey, $res['data']['sessionKey'], 3600 * 24 * 30);
}
// data为解密后的数据。可根据解密数据，做相关处理。如登录注册，并生成jwt。然后将jwt、sessionCacheKey、用户信息返回给小程序端
$data = $res['data']['data'];
echo '解密成功';
} else {
echo $res['msg'];
}
解密手机号
除设置参数以外，其它同解密用户信息接口。示例代码如下：
// 客户端请求参数
$paramArr['code'] = isset($_POST['code']) ? $_POST['code'] : '';
$paramArr['encryptedData'] = isset($_POST['encryptedData']) ? $_POST['encryptedData'] : '';
$paramArr['iv'] = isset($_POST['iv']) ? $_POST['iv'] : '';
$sessionCacheKey = isset($_POST['sessionCacheKey']) ? $_POST['sessionCacheKey'] : '';
// sessionCacheKey为sessionKey缓存名的一部分。若存在，则从缓存获取。否则，从接口请求。
$sessionCacheKey && $paramArr['sessionKey'] = $redis->get('miniprogram_session_key_appid_' . $appId . '_key_' . $sessionCacheKey);
$res = $miniProgram->decryptData($paramArr);
if ($res['code'] == 100) {
if (!$sessionCacheKey) {
// 将sessionKey写入缓存，过期时间尽量长一些，此处缓存30天。
$sessionCacheKey = '随机生成字符串';
$redis->setex('miniprogram_session_key_appid_' . $appId . '_key_' . $sessionCacheKey, $res['data']['sessionKey'], 3600 * 24 * 30);
}
// data为解密后的数据。可根据解密数据，做相关处理。如登录注册，并生成jwt。然后将jwt、sessionCacheKey、手机号返回给小程序端
$data = $res['data']['data'];
echo '解密成功';
} else {
echo $res['msg'];
}
获取小程序二维码
微信接口将返回小程序二维码图片的二进制流。本开发包将直接返回此二进制流。然后自行将二进制流写入图片文件即可。示例代码如下：
// 设置文件路径和文件名。
$filepath = '/wxaqrcode/';
$allPath = $_SERVER['DOCUMENT_ROOT'] . $filepath;
$filename = time() . '_' . uniqid() . '.png';
// 获取设置参数。
$path = $_POST['path'];
$width = $_POST['width'];
$paramArr['path'] = $path;
$width && $paramArr['width'] = $width;
// 请求接口
$res = $miniProgram->createWXAQRCode($paramArr);
// 写入文件相关操作
if (!is_dir($allPath)) {
mkdir($allPath, 0777, true);
}
$file = fopen($allPath . $filename,"w");
fwrite($file, $res);
fclose($file);
$result['code'] = 1;
$result['msg'] = '操作成功';
$result['data'] = $filepath . $filename;
echo json_encode($result);
获取有数量限制的小程序码
除设置参数以外，其它同获取小程序二维码接口。示例代码如下：
$filepath = '/wxacode/';
$allPath = $_SERVER['DOCUMENT_ROOT'] . $filepath;
$filename = time() . '_' . uniqid() . '.png';
$path = $_POST['path'];
$width = $_POST['width'];
$autoColor = $_POST['autoColor'];
$lineColor = $_POST['lineColor'];
$isHyaline = $_POST['isHyaline'];
$paramArr['path'] = $path;
$width && $paramArr['width'] = $width;
$autoColor && $paramArr['auto_color'] = $autoColor;
$lineColor && $paramArr['line_color'] = $lineColor;
$isHyaline && $paramArr['is_hyaline'] = $isHyaline;
$res = $miniProgram->getWXAcode($paramArr);
if (!is_dir($allPath)) {
mkdir($allPath, 0777, true);
}
$file = fopen($allPath . $filename,"w");
fwrite($file, $res);
fclose($file);
$result['code'] = 1;
$result['msg'] = '操作成功';
$result['data'] = $filepath . $filename;
echo json_encode($result);
获取无数量限制的小程序码
除设置参数以外，其它同获取小程序二维码接口。示例代码如下：
$path = '/wxacodeunlimit/';
$allPath = $_SERVER['DOCUMENT_ROOT'] . $path;
$filename = time() . '_' . uniqid() . '.png';
$scene = $_POST['scene'];
$page = $_POST['page'];
$width = $_POST['width'];
$autoColor = $_POST['autoColor'];
$lineColor = $_POST['lineColor'];
$isHyaline = $_POST['isHyaline'];
$paramArr['scene'] = $scene;
$paramArr['page'] = $page;
$width && $paramArr['width'] = $width;
$autoColor && $paramArr['auto_color'] = $autoColor;
$lineColor && $paramArr['line_color'] = $lineColor;
$isHyaline && $paramArr['is_hyaline'] = $isHyaline;
$res = $miniProgram->getWxacodeUnlimit($paramArr);
if (!is_dir($allPath)) {
mkdir($allPath, 0777, true);
}
$file = fopen($allPath . $filename,"w");
fwrite($file, $res);
fclose($file);
$result['code'] = 1;
$result['msg'] = '操作成功';
$result['data'] = $path . $filename;
echo json_encode($result);