Installation
5 分钟完成 UserMatrix SDK 集成。
前置准备
- 在 控制台 注册并创建应用，获取
appid和appkey - 配置授权回调域名
redirect_uri
安装 SDK
PHP
composer require yunjii/um-sdk
JavaScript
npm install @yunjii/um-sdk
3 行代码接入
1. 初始化 SDK
<?php
require 'vendor/autoload.php';
$um = new UM(
$appid, // 应用 ID
$appkey, // 应用密钥
$callback, // 回调地址
$apiurl // API 地址
);
2. 生成登录跳转
$state = bin2hex(random_bytes(16));
$loginUrl = $um->login('wx', $state);
header("Location: $loginUrl");
3. 回调获取用户信息
$user = $um->callback($_GET['code']);
// => [
// "openid" => "oX...",
// "nickname" => "张三",
// "avatar" => "https://...",
// "social_uid" => "..."
// ]
完成！你的应用现在支持微信扫码登录。其他平台只需修改 login() 的 type 参数：wx/alipay/qq/douyin。
签名机制
SDK 自动生成签名，无需手动处理：
- 收集所有 GET 参数（除
sign） - 按 key 字典序排序拼接
k1=v1&k2=v2&...&appkey=xxx - MD5 生成
sign timestamp5 分钟内有效
5 分钟 code 缓存机制防止 40163 重复消费错误，这是 UM 的独家防护。