开发文档

 $value) {
        $parts[] = $key . '=' . $value;
    }

    return hash('sha256', implode('&', $parts) . '&key=' . APPKEY);
}

/** 带上签名发起请求 */
function api(string $action, array $params): array
{
    $params['appid']     = APPID;
    $params['timestamp'] = time();
    $params['sign']      = sign($params);

    $url = API_BASE . '/' . $action . '?' . http_build_query($params);
    $raw = file_get_contents($url, false, stream_context_create([
        'http' => ['timeout' => 10],
    ]));

    return json_decode((string) $raw, true) ?: ['code' => -1, 'msg' => '接口无响应'];
}

// ───────── 第一步：拿到第三方授权地址，把用户送过去 ─────────
function startLogin(string $type, string $redirectUri): void
{
    $res = api('login', [
        'type'         => $type,
        'redirect_uri' => $redirectUri,
    ]);

    if ((int) $res['code'] !== 0) {
        exit('获取登录地址失败：' . $res['msg']);
    }

    // 微信 / 支付宝还会返回 qrcode（扫码地址），可用于 PC 扫码登录
    header('Location: ' . $res['url']);
    exit;
}

// ───────── 第二步：用户从第三方跳回来，用 code 换用户信息 ─────────
function handleCallback(string $type, string $code): array
{
    $res = api('callback', ['type' => $type, 'code' => $code]);

    if ((int) $res['code'] === 2) {
        // 用户还没完成授权（比如扫码扫到一半），稍后重试即可
        exit('正在登录中，请稍候刷新…');
    }

    if ((int) $res['code'] !== 0) {
        exit('登录失败：' . $res['msg']);
    }

    // social_uid 是第三方账号的唯一标识，用它在你自己的库里找/建用户
    return [
        'social_uid' => $res['social_uid'],
        'nickname'   => $res['nickname'],
        'avatar'     => $res['faceimg'],
        'gender'     => $res['gender'],
    ];
}

// ───────── 第三步（可选）：事后复查用户信息 ─────────
function queryUser(string $type, string $socialUid): array
{
    return api('query', ['type' => $type, 'social_uid' => $socialUid]);
}