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 →
NativePHP v4: Build Native iOS and Android UI in Blade image

NativePHP v4: Build Native iOS and Android UI in Blade

Read article
Laravel Lock: Distributed Locks for Models and Routes image

Laravel Lock: Distributed Locks for Models and Routes

Read article
Laravel Image Responses: Serve Resized Images From Routes image

Laravel Image Responses: Serve Resized Images From Routes

Read article
Pause All Laravel Queues During a Deploy image

Pause All Laravel Queues During a Deploy

Read article
Laravel Terminal UI for the artisan dev Command image

Laravel Terminal UI for the artisan dev Command

Read article
Pause All Queues and a New artisan dev UI in Laravel 13.25 image

Pause All Queues and a New artisan dev UI in Laravel 13.25

Read article