24. Recursos de rutas

 Recursos de Rutas en Laravel

¿Te has cansado de escribir línea por línea cada ruta para los métodos GET, POST, PUT, DELETE? Laravel ofrece una solución elegante y poderosa para esto: los Recursos de Rutas (Route Resources).

¿Qué son los Recursos de Rutas?

La artisan command Route::resource() es una herramienta que nos permite definir todas las rutas CRUD necesarias para un controlador con una sola línea de código. En lugar de declarar manualmente cada petición HTTP (GET, POST, PUT, PATCH, DELETE), esta instrucción las genera todas automáticamente.

Esto es ideal para controladores que manejan operaciones estándar de Crear, Leer, Actualizar y Borrar (CRUD) sobre un recurso, como por ejemplo, "Clientes".

¿Cómo se usa?

Su implementación es muy sencilla. En tu archivo de rutas (por ejemplo, web.php), simplemente reemplaza las múltiples líneas de Route::get(), Route::post(), etc., por esta única instrucción:

php
// routes/web.php

// Antes: Muchas rutas definidas una por una
// Route::get('/clientes', 'ClienteController@index');
// Route::post('/clientes', 'ClienteController@store');
// Route::get('/clientes/create', 'ClienteController@create');
// ... y así sucesivamente.

// Después: Una sola línea para gobernarlas a todas
Route::resource('clientes', ClienteController::class);

Con esta única línea, Laravel se encarga internamente de mapear las peticiones HTTP entrantes a los métodos correctos de tu controlador.

La Magia de los Nombres de Método

Al usar Route::resource, Laravel espera que tu controlador siga una convención de nomenclatura específica para sus métodos. No necesitas especificar el método en la ruta, pero sí debes nombrar las funciones en tu controlador como Laravel lo espera.

Puedes ver exactamente qué métodos se generan y cómo se llaman ejecutando el comando de Artisan:

bash
php artisan route:list

Este comando te mostrará una tabla con todas las rutas registradas. Para un recurso como clientes, verás algo así:

Verb HTTPURIActionRoute Name
GET/clientesindexclientes.index
GET/clientes/createcreateclientes.create
POST/clientesstoreclientes.store
GET/clientes/{cliente}showclientes.show
GET/clientes/{cliente}/editeditclientes.edit
PUT/PATCH/clientes/{cliente}updateclientes.update
DELETE/clientes/{cliente}destroyclientes.destroy

Conclusión

Usar Route::resource es la mejor práctica para:

  1. Mantener tu código DRY (Don't Repeat Yourself): Evitas la repetición de código en tus archivos de rutas.

  2. Seguir convenciones: Adoptas la estructura estándar de Laravel, lo que hace tu código más predecible para otros desarrolladores.

  3. Ahorrar tiempo: Definir todas las rutas CRUD con una sola línea es increíblemente eficiente.

Solo asegúrate de que tu controlador tenga los métodos con los nombres que Laravel espera (index, create, store, show, edit, update, destroy) y todo funcionará a la perfección.

Comentarios

Publicar un comentario

Entradas más populares de este blog

crear controladores separados para API y Web

  crear controladores separados para API y Web. Te explico por qué y te muestro cómo hacerlo: ¿Por qué separar los controladores? Separación de responsabilidades : Cada controlador tiene un propósito específico Mantenimiento más fácil : Cambios en API no afectan la web y viceversa Diferentes lógicas : API necesita manejo de JSON, autenticación diferente, etc. Mejor organización : Código más limpio y escalable Estructura recomendada bash # Controlador para Web php artisan make:controller Web/ProductController --resource --model = Product # Controlador para API php artisan make:controller Api/ProductController --resource --model = Product 1. Controlador para API app/Http/Controllers/Api/ProductController.php : php <?php namespace App \ Http \ Controllers \ Api ; use App \ Http \ Controllers \ Controller ; use App \ Models \ Product ; use Illuminate \ Http \ JsonResponse ; use Illuminate \ Http \ Request ; class ProductController extends Controller { /*...
Leer más

Laravel tanto para web como para API al mismo tiempo.

  Te explico cómo crear un CRUD completo en Laravel tanto para web como para API al mismo tiempo. 1. Configuración Inicial Primero, crea el modelo con migración y controlador: bash php artisan make:model Product -mcr 2. Migración database/migrations/xxxx_create_products_table.php : php <?php use Illuminate \ Database \ Migrations \ Migration ; use Illuminate \ Database \ Schema \ Blueprint ; use Illuminate \ Support \ Facades \ Schema ; return new class extends Migration { public function up ( ) : void { Schema :: create ( 'products' , function ( Blueprint $table ) { $table -> id ( ) ; $table -> string ( 'name' ) ; $table -> text ( 'description' ) -> nullable ( ) ; $table -> decimal ( 'price' , 10 , 2 ) ; $table -> integer ( 'stock' ) ; $table -> timestamps ( ) ; } ) ; } public functi...
Leer más

Creación de una API RESTful con Laravel (sin autenticación)

    Tutorial: Creación de una API RESTful con Laravel (sin autenticación) Aquí te muestro cómo crear una API básica en Laravel sin sistema de autenticación, ideal para prototipos rápidos o APIs públicas. Paso 1: Crear el proyecto bash laravel nuevo api-simple # O composer create-project laravel/laravel api-simple cd api-simple Paso 2: Configurar la base de datos Edita el archivo  .env : env DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=api_simple DB_USERNAME=root DB_PASSWORD= Paso 3: Crear modelo, migración y controlador Vamos a crear un modelo  Publicacion : bash php artisan make:model Publicacion -mcr Paso 4: Definir la migración Edita  database/migrations/xxxx_create_publicacions_table.php : php public function up ( ) { Schema :: create ( 'publicacions' , function ( Blueprint $table ) { $table -> id ( ) ; $table -> string ( 'titulo' ) ; $table -> text ( 'contenido' ) ; $table -> s...
Leer más