Laravel 5.5部分路由语言切换功能失效问题

Hey there! Let's break down why your language switcher is acting inconsistently—this is a super common gotcha in Laravel, and I’ve fixed similar issues plenty of times. Here are the key areas to check:

1. Fix the Form Action Path (Relative vs Absolute) #

Your form uses a relative action "language", which causes problems on pages with different URL depths. For example:

• On your homepage (/), it submits to /language (correct)
• On a page like /blog/post/1, it tries to submit to /blog/post/language (wrong, since your route is probably at the root)

Quick fix: Use Laravel’s url() helper to generate an absolute path, or use a named route:

<!-- Option 1: Using url() helper -->
<form id="language_switcher_form" action="{{ url('language') }}" method="post">

<!-- Option 2: Using a named route (better practice) -->
<form id="language_switcher_form" action="{{ route('language.switch') }}" method="post">

If you go the named route route, make sure your web.php route has a name:

Route::post('/language', function(\Illuminate\Http\Request $request) {
    // Your language switch logic here
})->name('language.switch');

2. Don’t Forget the CSRF Token #

Laravel blocks POST requests without a valid CSRF token by default. If your form is missing this field, some pages might silently fail (especially if you’re using different layouts where the token isn’t included).

Add the @csrf directive right inside your form:

<form id="language_switcher_form" action="{{ url('language') }}" method="post">
    @csrf <!-- This line is crucial! -->
    <select name="locale" id="language_switcher">
        <option value="en" {{ App::getLocale() == 'en' ? 'selected' : '' }} class="mt-english">English</option>
        <option value="np" {{ App::getLocale() == 'np' ? 'selected' : '' }} class="mt-nepali">Nepali</option>
    </select>
</form>

3. Verify Your Language Middleware Setup #

If your language switch relies on a middleware to set the locale on every request, make sure:

• The middleware is registered in the web middleware group (so it runs on all frontend routes)
• The middleware correctly reads the locale from the session and applies it

Example SetLocale Middleware: #

Create app/Http/Middleware/SetLocale.php:

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Support\Facades\App;
use Illuminate\Support\Facades\Session;

class SetLocale
{
    public function handle($request, Closure $next)
    {
        // Use the stored locale if it exists, fallback to default
        if (Session::has('locale')) {
            App::setLocale(Session::get('locale'));
        }
        return $next($request);
    }
}

Then add it to the web middleware group in app/Http/Kernel.php:

protected $middlewareGroups = [
    'web' => [
        // ... other existing middleware
        \App\Http\Middleware\SetLocale::class,
    ],
];

4. Clear Laravel Caches #

Old configuration or view caches can cause stale locale settings to stick around. Run these commands in your terminal:

php artisan config:clear
php artisan view:clear
php artisan cache:clear

5. Check for JavaScript Issues #

If you’re using JavaScript to submit the form when the select changes (e.g., onChange), make sure:

• The JS code is loaded on all pages where the switcher is used
• There are no console errors blocking the submission

Here’s a reliable JS snippet to add right after your form:

<script>
    document.getElementById('language_switcher').addEventListener('change', function() {
        document.getElementById('language_switcher_form').submit();
    });
</script>

Final Working Form Example #

Putting it all together, your form should look like this:

<form id="language_switcher_form" action="{{ route('language.switch') }}" method="post">
    @csrf
    <select name="locale" id="language_switcher">
        <option value="en" {{ App::getLocale() == 'en' ? 'selected' : '' }} class="mt-english">English</option>
        <option value="np" {{ App::getLocale() == 'np' ? 'selected' : '' }} class="mt-nepali">Nepali</option>
    </select>
</form>

<script>
    document.getElementById('language_switcher').addEventListener('change', function() {
        document.getElementById('language_switcher_form').submit();
    });
</script>

And your route handler should store the locale in the session:

Route::post('/language', function(\Illuminate\Http\Request $request) {
    // Validate the locale is allowed
    $allowedLocales = ['en', 'np'];
    $locale = in_array($request->locale, $allowedLocales) ? $request->locale : 'en';
    
    // Store locale in session for future requests
    session(['locale' => $locale]);
    App::setLocale($locale);
    
    // Redirect back to the previous page
    return redirect()->back();
})->name('language.switch');

Start with checking the form action and CSRF token first—those are the most common culprits for this kind of inconsistent behavior!

内容的提问来源于stack exchange，提问作者Purushotam Sangroula