Formación corporativa en Laravel

Módulo dedicado a los cimientos internos del framework: el ciclo de vida de la petición HTTP, el Service Container (IoC) para inyección de dependencias, los Service Providers para registrar servicios y las Facades como capa de acceso estático a los servicios del contenedor. Comprender estos conceptos es clave para escalar proyectos Laravel más allá del scaffolding inicial.

En Laravel, los controladores son clases que gestionan la lógica de las solicitudes HTTP. Este enfoque ordena el código y facilita la colaboración en equipos de trabajo, ya que cada acción queda claramente separada en métodos específicos.

Significado de los controladores HTTP
Cuando se hace referencia a los controladores HTTP, se señala la capa que conecta las rutas definidas en routes/web.php con la lógica de negocio de Laravel. Esta relación hace que el código sea más legible y modular en proyectos de PHP.

Creación rápida de controladores
La forma más utilizada para crear un controlador es mediante la línea de comandos. Basta con escribir:

php artisan make:controller MiControlador

Este comando genera la estructura básica para gestionar las peticiones HTTP y permite empezar a aprender sin complicaciones adicionales.

Ubicación de los controladores
Los controladores suelen ubicarse en el directorio app/Http/Controllers. Laravel adopta esta convención para mantener un orden coherente y separar la lógica de PHP en diferentes capas o secciones dentro del proyecto.

Métodos principales
En un controlador, cada método se asocia con una ruta específica. Por ejemplo, index(), show($id) o store() manejan diferentes aspectos de la interacción con los recursos de la aplicación Laravel. Esto refuerza la claridad en la arquitectura HTTP.

Buenas prácticas con controladores
Para mantener un proyecto escalable, es aconsejable no recargar los controladores con lógica excesiva. Se recomienda utilizar servicios o repositorios en Laravel para procesar datos y mantener la responsabilidad de cada capa del sistema.

Gestión de rutas y controladores
En el archivo routes/web.php, se asocia un controlador a cada ruta con la sintaxis:

Route::get('/usuarios', [MiControlador::class, 'index']);

Este mapeo define cómo las peticiones HTTP llegan a la lógica de tu aplicación en Laravel.

Inyección de dependencias
La inyección de dependencias en Laravel permite que los controladores reciban servicios necesarios directamente en el constructor o en los métodos. Este patrón facilita el testing y la modularidad de proyectos PHP de mayor escala.

Controladores resource
Cuando se requiere un esquema estándar para operaciones CRUD, se puede crear un controlador resource con:

php artisan make:controller UsuarioController --resource

Este tipo de controlador implementa métodos predefinidos para solicitudes HTTP como index(), create(), store(), update() y destroy().

Protección de rutas
En ocasiones, es necesario restringir el acceso a ciertos métodos de un controlador. Para ello, se utiliza el middleware auth en Laravel, que verifica si el usuario está autenticado antes de permitir el acceso a la lógica de PHP.

Separación de lógica
Conviene recordar que los controladores no deben abusar de consultas directas a la base de datos. Es preferible delegar estas acciones a Modelos Eloquent, reforzando la arquitectura MVC en Laravel y fomentando la reutilización de código.

Personalización de rutas
Las rutas asociadas a un controlador se pueden personalizar. Con Route::resource(), se generan rutas RESTful de forma automática. Si prefieres control total, puedes declarar cada ruta de manera individual y elegir nombres descriptivos para los métodos HTTP.

Anotaciones adicionales
Para una lectura de código más sencilla, se pueden incluir comentarios y docblocks en cada método del controlador. Esto proporciona un mayor entendimiento del flujo HTTP y mejora la mantenibilidad de cualquier proyecto de PHP.

Respuesta en formatos distintos
Los controladores de Laravel pueden devolver respuestas en distintos formatos, como JSON o vistas Blade. Esta flexibilidad resulta útil al integrar servicios externos o al crear interfaces API REST que procesan solicitudes HTTP.

