laravel Socialite 可实现微信和 gitHub 第三方登录，需先安装 socialite 包并配置服务信息，在 services.php 和 .env 中添加对应平台的 client_id、client_secret 及回调地址，通过定义路由调用 Socialite::driver(‘github’) 或 wechat 进行授权跳转与回调处理，获取用户信息后查找或创建本地用户并登录，注意微信需使用 socialiteproviders/weixin 扩展支持且返回数据可能无 email，需补充处理。
使用 Laravel Socialite 可以轻松实现第三方登录，比如微信、GitHub 等平台。Socialite 提供了简洁的 API 来处理 OAuth 认证流程。下面分别介绍如何在 Laravel 项目中集成微信和 GitHub 登录。
1. 安装 Laravel Socialite
在开始之前，请确保你已创建好 Laravel 项目。通过 composer 安装 Socialite：
composer require laravel/socialite
安装完成后，Laravel 8+ 会自动注册服务提供者，无需手动操作。如果不是自动注册，请检查 config/app.php 中是否包含：
‘providers’ => [ LaravelSocialiteSocialiteServiceProvider::class, ], ‘aliases’ => [ ‘Socialite’ => LaravelSocialiteFacadesSocialite::class, ]
2. 配置第三方应用信息
打开 config/services.php 文件，添加微信和 GitHub 的配置项。
GitHub 登录配置：
前往 GitHub Developer Settings 创建 OAuth app，获取 Client ID 和 Client Secret。
‘github’ => [ ‘client_id’ => env(‘GITHUB_CLIENT_ID’), ‘client_secret’ => env(‘GITHUB_CLIENT_SECRET’), ‘redirect’ => ‘http://your-app.com/login/github/callback’, ], 微信登录配置（网页授权登录）：
前往 微信开放平台 创建网站应用，获取 App ID 和 App Secret。
‘wechat’ => [ ‘client_id’ => env(‘WECHAT_CLIENT_ID’), ‘client_secret’ => env(‘WECHAT_CLIENT_SECRET’), ‘redirect’ => ‘http://your-app.com/login/wechat/callback’, ],
然后在 .env 文件中添加对应环境变量：
GITHUB_CLIENT_ID=your_github_client_id GITHUB_CLIENT_SECRET=your_github_client_secret WECHAT_CLIENT_ID=your_wechat_appid WECHAT_CLIENT_SECRET=your_wechat_appsecret
3. 添加路由
在 routes/web.php 中定义登录和回调路由：
use LaravelSocialiteFacadesSocialite; // GitHub 登录 Route::get(‘/login/github’, function () { return Socialite::driver(‘github’)->redirect(); }); Route::get(‘/login/github/callback’, function () { $user = Socialite::driver(‘github’)->user(); // 处理用户逻辑，如登录或注册 dd($user->getId(), $user->getName(), $user->getEmail(), $user->getAvatar()); }); // 微信登录 Route::get(‘/login/wechat’, function () { return Socialite::driver(‘wechat’)->redirect(); }); Route::get(‘/login/wechat/callback’, function () { $user = Socialite::driver(‘wechat’)->user(); dd($user->getId(), $user->getName(), $user->getAvatar()); });
4. 处理用户登录逻辑
回调中获取到用户信息后，通常需要查找或创建本地用户。示例代码如下：
use AppModelsUser; use IlluminateSupportFacadesAuth; $user = Socialite::driver(‘github’)->user(); $localUser = User::where(‘github_id’, $user->getId())->first(); if (!$localUser) { $localUser = User::create([ ‘name’ => $user->getName(), ’email’ => $user->getEmail(), ‘github_id’ => $user->getId(), ‘avatar’ => $user->getAvatar(), ‘password‘ => encrypt(‘some_random_password’) // 第三方登录可不设密码 ]); } Auth::login($localUser);
注意：微信返回的信息中可能不含 email，需根据实际业务决定是否要求补充信息。
5. 常见问题与注意事项
- 确保回调地址与第三方平台填写的一致，包括协议（http/https）
- 微信登录需在开放平台申请“网站应用”，而非公众号
- 生产环境建议启用 HTTPS，否则部分平台会拒绝回调
- Socialite 默认不支持微信，需确认使用的是支持微信的扩展版本（如 socialiteproviders/weixin）
若原生 Socialite 不支持微信，可通过安装社区驱动：
composer require socialiteproviders/weixin
并参考其文档注册服务提供者。
基本上就这些。按照步骤配置好客户端信息，处理回调数据，就能实现平滑的第三方登录体验。