本教程详细讲解如何在Laravel多语言网站中，通过路由组和自定义中间件，为所有路由统一添加语言前缀参数。这种方法确保了URL结构的一致性（如`/en/blog`），并集中处理语言切换、验证及应用语言环境，从而实现更简洁、可维护的多语言路由管理。
在构建多语言网站时，一个常见的需求是让URL结构清晰地反映当前语言，例如 /en/blog 或 /fa/blog。这不仅有助于用户识别当前语言环境，也对SEO有所裨益。Laravel提供了一套灵活的路由系统，结合中间件，可以优雅地实现这一目标。
核心策略：基于语言前缀的路由组
为了在所有路由前添加语言参数，我们可以利用Laravel的路由组功能，并结合 prefix 方法。通过将所有需要国际化的路由包裹在一个带有 {locale} 前缀的路由组中，可以确保所有这些路由的URL都包含语言标识。
以下是定义带有语言前缀路由组的基本方式：
// routes/web.php
use App\Http\Controllers\HomeController;
use App\Http\Controllers\PostController;
Route::prefix('{locale}')->group(function() {
Route::get('/', [HomeController::class, 'index'])->name('home');
Route::get('/blog', [PostController::class, 'index'])->name('blog');
// 更多需要国际化的路由...
});通过上述配置，当访问 /en/blog 或 /fa/blog 时，Laravel会正确匹配到对应的路由。此时，{locale} 将作为路由参数传递给后续的请求处理逻辑。
语言环境管理：自定义中间件 SetLocale
仅仅在URL中包含语言参数是不够的，我们还需要根据这个参数来设置应用的语言环境，并进行必要的验证。这正是自定义中间件的用武之地。我们可以创建一个 SetLocale 中间件来处理这些逻辑。
首先，创建中间件：
php artisan make:middleware SetLocale
然后，编辑 app/Http/Middleware/SetLocale.php 文件，实现语言设置和验证逻辑：
// app/Http/Middleware/SetLocale.php
<?php
namespace App\Http\Middleware;
use Closure;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\App;
use Illuminate\Support\Facades\Config;
use Symfony\Component\HttpFoundation\Response;
class SetLocale
{
/**
* 处理传入请求。
*
* @param \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response) $next
*/
public function handle(Request $request, Closure $next): Response
{
// 从URL路径中获取第一个段作为语言参数
$locale = $request->segment(1);
// 获取应用配置中允许的语言列表
// 假设在 config/app.php 中定义了 'locales' => ['en', 'ar', 'fa']
$allowedLocales = config('app.locales', ['en']);
// 验证语言参数是否存在且是否在允许的列表中
if (is_null($locale) || !in_array($locale, $allowedLocales)) {
// 如果语言参数无效或不存在，则返回404错误
abort(404);
}
// 根据语言设置HTML文档方向 (ltr/rtl)
// 假设 'en' 是从左到右，其他是右到左
$html_dir = in_array($locale, ['en']) ? 'ltr' : 'rtl';
Config::set('app.html_dir', $html_dir);
// 设置应用的当前语言环境
App::setLocale($locale);
// 继续处理请求
return $next($request);
}
}在 config/app.php 中添加 locales 配置项：
// config/app.php
return [
// ...
'locales' => ['en', 'ar', 'fa'], // 允许的语言列表
'html_dir' => 'ltr', // 默认HTML方向，会被中间件覆盖
// ...
];整合实践：路由组与中间件的结合
现在，我们将 SetLocale 中间件应用到之前定义的路由组中，以确保每个带有语言前缀的请求都会先经过语言处理逻辑。
// routes/web.php
use App\Http\Controllers\HomeController;
use App\Http\Controllers\PostController;
use App\Http\Middleware\SetLocale; // 引入中间件
Route::prefix('{locale}')->middleware(SetLocale::class)->group(function() {
Route::get('/', [HomeController::class, 'index'])->name('home');
Route::get('/blog', [PostController::class, 'index'])->name('blog');
// 更多路由...
});通过这种方式，当一个请求（例如 /fa/blog）到达时，流程如下：
- 请求首先进入 SetLocale 中间件。
- 中间件从URL中提取 fa 作为 locale。
- fa 被验证为有效语言，并设置 App::setLocale('fa') 和 Config::set('app.html_dir', 'rtl')。
- 请求继续，路由匹配到 /blog 路径，并由 PostController 的 index 方法处理。
- 在控制器或视图中，所有与语言相关的辅助函数（如 __('message')）都将使用 fa 语言环境。
最佳实践与注意事项
-
路由辅助函数的使用: 当使用 route() 辅助函数生成URL时，Laravel会智能地处理 locale 参数。例如，如果你当前在 /en/blog 页面，调用 route('home') 可能会生成 /en。如果你希望切换语言，可以显式传递 locale 参数：
// 生成当前语言环境的home路由 route('home'); // 生成英文的blog路由 route('blog', ['locale' => 'en']); // 生成法文的home路由 route('home', ['locale' => 'fa']); -
默认语言处理: 如果你的网站允许访问不带语言前缀的URL（例如 /blog），并希望将其重定向到默认语言（如 /en/blog），你需要在 routes/web.php 中定义额外的路由或在中间件中实现重定向逻辑。 例如，可以在路由组外部添加一个捕获所有不带语言前缀请求的路由，然后重定向：
// routes/web.php use Illuminate\Support\Facades\Redirect; Route::get('/{path?}', function ($path = null) { $defaultLocale = config('app.locale', 'en'); // 获取默认语言 return Redirect::to("/{$defaultLocale}/{$path}", 302); })->where('path', '.*'); // 然后是你的多语言路由组 Route::prefix('{locale}')->middleware(SetLocale::class)->group(function() { // ... 你的路由 });注意: 这种捕获所有路由的方式需要小心放置，确保它不会意外地捕获到其他更具体的路由。通常，它应该放在所有其他路由定义的后面。
语言列表配置: 将所有允许的语言列表维护在 config/app.php 或单独的配置文件中，可以方便地管理和扩展。
URL生成辅助函数: url() 和 redirect() 等辅助函数在Laravel中也会考虑到当前的语言环境。在设置了 App::setLocale() 后，它们会尝试生成与当前语言环境相符的URL。
性能考量: 对于每个请求，中间件都会执行语言参数的提取、验证和设置。这通常不会造成显著的性能瓶颈，但在极端高并发场景下，应确保中间件逻辑尽可能高效。
总结
通过结合Laravel的路由组功能和自定义中间件，我们可以为多语言网站构建一个强大且易于维护的路由系统。这种方法不仅使URL结构更加清晰和用户友好，还集中了语言环境的管理逻辑，使得后续的开发和维护工作更加高效。遵循这些实践，可以确保您的Laravel多语言网站拥有优秀的国际化支持。
