IT技术社区_专业开发者平台_最新编程教程与解决方案 -沐辰社区

PHP项目Socialite多提供商

wen PHP项目 197

本文目录导读：

PHP项目Socialite多提供商

  1. 安装与配置
  2. 路由配置
  3. 控制器实现
  4. 前端视图
  5. 高级功能实现
  6. 异常处理与日志
  7. 环境变量配置 (.env)
  8. 注意事项

我来帮您梳理PHP项目中使用Socialite实现多提供商登录的完整方案。

安装与配置

安装Socialite

composer require laravel/socialite

配置文件 (config/services.php)

return [
    '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'),
    ],
    'facebook' => [
        'client_id' => env('FACEBOOK_CLIENT_ID'),
        'client_secret' => env('FACEBOOK_CLIENT_SECRET'),
        'redirect' => env('FACEBOOK_REDIRECT_URI'),
    ],
    // 添加更多提供商...
];

路由配置

// routes/web.php
Route::prefix('auth')->group(function () {
    // 通用重定向路由
    Route::get('{provider}/redirect', [AuthController::class, 'redirect'])->name('auth.provider.redirect');
    // 通用回调路由
    Route::get('{provider}/callback', [AuthController::class, 'callback'])->name('auth.provider.callback');
});

控制器实现

基础控制器

<?php
namespace App\Http\Controllers\Auth;
use App\Http\Controllers\Controller;
use Laravel\Socialite\Facades\Socialite;
use App\Models\User;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Str;
class AuthController extends Controller
{
    // 支持的提供商列表
    protected $providers = [
        'github', 'google', 'facebook', 'twitter', 'linkedin',
        'qq', 'wechat', 'weibo'
    ];
    /**
     * 重定向到提供商
     */
    public function redirect($provider)
    {
        // 验证提供商是否支持
        if (!in_array($provider, $this->providers)) {
            return redirect()->route('login')->with('error', '不支持的登录方式');
        }
        // 特殊处理微信扫码
        if ($provider === 'wechat') {
            return Socialite::with($provider)->scopes(['snsapi_login'])->redirect();
        }
        return Socialite::driver($provider)->redirect();
    }
    /**
     * 回调处理
     */
    public function callback($provider)
    {
        try {
            // 验证提供商
            if (!in_array($provider, $this->providers)) {
                throw new \Exception('不支持的登录方式');
            }
            // 获取第三方用户信息
            $socialUser = Socialite::driver($provider)->user();
            // 处理用户登录/注册
            $user = $this->findOrCreateUser($socialUser, $provider);
            // 登录用户
            Auth::login($user, true);
            // 重定向到首页
            return redirect()->intended('/dashboard');
        } catch (\Exception $e) {
            return redirect()->route('login')->with('error', '登录失败: ' . $e->getMessage());
        }
    }
    /**
     * 查找或创建用户
     */
    protected function findOrCreateUser($socialUser, $provider)
    {
        // 先尝试通过提供商ID查找
        $user = User::where('provider', $provider)
                    ->where('provider_id', $socialUser->getId())
                    ->first();
        if ($user) {
            // 更新用户信息
            $this->updateUserInfo($user, $socialUser, $provider);
            return $user;
        }
        // 尝试通过邮箱查找
        if ($socialUser->getEmail()) {
            $user = User::where('email', $socialUser->getEmail())->first();
            if ($user) {
                // 绑定提供商信息
                $user->update([
                    'provider' => $provider,
                    'provider_id' => $socialUser->getId(),
                ]);
                $this->updateUserInfo($user, $socialUser, $provider);
                return $user;
            }
        }
        // 创建新用户
        return $this->createUser($socialUser, $provider);
    }
    /**
     * 创建新用户
     */
    protected function createUser($socialUser, $provider)
    {
        $user = User::create([
            'name' => $socialUser->getName() ?? $socialUser->getNickname(),
            'email' => $socialUser->getEmail(),
            'provider' => $provider,
            'provider_id' => $socialUser->getId(),
            'avatar' => $socialUser->getAvatar(),
            'password' => bcrypt(Str::random(16)), // 随机密码
        ]);
        return $user;
    }
    /**
     * 更新用户信息
     */
    protected function updateUserInfo($user, $socialUser, $provider)
    {
        $updateData = [
            'avatar' => $socialUser->getAvatar() ?? $user->avatar,
            'provider' => $provider,
            'provider_id' => $socialUser->getId(),
        ];
        // 更新昵称（如果用户没有设置过）
        if (!$user->name || $user->name === 'User') {
            $updateData['name'] = $socialUser->getName() ?? $socialUser->getNickname();
        }
        $user->update($updateData);
    }
}

