Настройка региональных подпапок (site.com/ru/, site.com/en/)

Настройка региональных подпапок (site.com/ru/, site.com/en/)

Региональные подпапки — альтернатива поддоменам. site.com/ru/, site.com/en/, site.com/de/. Все версии находятся на одном домене, что упрощает DNS, SSL и передачу ссылочного веса. Google рекомендует этот подход для большинства случаев.

Nginx: маршрутизация по префиксу

server {
    listen 443 ssl http2;
    server_name example.com;

    root /var/www/example.com/public;

    # Передаём префикс локали в приложение
    location ~ ^/(ru|en|de|fr)(/.*)?$ {
        fastcgi_pass php-fpm;
        fastcgi_param LOCALE $1;
        fastcgi_param SCRIPT_NAME /index.php;
        include fastcgi_params;
    }

    # Редирект с корня на дефолтную локаль
    location = / {
        return 302 /ru/;
    }
}

Laravel: роутинг с префиксом локали

// routes/web.php
Route::group([
    'prefix'     => '{locale}',
    'where'      => ['locale' => 'ru|en|de|fr'],
    'middleware' => ['set.locale'],
], function () {
    Route::get('/',                 [HomeController::class, 'index'])->name('home');
    Route::get('/catalog',          [CatalogController::class, 'index'])->name('catalog');
    Route::get('/catalog/{slug}',   [ProductController::class, 'show'])->name('product');
    Route::get('/about',            [PageController::class, 'about'])->name('about');
});

// Редирект с / на /{locale}/
Route::get('/', function () {
    $locale = app(LocaleDetector::class)->detect();
    return redirect("/{$locale}/");
});

Middleware: установка локали

class SetLocaleFromPrefix
{
    public function handle(Request $request, Closure $next): Response
    {
        $locale = $request->route('locale') ?? config('app.locale');
        App::setLocale($locale);
        URL::defaults(['locale' => $locale]);  // для именованных маршрутов
        return $next($request);
    }
}

Генерация URL с локалью

// Генерация: route('catalog', ['locale' => 'en'])
// → /en/catalog

// Удобный хелпер
function lroute(string $name, array $params = []): string
{
    return route($name, ['locale' => app()->getLocale(), ...$params]);
}

Sitemap с региональными URLs

<url>
    <loc>https://example.com/ru/catalog</loc>
    <xhtml:link rel="alternate" hreflang="ru" href="https://example.com/ru/catalog" />
    <xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/catalog" />
    <xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/catalog" />
    <xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/en/catalog" />
</url>

Сроки

Настройка подпапок с роутингом, middleware и sitemap: 2–3 рабочих дня.