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 →
CPX: The Composer Package Executor for PHP image

CPX: The Composer Package Executor for PHP

Read article
Laravel AI SDK Adds Human-in-the-Loop Tool Approval image

Laravel AI SDK Adds Human-in-the-Loop Tool Approval

Read article
Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals image

Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals

Read article
Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs image

Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs

Read article
Blade Formatting in Laravel Pint image

Blade Formatting in Laravel Pint

Read article
Inertia DevTools Is Now on the Chrome Web Store image

Inertia DevTools Is Now on the Chrome Web Store

Read article