用户模型迁移

// database/migrations/xxxx_add_social_fields_to_users_table.php
Schema::table('users', function (Blueprint $table) {
    $table->string('provider')->nullable()->after('email');
    $table->string('provider_id')->nullable()->after('provider');
    $table->string('avatar')->nullable()->after('provider_id');
    // 添加索引
    $table->unique(['provider', 'provider_id']);
});

前端视图

登录页面

{{-- resources/views/auth/login.blade.php --}}
@extends('layouts.app')
@section('content')
<div class="container">
    <div class="row justify-content-center">
        <div class="col-md-8">
            <div class="card">
                <div class="card-header">{{ __('登录') }}</div>
                <div class="card-body">
                    {{-- 社交登录按钮 --}}
                    <div class="mb-4">
                        <h5>快捷登录</h5>
                        <div class="d-flex flex-wrap gap-2">
                            <a href="{{ route('auth.provider.redirect', 'github') }}" class="btn btn-dark">
                                <i class="fab fa-github"></i> GitHub
                            </a>
                            <a href="{{ route('auth.provider.redirect', 'google') }}" class="btn btn-danger">
                                <i class="fab fa-google"></i> Google
                            </a>
                            <a href="{{ route('auth.provider.redirect', 'facebook') }}" class="btn btn-primary">
                                <i class="fab fa-facebook"></i> Facebook
                            </a>
                            <a href="{{ route('auth.provider.redirect', 'wechat') }}" class="btn btn-success">
                                <i class="fab fa-weixin"></i> 微信
                            </a>
                        </div>
                    </div>
                    {{-- 传统登录表单 --}}
                    <form method="POST" action="{{ route('login') }}">
                        @csrf
                        {{-- 表单内容 --}}
                    </form>
                </div>
            </div>
        </div>
    </div>
</div>
@endsection

高级功能实现

令牌刷新中间件

<?php
namespace App\Http\Middleware;
use Closure;
use Laravel\Socialite\Facades\Socialite;
use Illuminate\Support\Facades\Cache;
class RefreshSocialToken
{
    public function handle($request, Closure $next)
    {
        $user = auth()->user();
        if ($user && $user->provider) {
            // 检查token是否需要刷新
            $tokenExpiry = Cache::get("token_expiry_{$user->id}");
            if ($tokenExpiry && now()->gt($tokenExpiry)) {
                // 刷新token
                $this->refreshToken($user);
            }
        }
        return $next($request);
    }
    protected function refreshToken($user)
    {
        try {
            $provider = Socialite::driver($user->provider);
            // 获取新的token
            $newToken = $provider->refreshToken($user->social_token);
            // 更新用户token
            $user->update([
                'social_token' => $newToken->access_token,
            ]);
            // 设置新的过期时间
            Cache::put(
                "token_expiry_{$user->id}", 
                now()->addSeconds($newToken->expires_in)
            );
        } catch (\Exception $e) {
            Log::error("Token refresh failed for user {$user->id}: " . $e->getMessage());
        }
    }
}

多提供商管理控制器

