5. Controladores Tradicionales, Invocables y Controladores de Recursos (CRUD)
Organiza la lógica de negocio con controladores Artisan (make:controller), métodos RESTful estándar e inyección de dependencias.
¿Por qué Usar Controladores en Lugar de Closures en Rutas?
Aunque Laravel permite escribir funciones anónimas (closures) directamente dentro de routes/web.php, en proyectos reales esto ensucia el archivo y hace imposible utilizar el comando de optimización php artisan route:cache.
Los Controladores residen en app/Http/Controllers/ y agrupan la lógica relacionada con una entidad o funcionalidad en una clase PHP orientada a objetos.
# Generar un controlador estándar con Artisan
php artisan make:controller CursoController
Controladores de Recursos (Resource Controllers)
Casi todas las aplicaciones web giran en torno a operaciones CRUD (Crear, Leer, Actualizar y Eliminar). Laravel estandariza este flujo mediante el modificador --resource:
php artisan make:controller CursoController --resource
Y en routes/web.php se registra en una sola línea:
Route::resource('cursos', CursoController::class);
Esta simple línea genera automáticamente las 7 rutas RESTful estándar:
| Verbo HTTP | Ruta URL | Método del Controlador | Nombre de Ruta | Acción |
|---|---|---|---|---|
| GET | /cursos |
index() |
cursos.index |
Listado de todos los cursos. |
| GET | /cursos/create |
create() |
cursos.create |
Formulario HTML para crear un curso. |
| POST | /cursos |
store(Request $request) |
cursos.store |
Guarda el nuevo curso en la base de datos. |
| GET | /cursos/{curso} |
show(Curso $curso) |
cursos.show |
Muestra el detalle de un curso específico. |
| GET | /cursos/{curso}/edit |
edit(Curso $curso) |
cursos.edit |
Formulario para editar el curso. |
| PUT/PATCH | /cursos/{curso} |
update(Request $req, Curso $c) |
cursos.update |
Actualiza los datos del curso. |
| DELETE | /cursos/{curso} |
destroy(Curso $curso) |
cursos.destroy |
Elimina el curso de la base de datos. |
Inyección de Dependencias y Route Model Binding
Laravel incluye enlace automático de modelos a rutas (Route Model Binding). Si tipas el parámetro del método con tu clase de Modelo (Curso $curso), Laravel buscará automáticamente el registro por su clave primaria id y lanzará un error 404 Not Found automático si no existe:
public function show(Curso $curso)
{
// $curso ya contiene el objeto encontrado en la base de datos
return view('cursos.show', compact('curso'));
}
⚡ Estructura Completa de un Resource Controller en Laravel
Controlador CursoController con métodos index, show, store, update y destroy con Eloquent.
<?php
namespace App\Http\Controllers;
use App\Models\Curso;
use Illuminate\Http\Request;
use Illuminate\Http\RedirectResponse;
use Illuminate\View\View;
class CursoController extends Controller
{
/** Muestra el listado de cursos paginados */
public function index(): View
{
$cursos = Curso::where('is_active', true)->orderBy('id', 'desc')->paginate(10);
return view('cursos.index', compact('cursos'));
}
/** Formulario para crear un nuevo curso */
public function create(): View
{
return view('cursos.create');
}
/** Almacena el nuevo curso validando los datos */
public function store(Request $request): RedirectResponse
{
$validated = $request->validate([
'title' => 'required|string|max:190',
'summary' => 'required|string|max:300',
'price_cop' => 'required|numeric|min:0',
]);
Curso::create($validated);
return redirect()->route('cursos.index')
->with('success', '¡Curso creado exitosamente en el catálogo!');
}
/** Muestra un curso (Inyección automática de modelo) */
public function show(Curso $curso): View
{
return view('cursos.show', compact('curso'));
}
/** Elimina un curso de la base de datos */
public function destroy(Curso $curso): RedirectResponse
{
$curso->delete();
return redirect()->route('cursos.index')
->with('info', 'Curso eliminado correctamente.');
}
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué método HTTP y qué acción del controlador se ejecutan al enviar un formulario de eliminación mediante Route::resource("cursos", ...)?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Laravel Framework Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.