tacraft-sociality / flarum-qq-oauth

1.0.0 2026-11-01 04:55 UTC

Requires

• php: ^8.3
• flarum/core: ^2.0.2
• guzzlehttp/guzzle: ^7.7
• intervention/image: ^3.2

MIT

• TCS Dev HUB

• oauth
• login
• qq
• tencent
• social-login
• flarum

Published on Packagist.org on 2026-11-01 04:56 UTC

README

面向 Flarum 2 的 QQ（腾讯 QQ 互联）登录扩展。

• 包名：tacraft-sociality/flarum-qq-oauth
• 扩展 ID：tacraft-sociality-qq-oauth
• 目标平台：Flarum ^2.0.2、PHP ^8.3
• 许可：MIT

功能

• QQ 登录：登录与注册弹窗中显示 QQ 登录按钮（未配 App ID / App Key 时自动隐藏）。
• 首次登录即注册：首次登录带一次性注册令牌回到论坛并自动打开注册弹窗，预填昵称与头像。
• 老用户直接登录：已绑定 QQ 用户点击后直接登录并跳回原页面。
• 主动绑定 / 解绑：登录用户可在「个人资料 → 安全设置」中绑定、更换或解除 QQ 账号。
• 自定义登录图标：后台可上传 PNG / JPG / GIF / WebP 图片替换内置图标。

环境要求

项	要求
Flarum	2.0.2 及以上
PHP	8.3 及以上

安装

在 composer.json 中配置仓库地址后执行：

composer require tacraft-sociality/flarum-qq-oauth:dev-main
php flarum cache:clear

配置 QQ 互联

1. 前往 QQ 互联 创建网站应用。
2. 网站回调域填写：https://你的域名/auth/qq（需与论坛实际地址完全一致）。
3. 审核通过后获得 App ID 与 App Key，填入论坛后台对应设置项。

账号绑定

登录后进入 个人资料 → 安全设置，页面顶部会多出一个「QQ 账号」区域：

• 未绑定：显示「未绑定」和「绑定 QQ 账号」按钮。点击后跳转到 QQ 授权，授权完成会自动回到当前页面并提示绑定成功。
• 已绑定：显示脱敏后的 QQ 账号标识与绑定时间，可「更换绑定的 QQ」或「解除绑定」。

绑定规则：

• 一个 QQ 账号只能绑定一个论坛账号；如果该 QQ 已经绑定到其他用户，会提示绑定失败。
• 为当前账号更换 QQ 时，旧的 QQ 绑定会被新的替换。
• 解除绑定后，该 QQ 不能再登录此账号；以后再用这个 QQ 登录会被当作新账号重新注册。
• 后台的 QQ 回调地址仍然是 https://你的域名/auth/qq，无需修改。