开发文档

<?php
// 配置信息
$appid  = '您的AppID';
$appkey = '您的AppKey';
$callback = 'https://yourdomain.com/callback.php';

// 发起登录 - 以QQ为例
$loginUrl = "https://您的域名/connect.php?act=login"
          . "&appid={$appid}"
          . "&appkey={$appkey}"
          . "&type=qq"
          . "&redirect_uri=" . urlencode($callback);

// 请求API获取跳转地址
$result = json_decode(file_get_contents($loginUrl), true);

if ($result['code'] == 0) {
    // 跳转到第三方授权页面
    header('Location: ' . $result['url']);
    exit;
} else {
    echo '登录发起失败：' . $result['msg'];
}
?>

<?php
// callback.php - 处理登录回调
$appid  = '您的AppID';
$appkey = '您的AppKey';

if (isset($_GET['type']) && isset($_GET['code'])) {
    $type = $_GET['type'];
    $code = $_GET['code'];

    // 通过回调接口直接获取用户信息
    $apiUrl = "https://您的域名/connect.php"
            . "?act=callback"
            . "&appid={$appid}"
            . "&appkey={$appkey}"
            . "&type={$type}"
            . "&code={$code}";

    $response = file_get_contents($apiUrl);
    $data = json_decode($response, true);

    if ($data['code'] == 2) {
        // 用户尚未完成登录，需要等待重试
        echo '登录尚未完成，请稍后...';
    } elseif ($data['code'] == 0) {
        // 登录成功，获取用户信息
        echo '用户昵称：' . $data['nickname'] . '<br>';
        echo '用户头像：' . $data['faceimg'] . '<br>';
        echo '唯一标识：' . $data['social_uid'] . '<br>';
        // 请使用 social_uid 作为用户唯一标识进行绑定
    } else {
        echo '登录失败：' . $data['msg'];
    }
}
?>

<?php
// callback.php - 生产环境推荐写法
$appid  = '您的AppID';
$appkey = '您的AppKey';
$apiBase = 'https://您的域名';

if (!isset($_GET['type']) || !isset($_GET['code'])) {
    die('缺少必要参数');
}

$type = $_GET['type'];
$code = $_GET['code'];
$maxRetry = 10;        // 最大重试次数
$interval = 2000000;   // 重试间隔 2 秒（微秒）

for ($i = 0; $i < $maxRetry; $i++) {
    $apiUrl = "{$apiBase}/connect.php?act=callback"
            . "&appid={$appid}&appkey={$appkey}"
            . "&type={$type}&code={$code}";

    $response = file_get_contents($apiUrl);
    $data = json_decode($response, true);

    if ($data['code'] == 0) {
        // 登录成功
        // 使用 social_uid 查找或创建本地用户
        $user = findOrCreateUser($data['type'], $data['social_uid']);
        $user->nickname = $data['nickname'];
        $user->avatar   = $data['faceimg'];
        $user->save();

        // 设置登录 Session
        $_SESSION['user_id'] = $user->id;
        header('Location: /dashboard.php');
        exit;
    } elseif ($data['code'] == 2) {
        // 用户尚未完成授权，等待后重试
        usleep($interval);
        continue;
    } else {
        // 登录失败
        die('登录失败[' . $data['errcode'] . ']：' . $data['msg']);
    }
}
die('登录超时，请重试');
?>

const express = require('express');
const axios = require('axios');
const app = express();

const APPID = '您的AppID';
const APPKEY = '您的AppKey';
const API_BASE = 'https://您的域名';

// 1. 前端调用此接口获取登录跳转URL
app.get('/api/login', async (req, res) => {
    const { type, redirect_uri } = req.query;
    const url = `${API_BASE}/connect.php?act=login`
        + `&appid=${APPID}&appkey=${APPKEY}`
        + `&type=${type}&redirect_uri=${encodeURIComponent(redirect_uri)}`;

    const { data } = await axios.get(url);
    if (data.code === 0) {
        res.json({ success: true, url: data.url });
    } else {
        res.json({ success: false, msg: data.msg });
    }
});

// 2. 前端回调后调用此接口获取用户信息
app.get('/api/callback', async (req, res) => {
    const { type, code } = req.query;
    const url = `${API_BASE}/connect.php?act=callback`
        + `&appid=${APPID}&appkey=${APPKEY}`
        + `&type=${type}&code=${code}`;

    const { data } = await axios.get(url);
    if (data.code === 0) {
        // data.social_uid / data.nickname / data.faceimg
        res.json({ success: true, user: data });
    } else if (data.code === 2) {
        res.json({ success: false, pending: true, msg: '登录中...' });
    } else {
        res.json({ success: false, msg: data.msg });
    }
});

<?php
function httpGet($url, $timeout = 10) {
    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL            => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => $timeout,
        CURLOPT_CONNECTTIMEOUT => $timeout,
        CURLOPT_SSL_VERIFYPEER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ]);
    $response = curl_exec($ch);
    $errno = curl_errno($ch);
    curl_close($ch);

    if ($errno) {
        return ['error' => true, 'msg' => curl_error($ch)];
    }
    return json_decode($response, true);
}

// 使用示例
$result = httpGet("https://您的域名/connect.php?act=login&appid={$appid}&appkey={$appkey}&type=qq&redirect_uri=" . urlencode($callback));
if ($result['code'] == 0) {
    header('Location: ' . $result['url']);
    exit;
}
?>

<?php
$maxRetry = 15;
$intervals = [2, 2, 2, 3, 3, 3, 5, 5, 5, 5, 5, 8, 8, 8, 10]; // 递增间隔（秒）

for ($i = 0; $i < $maxRetry; $i++) {
    $data = httpGet($apiUrl);

    if ($data['code'] == 0) {
        // 登录成功，处理用户信息
        break;
    } elseif ($data['code'] == 2) {
        sleep($intervals[$i]);
        continue;
    } else {
        die('登录失败: ' . $data['msg']);
    }
}
die('登录超时');
?>

CREATE TABLE `user_oauth` (
  `id`          INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
  `user_id`     INT UNSIGNED NOT NULL,
  `type`        VARCHAR(20)  NOT NULL COMMENT '登录方式: qq/wx/alipay等',
  `social_uid`  VARCHAR(64)  NOT NULL COMMENT '第三方用户唯一标识',
  `nickname`    VARCHAR(100) DEFAULT NULL,
  `avatar`      VARCHAR(500) DEFAULT NULL,
  `created_at`  DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_at`  DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  UNIQUE KEY `uk_type_social` (`type`, `social_uid`),
  KEY `idx_user_id` (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;