API 参考文档

try {
    $token = $client->passwordLogin('username', 'password123');

    $token['access_token'];   // JWT 访问令牌（2 小时有效）
    $token['refresh_token'];  // 刷新令牌（7 天有效）
    $token['expires_in'];     // 有效期秒数（7200）
    $token['user'];           // 用户信息数组
} catch (\RuntimeException $e) {
    echo '登录失败: ' . $e->getMessage();
}

$client->register([
    'username' => 'new_user',
    'password' => 'Password123',
    'email'    => 'user@example.com',  // 可选
    'phone'    => '13800138000',       // 可选
]);

// 刷新 Token（refresh_token 每次刷新轮转）
$newToken = $client->refreshToken($refreshToken);

// 退出登录（撤销该用户所有 Refresh Token）
$client->logout($accessToken);

$authInfo = $client->getAuthUrl(
    'https://your-app.com/callback',  // 回调地址（参数名 redirect_url）
    'snsapi_userinfo',                // snsapi_userinfo 或 snsapi_base
    'custom_state',                   // 自定义 state（可选）
    'login'                            // 场景：login / bind / password_reset
);

$authInfo['session_id'];   // 会话 ID，用于轮询状态
$authInfo['auth_url'];     // 微信内 + snsapi_base：直接静默 OAuth
$authInfo['confirm_url'];  // PC / 非微信：展示扫码确认页

$status = $client->queryAuthStatus($sessionId);
// status: "pending" | "authorized" | "expired"

if ($status['status'] === 'authorized') {
    $accessToken = $status['data']['token']['access_token'];

    // 首次微信登录，需设置用户名
    if ($status['data']['account_setup_required'] ?? false) {
        $client->setupAccount('my_username', null, $accessToken);
    }
}

// 自动验证签名 + 换 Token（推荐）
$tokenData = $client->handleCallback($_GET);

// 或仅换码
$tokenData = $client->exchangeCode($_GET['code']);

// bind 场景扫码授权后
$client->bindWechatSession($accessToken, $status['data']['bind_session_id']);

// 解绑
$client->unbindWechat($accessToken);

// 本地验证（无网络请求，需 jwt_secret）
$result = $client->validateToken($accessToken);
// ['valid' => true, 'user_id' => 1, 'exp' => ..., 'jti' => 'xxx']

// 远程验证（可检查是否已被吊销）
$result = $client->validateToken($accessToken, true);
// ['active' => true, 'valid' => true, 'openid' => 'xxx', ...]

$client->sendTemplateMessage(
    'user_openid',
    'wx_template_id_xxx',   // 微信模板 ID（与 template_key 二选一）
    [
        'first'    => ['value' => '您的订单已发货', 'color' => '#173177'],
        'keyword1' => ['value' => 'P123456789',   'color' => '#173177'],
        'remark'   => ['value' => '感谢您的支持！', 'color' => '#576B95'],
    ],
    'https://your-app.com/order/123',  // 跳转链接（可选）
    'order_notify'                      // 本地模板别名（可选）
);

$client->batchSendTemplateMessages(
    ['openid_1', 'openid_2'],
    '',  // template_id 留空则用 template_key
    ['first' => ['value' => '活动提醒', 'color' => '#173177']],
    'https://your-app.com/activity',
    'activity_remind'
);
// ['data' => ['total' => 2, 'success' => 2, 'failed' => 0]]

$client->getTemplateList();          // 模板列表（5 分钟缓存）
$client->getTemplate('order_notify');  // 按别名获取单个
$client->getPushStats(7);           // 最近 N 天推送统计

{
  "access_token":  "eyJhbGci...",
  "token_type":    "Bearer",
  "expires_in":    7200,
  "refresh_token": "eyJhbGci...",
  "user": { "id": 1, "username": "alice", "has_wechat": true }
}

{
  "code": 200,
  "data": {
    "active": true,
    "openid": "oXxx...",
    "user_info": { "id": 1, "username": "alice" },
    "exp": 1753055200,
    "scope": "snsapi_userinfo",
    "token_type": "Bearer"
  }
}

{
  "code": 200,
  "data": {
    "session_id":  "a3f8e2...",
    "confirm_url": "https://your-domain/auth/confirm/a3f8e2...",
    "auth_url":    "https://open.weixin.qq.com/connect/oauth2/authorize?...",
    "expires_in":  180,
    "scene":       "login"
  }
}

{
  "code": 200,
  "data": {
    "status": "authorized",
    "data": {
      "openid": "oXxx...",
      "token": {
        "access_token": "eyJ...",
        "expires_in": 7200,
        "user": { "id": 1, "username": "alice" }
      }
    }
  }
}

{ "id": 1, "nickname": "Alice",
  "email": "alice@example.com", "phone": "138****5678",
  "has_wechat": true, "openid": "oXxx...",
  "account_setup_required": false }

{ "code": 200,
  "data": { "reset_token": "uuuz_rst_xxx...", "expires_in": 300 } }