Маршруты для работы с продуктами (product) в Laravel: от простого к сложному

Расширенные примеры работы с маршрутами продуктов

Явное связывание модели с кастомным ключом

По умолчанию Laravel связывает параметр маршрута {product} с моделью Product по полю id. Чтобы изменить это на поле slug, применяется метод routeKeyName или явная регистрация в App\Providers\RouteServiceProvider.

// App\Providers\RouteServiceProvider
public function boot(): void
{
    parent::boot();
    Route::model('product', App\Models\Product::class);
    // Или с кастомным разрешением:
    Route::bind('product', function ($value) {
        return App\Models\Product::where('slug', $value)->firstOrFail();
    });
}

Теперь в маршруте /products/{product} параметр будет преобразован в модель по полю slug.

// URL: /products/laptop-asus-2024
// Эквивалент: Product::where('slug', 'laptop-asus-2024')->firstOrFail()

Необязательные параметры в маршруте продукта

Иногда требуется, чтобы параметр {product} мог отсутствовать. Например, для фильтрации по категории.

Route::get('/products/{category?}', [ProductController::class, 'byCategory'])
    ->where('category', '[a-z]+')
    ->name('products.byCategory');

В контроллере:

public function byCategory(?string $category = null)
{
    if ($category) {
        $products = Product::whereHas('category', fn($q) => $q->where('slug', $category))->get();
    } else {
        $products = Product::all();
    }
    return view('products.index', compact('products'));
}

// /products - выводит все продукты
// /products/electronics - выводит продукты категории 'electronics'

Использование Route::redirect для редиректа со старого URL на новый

Чтобы перенаправить /old-products на /products с кодом 301:

Route::redirect('/old-products', '/products', 301);

Это особенно полезно при рефакторинге маршрутов, когда нужно сохранить обратную совместимость.

// Запрос GET /old-products -> ответ 301 и Location: /products

Группа маршрутов с ограничением по поддомену

Предположим, продукты должны быть доступны только через поддомен shop.example.com. Группа с фильтрацией поддомена:

Route::domain('shop.example.com')->group(function () {
    Route::resource('products', ProductController::class);
});

Теперь все маршруты products.* будут работать только на данном поддомене. В локальной среде можно использовать php artisan serve и /etc/hosts.

Маршруты продуктов с мягким удалением (SoftDeletes)

Для работы с удалёнными продуктами (trashed) можно добавить отдельный маршрут с параметром, который явно ищет в том числе мягко удалённые записи.

Route::get('/products/trashed', [ProductController::class, 'trashed'])->name('products.trashed');
Route::patch('/products/{product}/restore', [ProductController::class, 'restore'])->name('products.restore');

В контроллере:

public function trashed()
{
    $products = Product::onlyTrashed()->get();
    return view('products.trashed', compact('products'));
}

public function restore(Product $product)
{
    $product->restore();
    return redirect()->route('products.index');
}

// GET /products/trashed - список удалённых
// PATCH /products/1/restore - восстановление

Именованные маршруты с генерацией URL

После определения маршрута, например Route::resource('products', ...), можно генерировать URL в шаблонах или контроллерах:

$url = route('products.show', ['product' => 42]);
// Результат: /products/42

$url = route('products.edit', ['product' => 10]);
// /products/10/edit

Если используется кастомное связывание по slug, передавать нужно slug:

$url = route('products.show', ['product' => 'laptop-asus']);
// /products/laptop-asus