Laravel 多語系網站架構教學

本教學將引導你在 Laravel （主要是 12.x 版） 中建立一套乾淨的多語系架構，包含：

• 支援 /en、/zh-TW 等語系前綴網址

• 將語言變數 $lang 傳入 Blade 模板

• 可共用語系檔或不使用語系檔皆可判斷語言

專案結構概覽

app/
├── Http/
│   └── Controllers/
│       ├── BaseController.php
│       └── HomeController.php
lang/
├── en/messages.php
└── zh-TW/messages.php
resources/
└── views/
    ├── home.blade.php
    └── about.blade.php
routes/
└── web.php

將語系檔放在根目錄 /lang

lang/en/messages.php

內容範例：

return [
    'welcome' => 'Welcome!',
    'about' => 'About Us',
    'designer' => 'Designer',
    'developer' => 'Developer',
];

這裡之後是判斷語系後，就可以從對應的變數讀取內容。

建立 BaseController 處理語言

建立要來處理語言的 Controller

app/Http/Controllers/BaseController.php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\App;
use Illuminate\Routing\Controller;

class BaseController extends Controller
{
    protected string $lang = 'zh-TW';

    public function setLocale(string $lang): void
    {
        $this->lang = in_array($lang, ['en', 'zh-TW']) ? $lang : 'zh-TW';
        App::setLocale($this->lang);
    }

    protected function view(string $view, array $data = [])
    {
        return view($view, array_merge(['lang' => $this->lang], $data));
    }
}

這裡是讓所有的 Controller 都可以透過 BaseController 來處理語系。

建立 HomeController 並設定其使用 BaseController

app/Http/Controllers/HomeController.php

namespace App\Http\Controllers;

class HomeController extends BaseController
{
    public function index($lang)
    {
        $this->setLocale($lang);
        return $this->view('home');
    }

    public function about($lang)
    {
        $this->setLocale($lang);

        $team = [
            ['name' => 'Alice', 'role' => __('messages.designer')],
            ['name' => 'Bob', 'role' => __('messages.developer')],
        ];

        return $this->view('about', ['team' => $team]);
    }
}

因為繼承了 BaseController，所以就能直接使用 setLocale 還有 view 的方法。

設定 Routes

route/web.php

use Illuminate\Support\Facades\Route;
use App\Http\Controllers\HomeController;

// 預設導向到 zh-TW
Route::get('/', fn () => redirect('/zh-TW'));

Route::group(['prefix' => '{lang}'], function () {
    Route::get('/', [HomeController::class, 'index'])->name('home');
    Route::get('/about', [HomeController::class, 'about'])->name('about');
});

Blade 模板使用語言變數與翻譯

resources/views/home.blade.php

前面如果都設定好了，就可以在 blade 模板驗證是否可以抓到對應的語系內容了：

<h1>{{ __('messages.welcome') }}</h1>
<p>目前語系：{{ $lang }}</p>

以上就是在 Laravel 設定多語系架構的做法。