- 简单介绍：DouPHP 微信登录插件配置指南：支持 PC 扫码与微信公众号内网页授权两种登录方式。需在微信开放平台注册"网站应用"、在公众号"基本配置"里获取 AppID / AppSecret，并严格对齐授权回调域、业务域名、JS 接口安全域名与网页授权域名。
- 编号： 分类： 开发者：DouCo Co.,Ltd 更新时间：2026-09-28 下载量：389
- **安装与启用**
先在 DouPHP+ 中安装"**插件模块**"，然后在插件模块里安装"**微信登录**"插件，安装完成后再进入插件设置进行配置。
**可用场景提醒**
微信登录插件适用的场景包含：
- PC 端网页
- 手机浏览器（同样通过扫码登录，但体验较差，建议引导客户通过**公众号**访问）
- 微信公众号
不包含**小程序登录**。小程序登录在 DouPHP 小程序模块中单独配置小程序信息即可实现，与微信登录插件相互独立。
**配置复杂度提示**
微信登录插件配置较为复杂，第一次配置通常要花较多时间慢慢调试——这类插件是**双向通信**的：DouPHP 这边配置完全正确，微信端任何一处不对都会导致无法使用。请仔细查看系统给出的提示，特别是"**授权回调域**"和"**业务域名 / JS 接口安全域名 / 网页授权域名**"这类与域名相关的字段，一点点差异都不行：
- `http://` 与 `https://` 视为不同域名；
- 加 `www` 与不加 `www` 视为不同域名。
若微信端填写的是 `www.domain.com`，而访问网站使用的是 `domain.com`（不带 www），会被判定为不一致；https / http 混用同理。
**一、配置插件**
插件配置分两部分，如下图：**红色部分**负责 PC 端或手机端通过扫码登录；**蓝色部分**负责在公众号里直接点击登录。
需要先理解一个概念：PC 端浏览器本身并未集成微信、且多数 PC 未安装微信客户端，无法直接唤起微信登录，必须用手机上的微信扫码登录；公众号则不同，本身就是微信自家的产品，可以直接实现点击登录。理解这一点后，您就会明白为什么微信登录要设置这么多字段。
**1. APPID（微信开放平台）、APPSECRET（微信开放平台）—— PC 端扫码登录**
前往"**微信开放平台 → 管理中心 → 网站应用**"提交申请（申请步骤按微信端提示完成，此处不再详述）。设置"**授权回调域**"时，`domain.com` 与 `www.domain.com` 会被视为两个不同的域名——注意：这里填写的是您自己的域名，不要照抄示例。
审核通过后回到"网站应用"，找到您申请的应用，点击查看即可获得 **APPID** 与 **APPSECRET**（需先生成）。
**2. APPID（微信公众号）、APPSECRET（微信公众号）—— 公众号内点击登录**
填入微信公众号（**服务号**）申请到的 APPID 与 APPSECRET，位置在"**公众号 → 基本配置**"里。
另外在"**公众号设置 → 功能设置**"里需要配置：**业务域名**、**JS 接口安全域名**、**网页授权域名**。这 3 处只需输入**域名本身**（不带 `http://` / `https://`），例如 `www.domain.com`；严格区分加 `www` 与不加 `www`：公众号菜单里配置的域名包含 `www`，这里也必须是包含 `www` 的版本（注意：填写您自己的域名，不要照抄示例）。
**二、关于微信开放平台**
微信开放平台有两个作用：
1. PC 端使用微信登录只能从开放平台申请；
2. 绑定"网站应用 / 公众号 / 小程序"。
如果您只有公众号，就没必要配置开放平台；只有小程序也没必要配置。**但如果要让"网站应用 / 公众号 / 小程序"三端登录的会员打通**，就必须把公众号和小程序在开放平台的"**管理中心**"里进行**账号绑定**，然后在代码中使用 `unionid` 作为唯一标识；否则只能使用各终端拿到的 `openid` 作为唯一标识。同一个微信号在"网站应用 / 公众号 / 小程序"三处拿到的 `openid` 都是不一样的（这是开发层要处理的问题，只是帮助您理解为什么需要绑定）。
**在 DouPHP 中的启用与配置：**
1. 安装插件：后台 → 插件扩展 → 安装插件，在 DouPHP 官方插件列表按名称找到「微信登录」→ 点击「安装」；系统自动从 douphp.com 抓取插件包并部署到 `include/plugin/wxlogin/` 目录
2. 启用与配置：返回后台 → 插件扩展 → 管理插件，在已安装列表定位到「微信登录」→ 点击「启用」即进入插件配置页 → 按上文要求依次填入 PID / KEY / APPID / 公钥 / 回调地址等凭据 → 保存
3. 停用与卸载：仍在管理插件页，对该行点「停用」临时关闭前台入口；点「删除」会连同该插件的配置数据一并移除，谨慎操作