嗨，我是 Eric。在台灣做網頁開發，如果你的登入選項裡沒有「LINE 登入」，客戶大概會用一種看原始人的眼神看你。畢竟在台灣，LINE 的滲透率高得嚇人，對使用者來說，掃個 QR Code 或點一下按鈕就能登入，體驗絕對比在那邊輸入帳號密碼好上一百倍。

但是，身為工程師的我們都知道，處理 OAuth 2.0 協議有時候真的很阿雜。你要處理 Redirect、要把 Access Token 換回來、要拿 Token 去換 User Profile，中間還要處理各種 Error Handling 和 State 驗證。如果你還在用原生的 CURL 去手刻這些流程，聽 Eric 一句勸：生命很美好，不要浪費在重複造輪子上。

今天這篇文章，我要帶大家用 Laravel 官方推薦的 Laravel Socialite 套件，搭配 Socialite Providers，優雅、快速且安全地完成 LINE Login 的串接。我們目標是：寫最少的 Code，做最穩的功能。

為什麼選擇 Socialite？

你可能會問：「Eric，我自己刻 API 請求不行嗎？」行，當然行。但使用 Socialite 有幾個決定性的優勢：

• 標準化介面： 不管你今天是接 LINE、Facebook 還是 Google，Socialite 提供的介面（Interface）幾乎是一模一樣的。這意味著如果未來業主突然說要加一個 Google 登入，你的程式碼架構幾乎不用動。
• 安全性： Socialite 自動幫你處理了 CSRF 防護（透過 state 參數），這是手刻最容易忽略的資安漏洞之一。
• 社群維護： LINE 的 API 偶爾會改版，使用社群維護的 Provider 套件，通常更新速度會比你手動維護快得多。

第一步：LINE Developers Console 的前置作業

在碰 Laravel 程式碼之前，我們得先去 LINE 的地盤拿通行證。這部分雖然繁瑣，但卻是這整個流程的「心臟」。

1. 前往 LINE Developers Console 並登入。
2. 建立一個新的 Provider（如果你還沒有的話）。
3. 在該 Provider 下建立一個新的 LINE Login Channel。
4. 關鍵設定：
   • 切換到 Basic settings 分頁，記下你的 Channel ID 和 Channel secret。
   • 切換到 LINE Login 分頁，找到 Callback URL。這裡必須填入你 Laravel 專案接收回應的網址。例如：http://localhost:8000/auth/line/callback（本機開發）或是 https://your-domain.com/auth/line/callback（正式站）。
   • 注意： 如果你需要取得使用者的 Email，請務必在 Basic settings 下方的 OpenID Connect 區域申請 Email 權限，這通常需要截圖你的隱私權政策給 LINE 審核。

第二步：安裝 Laravel Socialite 與 LINE Provider

Laravel 預設的 Socialite 支援 Facebook、Twitter、Google 等巨頭，但剛好沒有內建 LINE。所以我們需要額外安裝 socialiteproviders/line 這個社群驅動的套件。

打開你的 Terminal，在專案根目錄下執行：

composer require laravel/socialite socialiteproviders/line

第三步：配置設定檔

這是很多新手容易卡關的地方，請仔細檢查。

1. 修改 .env 檔案

將剛剛從 LINE Console 拿到的資訊填入：

LINE_CHANNEL_ID=你的ChannelID
LINE_CHANNEL_SECRET=你的ChannelSecret
LINE_CALLBACK_URL=http://your-domain.com/auth/line/callback

2. 設定 config/services.php

告訴 Laravel 如何讀取這些環境變數：

'line' => [
    'client_id' => env('LINE_CHANNEL_ID'),
    'client_secret' => env('LINE_CHANNEL_SECRET'),
    'redirect' => env('LINE_CALLBACK_URL'),
],

3. 註冊 Event Listener (關鍵！)

因為我們是用外掛的 Provider，必須告訴 Socialite 怎麼處理 LINE 的請求。在 app/Providers/EventServiceProvider.php (Laravel 10 或更早) 或透過 AppServiceProvider (Laravel 11) 進行配置。

如果是 Laravel 11，建議直接在 app/Providers/AppServiceProvider.php 的 boot 方法加入：

