Налаштування регіональних підпапок (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 з регіональними URL

<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 робочих дні.