La integración de Laravel con un ORM facilita la comunicación con las bases de datos sin usar consultas SQL directas. Esto permite que el código sea más legible y que exista una capa adicional de seguridad. El objetivo principal es lograr una persistencia de bases de datos que sea clara y resiliente para los proyectos de PHP.

Ventajas de usar Eloquent

• Manejo intuitivo de datos: la sintaxis de Laravel con Eloquent resulta fácil de leer.
• Definición clara de relaciones: ofrece métodos para establecer y mantener la integridad referencial.
• Escalabilidad del proyecto: el uso de un ORM reduce la complejidad de consultas y simplifica el mantenimiento.

Creación de modelos
En Laravel, los modelos son clases de PHP que representan tablas de la base de datos. Cada modelo corresponde a una entidad que facilita la persistencia de bases de datos. Para generar un modelo, se puede usar el comando:

php artisan make:model NombreDelModelo

Por convención, el archivo se crea en la carpeta app/Models (o app en versiones anteriores). Este modelo describe las columnas de la tabla y sus relaciones.

Migraciones y consistencia
Las migraciones permiten versionar la estructura de la base de datos y garantizan que la aplicación evolucione de forma controlada. Para crear una migración en Laravel, se emplea:

php artisan make:migration create_nombre_tabla --create=nombre_tabla

Esta técnica agiliza el trabajo en equipo y evita confusiones en la configuración del entorno de desarrollo.

Metodología de trabajo con Eloquent
La interacción con el ORM es directa y se basa en métodos de clase. Por ejemplo, para guardar información en la base de datos con un modelo llamado Usuario, se realiza:

$user = new Usuario();
$user->nombre = 'Ana';
$user->email = 'ana@example.com';
$user->save();

Este enfoque minimiza el riesgo de cometer errores de sintaxis en consultas SQL y conserva la legibilidad.

Consultas simples y filtros
Con Eloquent, es posible realizar consultas utilizando métodos intuitivos:

$usuarios = Usuario::where('activo', true)->orderBy('nombre')->get();

La palabra clave ORM se hace evidente en estos métodos, que reemplazan las consultas SQL tradicionales por llamadas más expresivas.

Relaciones y organización de datos
Para la persistencia de bases de datos, las relaciones en Eloquent son fundamentales. Existen varios tipos:

• One to One
• One to Many
• Many to Many

Un ejemplo sencillo de relación One to Many se define en el modelo:

public function posts()
{
    return $this->hasMany(Post::class);
}

Gracias a esta definición, se pueden extraer los posts de un usuario sin necesidad de escribir consultas complejas.

Buenas prácticas en desarrollo
La estructura de Laravel invita a separar la lógica de la aplicación mediante controladores, modelos y vistas. De este modo, se refuerza la persistencia de bases de datos y se fomenta un estilo de programación organizado. Algunas recomendaciones incluyen:

• Utilizar controladores para la lógica primaria.
• Crear servicios o repositorios para operaciones más extensas.
• Mantener la coherencia de nombres en modelos y tablas.

Manejo de transacciones
Cuando se necesitan operaciones atómicas, Laravel ofrece métodos para encapsular acciones en transacciones:

DB::transaction(function () {
    // Operaciones que deben ser atómicas
});

Este procedimiento garantiza la consistencia de la información y protege la persistencia de bases de datos ante fallos inesperados.

Seeders y testeo
Los seeders generados a través de PHP ayudan a llenar tablas con datos de prueba. Con php artisan make:seeder NombreSeeder, se predeterminan registros para comprobar la estructura de las tablas y confirmar que la lógica del ORM funciona correctamente en Laravel.

Personalización de tablas y claves primarias
Cuando una tabla de la base de datos no sigue la convención por defecto (nombre en plural y columnas habituales), es viable personalizarla:

protected $table = 'mi_tabla_personalizada';
protected $primaryKey = 'id_personalizado';

Con esto, se mantiene el interés en la persistencia de bases de datos y el buen funcionamiento del ORM en Laravel.

Optimización de consultas
Las consultas complejas pueden incluir joins, subconsultas o paginación. Aun así, Laravel ofrece métodos como join(), paginate() y withCount() para obtener resultados de manera ordenada. Ejemplo con withCount():