use Illuminate\Support\Facades\Event;
use SocialiteProviders\Manager\SocialiteWasCalled;
use SocialiteProviders\Line\LineExtendSocialite;

public function boot(): void
{
    Event::listen(
        SocialiteWasCalled::class,
        LineExtendSocialite::class
    );
}

第四步：撰寫 Controller 邏輯

接下來就是重頭戲了，我們需要兩個路由：一個是把使用者踢去 LINE 登入頁面，另一個是接使用者回來。

建立一個 LoginController (或專門的 SocialAuthController)：

<?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 LineAuthController extends Controller
{
    // 1. 重導向至 LINE 登入頁
    public function redirectToProvider()
    {
        return Socialite::driver('line')->redirect();
    }

    // 2. 處理 Callback
    public function handleProviderCallback()
    {
        try {
            // 這裡 Socialite 會自動幫你做 State 驗證和 Token 交換
            $lineUser = Socialite::driver('line')->user();

            // 取得使用者資料
            // $lineUser->getId();
            // $lineUser->getName();
            // $lineUser->getEmail(); // 注意：需先在 Console 申請權限
            // $lineUser->getAvatar();

            // Eric 的邏輯：尋找是否已存在該 LINE ID 的使用者，沒有就建立
            $user = User::firstOrCreate(
                ['line_id' => $lineUser->getId()],
                [
                    'name' => $lineUser->getName(),
                    'email' => $lineUser->getEmail() ?? $lineUser->getId() . '@line.login', // 若沒 Email 的 fallback 策略
                    'password' => bcrypt(Str::random(16)), // 隨機密碼
                    'avatar' => $lineUser->getAvatar(),
                ]
            );

            // 登入該使用者
            Auth::login($user, true);

            return redirect()->route('dashboard');

        } catch (\Exception $e) {
            // 登入失敗或使用者取消授權
            return redirect()->route('login')->with('error', 'LINE 登入失敗');
        }
    }
}

第五步：設定路由

在 routes/web.php 加入：

use App\Http\Controllers\Auth\LineAuthController;

Route::get('auth/line', [LineAuthController::class, 'redirectToProvider'])->name('auth.line');
Route::get('auth/line/callback', [LineAuthController::class, 'handleProviderCallback']);

Eric 的私房筆記：那些官方文件沒說的「坑」

依照上面的步驟，你應該可以順利跑通流程。但在真實的專案開發中，往往會有更多細節需要注意：

1. 拿不到 Email？

很多開發者問我：「Eric，為什麼 $lineUser->getEmail() 回傳是 null？」通常有兩個原因：第一，你沒有在 LINE Developers Console 申請 Email 存取權限；第二，使用者在授權頁面「取消勾選」分享 Email。所以你的程式碼一定要有 Fallback 機制，不要假設 Email 一定存在。

2. 400 Bad Request

這是最常見的錯誤，99% 都是因為 Callback URL 不一致。請確保 LINE Console 上填寫的網址，與你 .env 裡設定的完全一模一樣，包含 http 跟 https 的差異，甚至結尾的斜線。

3. 使用者資料整合的難題

如果你同時有 Facebook 登入和 LINE 登入，你會遇到一個經典問題：「同一個使用者用不同方式登入，系統會變成兩個人」。這時候你需要更進階的 API 策略來縫合這些身分。

相關延伸閱讀

想讓你的登入系統更強大，或解決多渠道使用者的問題，建議參考以下這幾篇進階實戰文章：

• 你的客戶在 LINE 叫陳先生，在臉書叫 David C.？終極 API 戰術，縫合破碎的用戶數據，打造無斷點客服體驗！
• API 金鑰之亂終結者：Laravel + JWT 深度實戰，打造無狀態認證的現代化後端！
• 你的 App 還是啞巴？Laravel 通知系統 (Notifications) 實戰：從 Email 到 Slack，打造全方位訊息中心

結語

透過 Laravel Socialite 整合 LINE Login，原本可能需要一整天手刻的工作，現在可能只需要一小時就能搞定。這就是現代框架開發的魅力：專注在核心業務邏輯，基礎設施交給專業的套件。

如果你在串接過程中遇到奇怪的 Bug，或是需要規劃更複雜的企業級會員系統（例如整合 CRM、ERP），歡迎隨時來找我們聊聊！