Socialite（LINE Login）- LINE SDK for Laravel

概览

该包通过 Socialite::extend() 以官方方式提供 LINE Login 驱动。你可以像使用内置 provider 一样使用它。可用驱动：

驱动	说明
`line-login`	通过 LINE Login 进行 OAuth2 认证

关于 Laravel Socialite 自身的使用方式，请参见 Socialite 指南。

配置

.env

LINE_LOGIN_CLIENT_ID=
LINE_LOGIN_CLIENT_SECRET=
LINE_LOGIN_REDIRECT=

基本使用

定义路由

在 routes/web.php 中添加两个路由，分别用于跳转和回调。

use App\Http\Controllers\SocialiteController;

Route::get('login', [SocialiteController::class, 'login']);
Route::get('callback', [SocialiteController::class, 'callback']);

创建控制器

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\Request;
use Laravel\Socialite\Facades\Socialite;

class SocialiteController extends Controller
{
    public function login()
    {
        return Socialite::driver('line-login')->redirect();
    }

    public function callback(Request $request)
    {
        if ($request->missing('code')) {
            // 调试用。生产环境请改为跳转或错误处理
            return redirect('/login')->withErrors('认证已被取消。');
        }

        /** @var \Laravel\Socialite\Two\User */
        $user = Socialite::driver('line-login')->user();

        $loginUser = User::updateOrCreate([
            'line_id' => $user->id,
        ], [
            'name'          => $user->nickname,
            'avatar'        => $user->avatar,
            'access_token'  => $user->token,
            'refresh_token' => $user->refreshToken,
        ]);

        auth()->login($loginUser, true);

        return redirect()->route('home');
    }
}

可选参数

可以通过 with() 传入附加参数。

public function login()
{
    return Socialite::driver('line-login')->with([
        'prompt'     => 'consent',
        'bot_prompt' => 'normal',
    ])->redirect();
}

Scope 配置

通过 scope 指定要获取的权限。

public function login()
{
    return Socialite::driver('line-login')
                    ->setScopes(['profile', 'openid'])
                    ->redirect();
}

主要的 scope 列表请参见 LINE Login Scope。

更多最新信息请参见 GitHub 仓库。

最后修改于 2026年7月13日

​概览

​配置

​.env

​基本使用

​可选参数

​Scope 配置

概览

配置

.env

基本使用

可选参数

Scope 配置