$usuariosConPosts = Usuario::withCount('posts')->get();

Se logra optimizar la experiencia de manejo de datos sin perder la expresividad de Eloquent.

En Laravel, los middlewares son componentes que se ejecutan antes o después de una solicitud HTTP. Estas piezas de código permiten gestionar de forma centralizada aspectos relacionados con la seguridad y el control de acceso en aplicaciones PHP.

Definición y función
Un middleware actúa como un filtro entre la solicitud del usuario y la respuesta del servidor. Este mecanismo permite validar datos, verificar autenticaciones o registrar actividades. Por ejemplo, se puede restringir el acceso a determinadas rutas según el rol del usuario.

Creación de un middleware personalizado
Para generar un middleware en Laravel, se utiliza el comando:

php artisan make:middleware CheckUser

Este comando crea un archivo en la carpeta app/Http/Middleware que contiene el esqueleto del middleware. Dentro de la función handle(), se define la lógica de validación.

Ejemplo de middleware para control de acceso
A continuación, se muestra un ejemplo de un middleware que verifica si el usuario está autenticado:

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class CheckUser
{
    public function handle(Request $request, Closure $next)
    {
        if (!$request->user()) {
            return redirect('login');
        }

        return $next($request);
    }
}

Este código ejemplifica cómo el middleware impide el acceso a rutas protegidas si el usuario no ha iniciado sesión.

Implementación en las rutas
Una vez creado y registrado, el middleware se asigna a las rutas para controlar el flujo de acceso. En Laravel, esto se realiza en el archivo routes/web.php de la siguiente manera:

Route::group(['middleware' => 'check.user'], function () {
    Route::get('/dashboard', [DashboardController::class, 'index']);
});

Con esta configuración, el acceso a la ruta /dashboard se filtra utilizando el middleware check.user.

Registro en el kernel
Para que los middlewares puedan utilizarse en la aplicación, es necesario registrarlos en el archivo app/Http/Kernel.php. Por ejemplo:

protected $routeMiddleware = [
    'auth' => App\Http\Middleware\Authenticate::class,
    'check.user' => App\Http\Middleware\CheckUser::class,
];

Esta estructura permite que Laravel reconozca y aplique el middleware en las rutas definidas.

Uso de middlewares para protección CSRF
Además del control de acceso, Laravel incluye middlewares para la protección frente a ataques CSRF (Cross-Site Request Forgery). Este middleware se aplica de forma global y garantiza que las solicitudes POST estén correctamente validadas.

Nota: Es importante no modificar este middleware para mantener la integridad de la seguridad en la aplicación.

Ventajas de utilizar middlewares
Implementar middlewares en Laravel aporta varias ventajas:

• Modularidad: Separa la lógica de validación en componentes reutilizables.
• Control centralizado: Facilita la gestión de la seguridad en diferentes partes de la aplicación.
• Flexibilidad: Permite aplicar múltiples filtros a una misma ruta mediante grupos o asignaciones directas.

Aplicación de middlewares en el contexto de seguridad
En el desarrollo de aplicaciones PHP con Laravel, la seguridad es esencial. Los middlewares contribuyen a:

• Proteger rutas sensibles mediante autenticación y autorización.
• Registrar y monitorear el tráfico de la aplicación.
• Sanitizar datos antes de que entren a la lógica del sistema.

Uso de middlewares en procesos complejos
Aparte del control de acceso básico, se pueden crear middlewares para operaciones más complejas, como la validación de tokens API o la verificación de condiciones previas al procesamiento de datos. Esto garantiza que la aplicación maneje las solicitudes de forma robusta y evite vulnerabilidades comunes en PHP.

Buenas prácticas en el uso de middlewares
Para garantizar la eficacia y limpieza en el código, se recomienda:

• Documentar cada middleware con comentarios claros.
• Reutilizar componentes en múltiples rutas o grupos.
• Delegar únicamente la lógica estrictamente relacionada con la solicitud, evitando duplicar código en los controladores.

