Laravel Tutorials

Laravel Scoped Route Binding for Nested Resource Management

Published
Laravel Scoped Route Binding for Nested Resource Management image

Laravel's scoped implicit model binding transforms how developers handle nested resources by automatically enforcing parent-child relationships. This feature eliminates manual validation while creating cleaner, more secure URL structures for hierarchical data.

The scoped method enables automatic relationship validation when defining nested routes:

use App\Http\Controllers\OrderItemController;

Route::resource('orders.items', OrderItemController::class)->scoped([
    'item' => 'sku',
]);

This configuration generates URLs following the pattern /orders/{order}/items/{item:sku} where Laravel automatically validates that each item belongs to its specified order.

Laravel leverages naming conventions to determine relationships between models. The framework assumes the parent model contains a relationship method matching the pluralized route parameter name. When a request targets /orders/123/items/ABC789, Laravel queries the items relationship on the Order model to locate the item with SKU "ABC789".

Building an e-commerce inventory system demonstrates this functionality effectively:

Route::resource('warehouses.products', WarehouseProductController::class)->scoped([
    'product' => 'barcode',
]);

class Warehouse extends Model
{
    public function products()
    {
        return $this->hasMany(Product::class);
    }
}

class Product extends Model
{
    public function warehouse()
    {
        return $this->belongsTo(Warehouse::class);
    }
}

class WarehouseProductController extends Controller
{
    public function edit(Warehouse $warehouse, Product $product)
    {
        return view('inventory.edit', compact('warehouse', 'product'));
    }
    
    public function update(Warehouse $warehouse, Product $product, Request $request)
    {
        $product->update($request->validated());
        return redirect()->route('warehouses.products.show', [$warehouse, $product]);
    }
}

The framework automatically returns 404 responses when attempting to access products that don't exist in the specified warehouse. This URL structure /warehouses/east-coast/products/BAR123456 ensures data integrity without additional controller logic while maintaining clean, descriptive routes.

Harris Raftopoulos photo

Senior Software Engineer • Staff & Educator @ Laravel News • Co-organizer @ Laravel Greece Meetup

Sponsored

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
Laravel Read Replicas: Check if a Replica Has Caught Up image

Laravel Read Replicas: Check if a Replica Has Caught Up

Read article
UUID Request Input and Migration Failure Events in Laravel 13.42 image

UUID Request Input and Migration Failure Events in Laravel 13.42

Read article
Replay Missed Laravel Scheduled Tasks With Schedule Catchup image

Replay Missed Laravel Scheduled Tasks With Schedule Catchup

Read article
Search Polymorphic Relations and Filament Tables With Laravel Searchable image

Search Polymorphic Relations and Filament Tables With Laravel Searchable

Read article
Laravel Rest Api 3.0: Typed Fields, Metrics, and OpenAPI Docs image

Laravel Rest Api 3.0: Typed Fields, Metrics, and OpenAPI Docs

Read article
Real-Time Inertia Props With Laravel Reverb image

Real-Time Inertia Props With Laravel Reverb

Read article