Tema 5 · Controladores

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.

CursoController.php
Solo lectura
<?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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.