Laravel如何使用Socialite实现第三方登录？（微信/GitHub示例）-Laravel-PHP中文网

Laravel如何使用Socialite实现第三方登录？（微信/GitHub示例）

冰火之心

发布： 2025-12-23 17:46:52

原创

346人浏览过

Laravel Socialite 实现第三方登录需配置驱动、处理重定向与回调；GitHub 开箱即用，微信需手动适配授权URL、token换取及用户信息获取流程。

laravel如何使用socialite实现第三方登录？（微信/github示例）

使用 Laravel Socialite 实现第三方登录，核心是配置驱动、处理重定向和回调逻辑。微信和 GitHub 都支持 OAuth2，但细节有差异——GitHub 官方支持开箱即用，微信（尤其是国内微信网页授权）需额外处理域名、scope 和 token 换取方式。

1. 安装与基础配置

Socialite 是 Laravel 官方维护的 OAuth 库，先安装并发布配置：

运行 composer require laravel/socialite
在 config/app.php 的 providers 数组中添加：
Laravel\Socialite\SocialiteServiceProvider::class
在 aliases 中添加：
'Socialite' => Laravel\Socialite\Facades\Socialite::class
执行 php artisan vendor:publish --provider="Laravel\Socialite\SocialiteServiceProvider" 生成 config/services.php

然后在 config/services.php 中填写凭证：

'github' => [
    'client_id' => env('GITHUB_CLIENT_ID'),
    'client_secret' => env('GITHUB_CLIENT_SECRET'),
    'redirect' => 'https://yoursite.com/login/github/callback',
],
'wechat' => [
    'client_id' => env('WECHAT_APPID'),
    'client_secret' => env('WECHAT_SECRET'),
    'redirect' => 'https://yoursite.com/login/wechat/callback',
    'base_uri' => 'https://api.weixin.qq.com/', // 微信 API 根地址（可选，用于自定义）
],

登录后复制

注意：微信不被 Socialite 原生支持，需手动扩展或使用社区适配器（如 overtrue/laravel-socialite-wechat），下文以“手动兼容方式”说明关键点。

2. 路由与登录入口

定义两个路由：跳转授权页 + 接收回调。推荐统一前缀便于管理：

Route::prefix('login')->group(function () {
    Route::get('/github', [SocialLoginController::class, 'redirectToGithub']);
    Route::get('/github/callback', [SocialLoginController::class, 'handleGithubCallback']);

    Route::get('/wechat', [SocialLoginController::class, 'redirectToWechat']);
    Route::get('/wechat/callback', [SocialLoginController::class, 'handleWechatCallback']);
});

登录后复制

在控制器中，redirectToXxx() 方法调用 Socialite::driver('xxx')->redirect() 即可发起授权请求。

⚠️ 微信特殊点：
– 网页授权需提前在公众号后台配置「授权回调域名」（不能带 http/https 和端口）；
– 推荐使用 snsapi_userinfo scope 获取用户信息（需用户同意），snsapi_base 只能拿 openid（静默授权）。

bee餐饮点餐外卖小程序

bee餐饮点餐外卖小程序是针对餐饮行业推出的一套完整的餐饮解决方案，实现了用户在线点餐下单、外卖、叫号排队、支付、配送等功能，完美的使餐饮行业更高效便捷！功能演示：1、桌号管理登录后台，左侧菜单 “桌号管理”，添加并管理你的桌号信息，添加以后在列表你将可以看到 ID 和密钥，这两个数据用来生成桌子的二维码2、生成桌子二维码例如上面的ID为 308，密钥为 d3PiIY，那么现在去左侧菜单微信设置

查看详情

3. 处理回调与用户绑定

回调方法中，用 Socialite::driver('xxx')->user() 获取用户资料。GitHub 返回标准字段（id, name, email 等），微信返回结构不同：

Github：$user->getId(), $user->getName(), $user->getEmail()
微信（网页授权）：$user->getId() 是 openid，$user->getNickname() 是昵称，$user->getAvatar() 是头像 URL；没有 email 字段，需自行设为 null 或生成唯一邮箱（如 openid@wechat.example）

典型处理逻辑：

根据第三方平台 + 用户唯一标识（如 GitHub ID / 微信 openid）查找本地用户
若不存在，创建新用户（注意密码可为空或设随机哈希）
更新最后登录时间、头像等字段
登录该用户：Auth::login($user, true)
重定向到首页或原请求路径

示例片段（简化）：

public function handleGithubCallback()
{
    $githubUser = Socialite::driver('github')->user();
    $user = User::firstOrCreate(
        ['github_id' => $githubUser->getId()],
        [
            'name' => $githubUser->getName(),
            'email' => $githubUser->getEmail(),
            'avatar' => $githubUser->getAvatar(),
        ]
    );
    Auth::login($user, true);
    return redirect()->intended('/dashboard');
}

登录后复制

4. 微信适配要点（无需第三方包）

如果不想引入额外包，可临时用 Socialite 的通用 OAuth2 支持对接微信：

在 config/services.php 中配置 wechat 时，把 client_id 和 client_secret 写对
手动构造授权 URL（因为微信 scope 和参数名不完全匹配）：
https://open.weixin.qq.com/connect/oauth2/authorize?appid={APPID}&redirect_uri={REDIRECT_URI}&response_type=code&scope=snsapi_userinfo&state=xyz#wechat_redirect
回调中，先用 code 换取 access_token 和 openid：
https://api.weixin.qq.com/sns/oauth2/access_token?appid={APPID}&secret={SECRET}&code={CODE}&grant_type=authorization_code
再用 access_token + openid 调用：
https://api.weixin.qq.com/sns/userinfo?access_token={ACCESS_TOKEN}&openid={OPENID}
将返回的 JSON 封装成类似 Socialite User 对象（或直接用数组处理），后续逻辑复用即可