Fastadmin 第三方登录扩展：微信小程序模块集成实战

最新推荐文章于 2026-08-18 21:49:55 发布

原创

最新推荐文章于 2026-08-18 21:49:55 发布 · 835 阅读

1. 为什么你的Fastadmin后台需要微信小程序登录？

如果你正在用Fastadmin搭建一个后台管理系统，同时又在运营一个微信小程序，那你肯定遇到过这样的问题：用户在小程序里注册了账号，但想登录后台查看订单、管理资料时，却要重新注册一遍。这不仅让用户觉得麻烦，更关键的是，两套用户体系是割裂的，数据无法打通，管理起来也头疼。

这时候，第三方登录扩展的微信小程序模块就派上用场了。它的核心价值就一句话：让小程序用户能直接用微信身份，一键登录你的Fastadmin后台。听起来是不是省心多了？我做过好几个类似的项目，每次集成都感觉像是给系统装上了一把“万能钥匙”，用户方便，我们开发维护也轻松。

这个模块的原理其实不复杂。简单来说，就是当用户在你的小程序里点击“登录”时，小程序会向微信服务器要一个临时的“通行证”（code）。然后，你的Fastadmin后台拿着这个“通行证”和自己的“身份证”（AppID和AppSecret）去微信服务器换一个真正的“身份令牌”（session_key和openid）。有了这个“身份令牌”，我们就能确认用户是谁，并把他/她在小程序里的头像、昵称等信息同步到Fastadmin的用户表里，完成登录和账号绑定。

所以，这个集成不仅仅是加个登录按钮那么简单。它意味着：

用户体验无缝衔接：用户无需记忆新账号密码。
数据统一管理：后台用户和小程序用户一一对应，用户画像更完整。
开发效率提升：复用成熟的微信授权体系，比自己从头开发一套安全认证要快得多、稳得多。

接下来，我就手把手带你走一遍完整的集成流程，从安装插件到写核心代码，把每一步的细节和可能遇到的“坑”都讲清楚。只要你跟着做，半小时内让小程序用户登录你的Fastadmin后台，绝对不是问题。

2. 集成前的准备工作：环境与账号检查

在动手敲代码之前，有几件“小事”必须确认好，这能帮你避开一大半的弯路。我自己就曾因为没检查环境，折腾了半天才发现问题出在PHP扩展上。

首先，确保你的Fastadmin环境是“健康”的。

PHP版本：建议使用PHP 7.3及以上版本。太老的版本（如5.6）可能对某些新的加密库支持不好。你可以通过创建一个 info.php 文件，内容为 <?php phpinfo(); ?>，在浏览器访问来查看。
关键扩展：必须确保 openssl 和 curl 扩展已安装并启用。微信服务器的所有通信都是HTTPS的，没有openssl会直接报错；而curl则是我们发起网络请求的“主力军”。同样在 phpinfo() 页面里搜索这两个关键词确认。
Composer：这是现代PHP项目的包管理器。我们需要通过它来安装一个非常重要的依赖：EasyWeChat。在命令行输入 composer --version，看看是否能正常显示版本号。

其次，也是最重要的一步：搞定微信小程序后台配置。 你不能用一个“黑户”小程序来做登录，所有信息都必须从微信官方获取。

登录微信公众平台：用你的小程序管理员账号登录 https://mp.weixin.qq.com/。
找到你的“身份证”：在左侧菜单找到 “开发” -> “开发管理” -> “开发设置”。这里你会看到两个关键信息：
- AppID（小程序ID）：这是小程序的唯一标识，相当于身份证号。
- AppSecret（小程序密钥）：这是非常重要的密钥，绝不能泄露。如果你还没生成或忘记了，点击“重置”获取一个新的，并立即妥善保存。
配置服务器域名（关键！）：还是在“开发设置”页面，找到 “服务器域名” 部分。你需要将你的Fastadmin后台站点的域名（比如 https://yourdomain.com）添加到 “request合法域名” 列表中。这是因为小程序前端请求wx.login()获取的code，需要发送到你的后台服务器，如果后台域名不在白名单里，这个请求会被微信拦截。这一步很多新手都会忽略，导致一直拿不到code。

把这些准备工作比作盖房子前打地基和备好建材，地基稳了，后面的“施工”才能又快又顺。

3. 第一步：安装与配置第三方登录插件

Fastadmin的生态很好，有很多现成的插件。我们这里要用的就是 “第三方登录” 插件。

安装插件：

进入Fastadmin后台，找到 “插件管理”。
在插件市场里搜索“第三方登录”，找到后点击安装。安装过程通常是自动的，它会创建必要的数据库表和目录结构。安装成功后，你会在项目的 addons 目录下看到一个名为 third 的文件夹，这就是插件的根目录。

配置微信小程序模块： 插件安装好后，默认可能只支持QQ、微博、普通微信公众号登录。我们需要手动把微信小程序加进去。这是核心配置步骤，配错了后面全白搭。

找到这个文件：addons/third/config.php。这个文件定义了所有支持的登录方式及其配置表单。我们需要在 $config 数组里，添加微信小程序的配置项。通常，你可以加在 wechat（微信公众号）配置的后面。

// 文件路径：addons/third/config.php
// 在配置数组中添加如下内容（注意看注释，别直接复制）
[
    'name'    => 'wechatmini', // 唯一标识，后面代码里会用到
    'title'   => '微信小程序', // 在后台设置页显示的名称

标签