<?php
namespace App\Http\Controllers\Auth;
use App\Http\Controllers\Controller;
use Illuminate\Http\Request;
use Laravel\Socialite\Facades\Socialite;
class ProviderManagementController extends Controller
{
    /**
     * 查看已绑定的提供商
     */
    public function index()
    {
        $user = auth()->user();
        $boundProviders = $this->getBoundProviders($user);
        return view('auth.providers', compact('boundProviders'));
    }
    /**
     * 绑定新的提供商
     */
    public function bind($provider)
    {
        session(['bind_provider' => true]);
        return Socialite::driver($provider)->redirect();
    }
    /**
     * 处理绑定回调
     */
    public function bindCallback($provider)
    {
        $socialUser = Socialite::driver($provider)->user();
        $user = auth()->user();
        // 检查是否已被其他用户绑定
        $existingUser = User::where('provider', $provider)
                           ->where('provider_id', $socialUser->getId())
                           ->first();
        if ($existingUser && $existingUser->id !== $user->id) {
            return redirect()->back()->with('error', '该账号已被其他用户绑定');
        }
        // 绑定提供商到当前用户
        $user->update([
            'provider' => $provider,
            'provider_id' => $socialUser->getId(),
        ]);
        return redirect()->route('auth.providers')->with('success', '绑定成功');
    }
    /**
     * 解绑提供商
     */
    public function unbind($provider)
    {
        $user = auth()->user();
        // 防止解绑最后一个登录方式
        if ($user->password === null && $this->getBoundProviders($user)->count() <= 1) {
            return redirect()->back()->with('error', '至少保留一种登录方式');
        }
        $user->update([
            'provider' => null,
            'provider_id' => null,
        ]);
        return redirect()->route('auth.providers')->with('success', '解绑成功');
    }
    /**
     * 获取用户绑定的提供商
     */
    protected function getBoundProviders($user)
    {
        $providers = collect();
        if ($user->provider) {
            $providers->push([
                'name' => $user->provider,
                'bound_at' => $user->updated_at,
            ]);
        }
        return $providers;
    }
}

异常处理与日志

// app/Exceptions/Handler.php
public function register()
{
    $this->reportable(function (InvalidStateException $e) {
        Log::error('Socialite state mismatch', [
            'ip' => request()->ip(),
            'user_agent' => request()->userAgent(),
        ]);
        return redirect()->route('login')->with('error', '登录状态失效，请重试');
    });
}

环境变量配置 (.env)

# GitHub
GITHUB_CLIENT_ID=your_github_client_id
GITHUB_CLIENT_SECRET=your_github_client_secret
GITHUB_REDIRECT_URI=${APP_URL}/auth/github/callback
# Google
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=${APP_URL}/auth/google/callback
# Facebook
FACEBOOK_CLIENT_ID=your_facebook_app_id
FACEBOOK_CLIENT_SECRET=your_facebook_app_secret
FACEBOOK_REDIRECT_URI=${APP_URL}/auth/facebook/callback

注意事项

  1. 安全性: 使用HTTPS保证数据传输安全
  2. 状态验证: Socialite自动处理状态验证，防止CSRF
  3. 邮箱验证: 部分提供商可能不提供邮箱，需要额外处理
  4. 错误处理: 完善异常捕获和用户提示
  5. 限流: 对第三方登录接口做限流处理

这个方案支持多种社交媒体登录,包括GitHub、Google、Facebook、微信等，并且具有良好的扩展性，如果需要添加新的提供商，只需在配置文件中添加相应的配置即可。

版权声明：NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播

上一篇PHP项目Spatie权限包用法

下一篇PHP项目Laravel-permission vs entrust

相关文章

抱歉，评论功能暂时关闭!

友情链接攻略窝 · 礼包窝 · 配置窝 · 换算窝 · 算法窝 · 查文窝 · 手册窝 · 问答窝 · 全文搜 · 手册库
相关站点礼包窝 · 查文窝