Cada uno de estos aspectos asegura que la implementación de middlewares en Laravel mejore la seguridad y facilite el mantenimiento de la aplicación. Con estos conceptos, se puede crear un entorno robusto y controlado, esencial en el desarrollo profesional de aplicaciones en PHP.

En este módulo dominarás la autenticación de APIs con Laravel Sanctum (tokens API y sesión), las JSON:API Resources nativas de Laravel 13 para respuestas estándar, Form Requests para validación estructurada y la construcción de APIs REST profesionales.

Colas y Horizon, caché y sesión, Mailables y notificaciones multicanal, y eventos con broadcasting: el conjunto de piezas que suele marcar la diferencia entre un CRUD de tutorial y un backend preparado para producción.

El Laravel AI SDK, introducido como ciudadano de primera clase en Laravel 13, es la respuesta del ecosistema PHP al auge de las aplicaciones AI-native. Permite integrar modelos de lenguaje de OpenAI, Anthropic, Google Gemini y proveedores locales como Ollama usando una API unificada, coherente con la filosofía expresiva del framework. Frente a integraciones manuales vía cliente HTTP, el SDK ofrece streaming, tool calling, structured outputs, caché y tracing listos para producción.

Qué cubre el módulo

El módulo recorre la generación de texto con Ai::text(), la generación de embeddings con Ai::embeddings(), la configuración de modelos por proveedor desde config/ai.php, la creación de agentes conversacionales con memoria, la implementación de búsqueda semántica sobre PostgreSQL con la extensión pgvector y el uso de colas de Laravel para trabajos de IA de larga duración. También vemos patrones RAG (Retrieval-Augmented Generation) aplicables a documentación corporativa, catálogos de producto o bases de conocimiento internas.

Para qué sirve en la práctica

En proyectos B2B con Laravel, este módulo habilita asistentes de soporte sobre manuales de producto, motores de recomendación basados en descripción semántica, clasificadores automáticos de tickets y chatbots que razonan sobre la propia base de datos relacional del cliente. La combinación Laravel más pgvector ofrece una pila PHP completa sin dependencias externas de servicios de vectores de pago.

Lecciones principales incluidas

Incluye tutorial-laravel-php-ai-sdk-embeddings y retos ejercicios-laravel-php-ai-sdk-test junto con prácticas guiadas sobre la creación de endpoints de búsqueda semántica y la persistencia de vectores en Postgres.

El testing es una parte indispensable en el desarrollo de aplicaciones robustas en Laravel. Esta metodología permite detectar errores de forma temprana, facilitando la corrección y evitando fallos en producción. Con PHPUnit y las herramientas integradas en el framework, realizar pruebas resulta intuitivo y estructurado.

Configuración de PHPUnit en Laravel
Laravel viene configurado de forma predeterminada para trabajar con PHPUnit. El archivo phpunit.xml se encuentra en la raíz del proyecto y permite personalizar diversas opciones de ejecución. Para iniciar las pruebas, basta con ejecutar:

php artisan test

Este comando activa el entorno de testing y ejecuta los casos definidos en la carpeta tests.

Organización de las pruebas
La estructura de pruebas en Laravel se divide en dos categorías principales:

• Pruebas unitarias: Se centran en probar funciones y métodos de forma aislada.
• Pruebas integrales (feature tests): Evalúan la interacción entre diferentes componentes de la aplicación.

Esta división facilita el mantenimiento y mejora la cobertura de testing en el proyecto.

Creación de pruebas unitarias
Las pruebas unitarias se crean en la carpeta tests/Unit y sirven para verificar el comportamiento de métodos individuales. Un ejemplo sencillo es el siguiente:

<?php

namespace Tests\Unit;

use Tests\TestCase;

class EjemploTest extends TestCase
{
    public function test_valida_retorno_correcto()
    {
        $valor = 2 + 2;
        $this->assertEquals(4, $valor);
    }
}

En este ejemplo, se utiliza PHPUnit para confirmar que la suma retorna el valor esperado, demostrando la eficacia del testing en Laravel.

