Laravel中集成Socialite可实现GitHub、Google等第三方登录，需安装包并配置服务提供者、环境变量及路由，创建控制器处理跳转与回调，用户表添加provider、provider_id等字段，授权后自动注册或登录。

在Laravel中集成Socialite可以轻松实现社交媒体登录功能，比如微信、QQ、GitHub、Google等平台。Socialite是Laravel官方提供的OAuth认证扩展包，简化了第三方登录流程。

安装Laravel Socialite

使用Composer安装Socialite：

composer require laravel/socialite

安装完成后，确保在config/app.php中注册服务提供者和门面（Laravel 6+通常自动注册）：

服务提供者：

'providers' => [
    // ...
    Laravel\Socialite\SocialiteServiceProvider::class,
],

门面：

'aliases' => [
    // ...
    'Socialite' => Laravel\Socialite\Facades\Socialite::class,
],

配置第三方应用信息

前往你希望接入的平台（如GitHub）创建OAuth应用，获取Client ID和Client Secret。

在.env文件中添加配置：

GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret
GOOGLE_REDIRECT_URI=https://yoursite.com/login/google/callback
GITHUB_CLIENT_ID=your-github-client-id
GITHUB_CLIENT_SECRET=your-github-client-secret
GITHUB_REDIRECT_URI=https://www./link/0401ed6796f1f9b637d18a4ba337e1d6

然后在config/services.php中添加对应平台配置：

'github' => [
    'client_id' => env('GITHUB_CLIENT_ID'),
    'client_secret' => env('GITHUB_CLIENT_SECRET'),
    'redirect' => env('GITHUB_REDIRECT_URI'),
],
'google' => [
'client_id' => env('GOOGLE_CLIENT_ID'),
'client_secret' => env('GOOGLE_CLIENT_SECRET'),
'redirect' => env('GOOGLE_REDIRECT_URI'),
],

定义路由和控制器

在routes/web.php中添加登录和回调路由：

Route::get('/login/{provider}', [SocialAuthController::class, 'redirectToProvider']);
Route::get('/login/{provider}/callback', [SocialAuthController::class, 'handleProviderCallback']);

创建控制器SocialAuthController：

php artisan make:controller SocialAuthController

在控制器中实现方法：

use Laravel\Socialite\Facades\Socialite;
use App\Models\User;
use Illuminate\Support\Facades\Auth;
class SocialAuthController extends Controller
{
public function redirectToProvider($provider)
{
return Socialite::driver($provider)->redirect();
}
public function handleProviderCallback($provider)
{
    try {
        $socialUser = Socialite::driver($provider)->user();
    } catch (\Exception $e) {
        return redirect('/login')->withErrors('授权失败，请重试');
    }

    // 查找或创建用户
    $user = User::where('provider_id', $socialUser->getId())->first();

    if (!$user) {
        $user = User::updateOrCreate([
            'email' => $socialUser->getEmail(),
        ], [
            'name' => $socialUser->getName() ?: $socialUser->getNickname(),
            'provider_id' => $socialUser->getId(),
            'provider' => $provider,
            'avatar' => $socialUser->getAvatar(),
        ]);
    }

    Auth::login($user);

    return redirect()->intended('/dashboard');
}
}
数据库字段准备
确保用户表包含以下字段以支持第三方登录：


provider - 记录登录平台（如 github、google）

provider_id - 第三方用户的唯一ID

avatar - 用户头像（可选）

生成迁移：
php artisan make:migration add_social_fields_to_users_table --table=users
迁移内容示例：
public function up()
{
    Schema::table('users', function ($table) {
        $table->string('provider')->nullable();
        $table->string('provider_id')->nullable();
        $table->string('avatar')->nullable();
    });
}
基本上就这些。完成配置后，访问/login/github即可跳转到GitHub登录页面，授权后回到你的站点并自动登录或注册用户。