Volver al blog
LaravelPHPIA

Laravel 13.43.0 evita duplicar esquemas y validaciones

JsonSchema::rules() permite derivar reglas de validación desde un esquema JSON reutilizable en Laravel.

Por Isma5 min de lectura

Un contrato que no se desincroniza al primer cambio

Cuando una herramienta MCP o una API recibe datos estructurados, es habitual definir el contrato en un sitio y repetirlo después en un FormRequest. El esquema explica qué puede enviar el cliente o el agente, mientras que las reglas de Laravel protegen la entrada antes de ejecutar lógica de negocio. El problema aparece al añadir un campo, cambiar un límite o convertir un valor en obligatorio: hay que acordarse de editar ambas definiciones. Esa duplicación no falla siempre, pero cuando falla deja contratos distintos para la misma operación.

Laravel 13.43.0 incorpora JsonSchema::rules() para derivar reglas de validación a partir de un esquema de objetos. El método acepta tanto esquemas construidos con el builder de Laravel como un array con un JSON Schema sin procesar. La idea no es reemplazar la validación de Laravel, sino generar sus reglas desde una definición que ya describe la estructura de entrada. Así, el esquema puede convertirse en el punto de partida para definir y validar los parámetros de una operación.

Del esquema al FormRequest

En un proyecto donde el contrato vive cerca de una herramienta o de un endpoint, puedo seguir usando un FormRequest sin volver a escribir required, tipos, formatos o límites básicos. JsonSchema::rules() devuelve reglas que se pueden usar donde Laravel acepte reglas de validación. Eso incluye Validator::make() y el método rules() de un FormRequest. El siguiente ejemplo usa el builder oficial y deja la validación HTTP conectada al mismo esquema.

<?php
 
namespace App\Http\Requests;
 
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\JsonSchema\JsonSchema;
 
class CreateServerRequest extends FormRequest
{
    public function rules(): array
    {
        return JsonSchema::rules(JsonSchema::object(fn ($s) => [
            'name' => $s->string()->max(50)->required(),
            'email' => $s->string()->email()->required(),
        ]));
    }
}

También puedo pasar un array con JSON Schema directamente a JsonSchema::rules(). Por ejemplo, un campo email con type igual a string, format igual a email y presente en required se deriva como las reglas required, string y email. Esto es útil si el esquema ya se almacena como configuración, se comparte con otro componente o procede de la definición de una herramienta. No hace falta convertirlo manualmente a la sintaxis de reglas de Laravel antes de validar.

Encaja bien en servicios con IA autoalojados

Esto me parece especialmente práctico en servicios Laravel que exponen herramientas para agentes y se despliegan en Docker. En ese contexto, el contrato de entrada no es un detalle interno: es la interfaz que consumirá un cliente automatizado, además del servidor que ejecuta la acción. Tener una definición y derivar la validación reduce el riesgo de que una actualización del contenedor acepte algo distinto de lo que el agente cree que puede enviar. También simplifica revisar cambios, porque el esquema muestra con bastante claridad qué datos forman parte de la operación.

No es una función exclusiva de MCP ni depende de Docker. Puede servir igual en una API interna, un webhook o un formulario HTTP convencional. La diferencia es que, cuando hay varios consumidores automáticos, el coste de mantener dos contratos paralelos suele ser más evidente. Si el proyecto ya utiliza JSON Schema como parte de su diseño, esta integración evita trabajo mecánico.

La letra pequeña sigue siendo importante

JsonSchema::rules() no convierte un esquema en toda la política de seguridad de una aplicación. La autorización sigue perteneciendo a authorize() o a la capa que corresponda, y las comprobaciones que dependen de base de datos, permisos o estado del sistema requieren reglas adicionales. Tampoco sustituye la lógica de negocio: que una entrada tenga la forma correcta no significa que la operación deba ejecutarse. Conviene tratar las reglas derivadas como validación de estructura y completar el caso de uso donde haga falta.

También evitaría adoptar esta opción solo por reducir líneas de código si el esquema no se reutiliza fuera de la validación. Para una petición pequeña y puramente interna, un array de reglas normal puede ser más directo de leer y mantener. El beneficio real llega cuando el JSON Schema es un contrato útil por sí mismo y se quiere evitar que se separe del FormRequest. Como siempre, merece la pena probar los casos límite de cada entrada y no asumir que un esquema expresará todas las condiciones específicas del dominio.

Un cambio pequeño con una consecuencia útil

La novedad no cambia cómo se validan las peticiones en Laravel, pero sí ofrece una forma más coherente de organizar contratos compartidos. Si ya tengo esquemas para las entradas de herramientas o APIs, puedo reutilizarlos en vez de mantener otra representación de las mismas restricciones. Eso reduce puntos de mantenimiento y hace más difícil introducir diferencias accidentales entre lo que se documenta y lo que el servidor acepta. Para proyectos que mezclan Laravel, agentes y servicios autoalojados, es una mejora discreta pero muy aprovechable.


Fuente: Laravel 13.43.0 en VersionTrack

Documentación oficial: Derivar reglas desde JSON Schemas en Laravel

Newsletter

Lo que aprendo programando con IA, cada dos semanas en tu correo.

Cifras reales, errores incluidos. Sin spam y te das de baja con un clic.

Sin spam y te das de baja con un clic. Uso tu correo solo para enviarte esto y la newsletter. Más en la política de privacidad.