Realizando pruebas integrales
Las pruebas integrales, ubicadas en la carpeta tests/Feature, permiten simular peticiones HTTP y verificar respuestas de la aplicación. Veamos un ejemplo práctico:

<?php

namespace Tests\Feature;

use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

class InicioTest extends TestCase
{
    use RefreshDatabase;
    
    public function test_acceso_a_la_pagina_principal()
    {
        $response = $this->get('/');
        $response->assertStatus(200);
    }
}

Esta prueba comprueba que la página de inicio responde correctamente, validando la ruta y el HTML generado por Laravel.

Uso de factories y seeders en testing
La generación de datos de prueba es esencial para un testing efectivo. Laravel integra factories y seeders que permiten poblar la base de datos con información simulada. Por ejemplo:

$user = User::factory()->create();

De esta forma, se facilita la prueba de funcionalidades que dependen de datos reales sin comprometer la base de datos de producción.

Simulación de peticiones y respuestas
Para evaluar la respuesta del sistema ante distintas solicitudes, Laravel proporciona métodos específicos para simular peticiones HTTP. Utilizando el método post(), se puede enviar información simulada a una ruta. Por ejemplo:

$response = $this->post('/login', [
    'email' => 'usuario@example.com',
    'password' => 'secreto'
]);
$response->assertRedirect('/dashboard');

Este fragmento valida la correcta redirección tras una autenticación exitosa, optimizando el proceso de testing.

Validación de comportamiento con assertions
PHPUnit incorpora múltiples métodos de assertions que permiten confirmar el comportamiento esperado de la aplicación. Algunas de las más utilizadas son:

• assertEquals: Compara el valor esperado con el obtenido.
• assertTrue: Verifica si una condición es verdadera.
• assertNotNull: Confirma que un valor no es nulo.

El uso adecuado de estas herramientas refuerza el testing y garantiza la fiabilidad de cada función en Laravel.

Adaptación al test-driven development (TDD)
El enfoque basado en TDD promueve la escritura de pruebas antes del desarrollo de la funcionalidad. Esta metodología, aplicada en Laravel, permite diseñar una arquitectura de PHP optimizada y libre de errores. La filosofía TDD fomenta la refactorización continua y una mayor comprensión del comportamiento esperado por cada componente.

Buenas prácticas en testing
Para asegurar un testing efectivo en Laravel, es recomendable seguir estas pautas:

• Mantener pruebas independientes que no dependan unas de otras.
• Documentar cada test para facilitar su comprensión y mantenimiento.
• Utilizar la herramienta RefreshDatabase para limpiar el entorno en cada ejecución.
• Emplear assertions claras que reflejen el propósito de la prueba.

Adoptar estas prácticas contribuye a un desarrollo organizado y a la prevención de errores a lo largo del ciclo de vida de la aplicación.

Módulo dedicado al sistema de archivos de Laravel (subida de ficheros, discos locales y en la nube con S3 / Cloudflare R2, URL firmadas, visibilidad) y al HTTP Client basado en Guzzle para consumir APIs externas con reintentos, concurrencia y tests mediante Http::fake().

Módulo dedicado al frontend moderno sobre Laravel: Livewire v3 para crear componentes interactivos en PHP puro (sin escribir JavaScript explícito), y una introducción a Inertia.js como puente entre Laravel y Vue o React para construir SPAs con routing del lado del servidor. Incluye Vite como bundler de assets.

Módulo dedicado a poner en producción aplicaciones Laravel: configuración del entorno de producción, optimizaciones con php artisan optimize, despliegue con GitHub Actions, opciones de hosting con Laravel Forge, despliegue serverless con Laravel Vapor (AWS Lambda) y alto rendimiento con Laravel Octane (Swoole/FrankenPHP). Incluye checklist de seguridad antes de ir a producción.

Módulo orientado a integración de APIs REST, vistas Blade y formularios en escenarios cercanos a proyectos reales y a necesidades de empresas (CRUD, capas y entregables evaluables).