¿Qué son los controladores en Laravel?

Question

Accepted Answer

**Los controladores** agrupan la lógica relacionada de manejo de solicitudes en clases. En lugar de poner toda la lógica en cierres de rutas, los controladores organizan las acciones de una aplicación (p. ej., todas las operaciones relacionadas con usuarios) en métodos — manteniendo las rutas limpias y el código organizado.

## Un controlador básico

```php
<?php
class UserController extends Controller {
    public function index() {
        return User::all();              // list users
    }
    public function show(User $user) {   // route model binding — auto-fetch by id
        return $user;
    }
    public function store(Request $request) {
        $validated = $request->validate(['name' => 'required', 'email' => 'required|email']);
        return User::create($validated);  // create
    }
}
```

Genera uno con Artisan: `php artisan make:controller UserController`. Cada método maneja una acción, y las rutas apuntan a ellas.

## Controladores de recursos (CRUD RESTful)

```php
// generate a controller with all 7 RESTful methods stubbed
// php artisan make:controller PostController --resource

Route::resource('posts', PostController::class);   // maps routes to the methods:
// index() create() store() show() edit() update() destroy()
```

Un **controlador de recursos** tiene los métodos CRUD estándar, emparejados con `Route::resource` para enrutamiento RESTful convencional — boilerplate mínimo para recursos CRUD típicos.

## Inyección de dependencias en controladores

```php
class OrderController extends Controller {
    // type-hinted dependencies are AUTO-INJECTED by Laravel's service container
    public function __construct(private OrderService $orders) {}

public function store(Request $request, Mailer $mailer) {   // method injection too
        // $request and $mailer are resolved & injected automatically
    }
}
```

El contenedor de servicios de Laravel **inyecta automáticamente** dependencias con sugerencia de tipo en constructores y métodos de controladores (incluido el `Request`) — código limpio y testeable.

## Mantén los controladores delgados

```text
✓ Controllers should handle HTTP concerns (validate input, call services, return responses)
✗ Business logic belongs in SERVICES/models, not bloated controllers ("thin controllers")
```

## Por qué es importante

Los controladores son un componente básico de Laravel — organizan la lógica de manejo de solicitudes en clases cohesivas, lo que es esencial para cualquier aplicación más allá de rutas triviales.

Comprender cómo crear controladores, asignar rutas a sus métodos y especialmente usar **controladores de recursos** con `Route::resource` (para CRUD RESTful convencional con boilerplate mínimo) es conocimiento cotidiano para crear aplicaciones Laravel.

Una característica clave de Laravel es la **inyección automática de dependencias** en controladores a través del contenedor de servicios — las dependencias con sugerencia de tipo (servicios, la solicitud, mailers) se resuelven e inyectan automáticamente, permitiendo código limpio, testeable y débilmente acoplado.

Igualmente importante es la mejor práctica de mantener los controladores **delgados** — manejando solo preocupaciones HTTP (validación, llamada de servicios, devolución de respuestas) y delegando la lógica empresarial a servicios/modelos, lo que mantiene el código mantenible y testeable.

Los controladores, junto con el enrutamiento y los modelos, forman la columna vertebral del manejo de solicitudes de Laravel, lo que los hace fundamentales para crear aplicaciones Laravel bien organizadas y profesionales.